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.
Installing shoebot for the current user.
python3 setup.py install
Local install using virtualenvwrapper¶
If you’re using the handy virtualenvwrapper, these are the necessary commands:
mkvirtualenv shoebot -p $(which python3) python3 setup.py install
To use Shoebot in the future, you will need to activate the environment first:
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 setup.py install
To use shoebot in the future, remember to activate the environment first.
System wide install¶
sudo python3 setup.py install
Mac OS X¶
Installation on Mac OS X is identical to GNU/Linux based distributions.
Dependencies are installed via Homebrew through the
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 install_dependencies.sh file.
Save this file to your
Msys2 home\user directory (default
Msys2 Sys from the Start Menu and enter:
When that is complete enter:
git clone https://github.com/shoebot/shoebot
When that is complete run
MinGW 64-bit from the Start Menu and enter:
cd shoebot python setup.py 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 install_dependencies.sh 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 setup.py 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.