Shoebot runs on Python 3.7 and above.

You need a few software packages on your system before installing Shoebot. There is a small handy script that will take care of this for you:


It is recommended to install Shoebot locally, although it can be also be installed system-wide.

If the script does not support your operating system, skip to Add support for another operating system.

Local install

Installing shoebot for the current user.

python3 install

Local install using virtualenvwrapper

If you’re using the handy virtualenvwrapper, these are the necessary commands:

mkvirtualenv shoebot -p $(which python3)
python3 install

To use Shoebot in the future, you will need to activate the environment first:

workon shoebot

Local install using a plain virtualenv

If you don’t use virtualenvwrapper, run these commands after installing the dependencies.

virtualenv .env
source .env/bin/activate
python3 install

To use shoebot in the future, remember to activate the environment first.

source .env/bin/activate

System wide install

sudo python3 install

Mac OS X

Installation on Mac OS X is identical to GNU/Linux based distributions.

Dependencies are installed via Homebrew through the install/ script.

Python 3.8 is supported on Homebrew, since that is what is currently supported by pygobject3 there.


Shoebot will install and run on Windows 64 bit (7 and above) using msys2.

The easiest way to install Shoebot on Windows after installing Msys2 is to download and use the file.

Save this file to your Msys2 home\user directory (default C:\msys64\home\%YourUserName%\).

Run Msys2 Sys from the Start Menu and enter:


When that is complete enter:

git clone

When that is complete run MinGW 64-bit from the Start Menu and enter:

cd shoebot

python install

After installing, the compiled executables can be used without running the Msys2 shell.

Add support for another operating system

To add support for another OS you will need to install the libraries that Shoebot depends on:


Python3 Pycairo PyGObject3 Pango Pillow





The community for your operating system may be able to offer help here. Looking at how the script works for may help.

Check progress with diagnose

Shoebot provides a diagnose command as part of setup to check if things are working.

python3 diagnose

It’s usually easiest to start with Python3 and Pycairo, then move on to PyGobject, Pango and Gtk3.

PGI with CairoCFFI and GTK3

Shoebot can run under PGI and CairoCFFI, which may be easier to install than the recommened setup with pygobject and cairo.

In this setup Shoebot can work with the GUI, but text output is not available.

Open a bug on the Shoebot issue tracker

Open a bug on the issue tracker to track progress on adding your OS.