Installation

You may download arrangeit v0.3alpha either in the form of a binary distribution package (pick your platform and Python version from the project’s releases page on Github) or as a source package distribution.

Minimum requirements for Python is version 3.5.

GNU/Linux

Binary distribution

For now, only Debian/Ubuntu binary releases for Python 3.5, 3.6 and 3.7 can be downloaded from the releases page.

Download binaries of your choice and place them in a temporary directory. Install arrangeit by typing the following commands in terminal:

$ 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

Uninstallation

If you want, you may uninstall the software with:

$ sudo apt-get purge arrangeit
$ sudo apt-get autoremove --purge

Also, if you’ve saved some data or changed some settings from the options dialog, then you may delete every trace of that by removing the data directory:

$ rm -rf ~/.local/share/arrangeit

Source distribution

Use the following commands in Ubuntu to prepare and run arrangeit:

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

# change current directory to the one where you keep your projects
$ cd ~/projects

# clone arrangeit repository (or you may download it as a compressed directory)
$ git clone https://github.com/ipaleka/arrangeit.git

# create directory for the virtual environments if you don't have it already
$ mkdir venvs
# create virtual environment for arrangeit
$ python3 -m venv venvs/arrangeit
# activate newly created virtual environment
$ source venvs/arrangeit

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

# run arrangeit
(arrangeit) $ python -m arrangeit

MS Windows

Binary distribution

Provided binary release downloaded from the releases page is in the form of a compressed directory.

Extract it in a directory of your choice and run the arrangeit.exe executable by clicking it. You may also, of course, create a shortcut to that executable and place it on the desktop or in some other place of choice.

Uninstallation

No runtime files will be placed outside that directory during a run. If you’ve changed some settings or saved the data in the options dialog, then your configuration files would be saved in arrangeit directory under your user’s directory.

If you want to delete every trace of arrangeit software, then you should delete that directory (typically c:\Users\yourusername\arrangeit) and the directory where you extracted the binary distribution.

Source distribution

You should install Python 3 first in order to run arrangeit from the source in MS Windows.

Then you should either download source archive and extract it in a directory of your choice or you may clone arrangeit repository (detailed instructions are in the development page).

You should take the following steps in order to prepare and run arrangeit from source distribution in MS Windows:

:: change current directory to the one where you keep your projects
cd projects

:: create directory for the virtual environments if you don't have it already
mkdir venvs
:: create virtual environment for arrangeit
python -m venv venvs\arrangeit
:: activate newly created virtual environment with
venvs\arrangeit\Scripts\activate.bat

:: enter the extracted source distribution directory
(arrangeit) cd arrangeit

:: install Python dependencies
(arrangeit) python -m pip install -r requirements/windows.txt

:: run arrangeit
(arrangeit) python -m arrangeit