arrangeit is a cross-platform desktop utility that helps you placing your desktop's open windows. It is a utility mostly based on the mouse movements, with some keyboard shortcuts as helpers.

You may find arrangeit v0.3alpha installation packages for Debian/Ubuntu and MS Windows in the releases page.

Run the following commands after you downloaded and extracted the archive in a temporary directory:

$ sudo apt-get install python3-pil.imagetk python3-xlib
$ cd tmp_directory
$ sudo dpkg -i python3-pynput_1.4.2_all.deb
$ sudo dpkg -i arrangeit_0.3alpha_all.deb

Run the executable with:

$ arrangeit

Extract the archive in a directory of your choice and run the arrangeit.exe executable inside it.

You'll find a detailed explanation in the installation and development pages.

Use the following commands in Ubuntu for a quick start:

$ sudo apt-get install python3-dev git gcc libgirepository1.0-dev \
    libcairo2-dev pkg-config gir1.2-gtk-3.0 gir1.2-wnck-3.0

$ cd ~/projects
$ git clone https://github.com/ipaleka/arrangeit.git
$ mkdir venvs
$ python3 -m venv venvs/arrangeit
$ source venvs/arrangeit

(arrangeit) $ cd arrangeit
(arrangeit) $ python -m pip install -r requirements/linux.txt

(arrangeit) $ python -m arrangeit

Move your mouse to set the future position of the window. You may change the active corner either manually, by pressing the Ctrl key on your keyboard, or dynamically through the snapping functionality (when a moving window snaps to some window with a side not connected to the currently active corner).

By pressing the left mouse button (or by pressing the Enter key on your keyboard) you set the future position of the window and moving the mouse afterward resizes the main window. Press the left mouse button again to confirm the future size.

To move the current window on another workspace you should press the wanted workspace number on your keyboard. As an alternative, you may first release the mouse by clicking the middle mouse button or by pressing the Shift key on keyboard, and then click the wanted workspace box with your mouse.

Click a window title in the listed windows area to start operating from some other window.

Click (or ) icon inside the title box to change the minimized state of the current window.

Click (or ) icon if you want to change just the position of the current window, without changing its size (and vice versa).

arrangeit v0.3alpha stops running either when all the windows are exhausted or when you press the Esc key on your keyboard.

screencast

Please create an issue for any problem you've encountered regarding arrangeit installation, usage or development.

Don't hesitate to send a direct message or a tweet if you have any questions or concerns. Or just send an email.

Any help is appreciated and your pull requests are welcome, Please help in reaching arrangeit's three major milestones in the roadmap: 0.4beta version with Mac OS X support, 0.5 as the first stable version and the 1.0 version.

Meanwhile, please make the initial step by clicking the Star button from above!

This project is licensed under the GNU General Public License v3.0 - see the legal page for details.