Installing Woo


Linux is the platform of choice for both developing and using Woo. Installation can be done in several ways, trading fexibility for straightforwardness.

Package installation

Packages for Ubuntu are no longer maintained. Use compilation from source as described below.

Compilation from source

Source code is hosted at GitHub and can be otained with the Git revision control system by saying git clone

Compilation on Ubuntu/Debian can use the script which will also handle dependency installation. Other distributions should look into that file for necessary dependencies. The build system itself uses CMake and installs Woo as a compiled Python extension module (python virtual environments are supported).

CMake takes several options (see at the beginning of CMakeLists.txt) which will selectively turn on/off various features. The important options might be:

  • WOO_QT5: enable or disable user interface; Woo can always run without GUI, though disabling it at build-time greatly reduces build dependencies (in particular Qt and OpenGL) [ON by default]

  • PYTHON_EXECUTABLE: set for virtual environments [/usr/bin/python3 by default]

  • WOO_FLAVOR: suffix compiled woo module so that several can be installed and used in parallel [nothing by default].

  • WOO_DEBUG: include debugging information in the build [OFF by default]


Windows Subsystem for Linux makes it possible to run Ubuntu (and other distributions) inside Windows; GUI apps can be also run (under recent builds of Windows). Thus for Windows installation, follow instructions for Ubuntu above.


Report issues or inclarities to github.