Web-based interface for the MOD
JavaScript HTML Python CSS C++ C Other
Clone or download
lfagundes fix: there were two instances of windowManager, thus making some wind…
…ows persist on closeWindows() calls

(this is the right one, last one was a mistake)
Latest commit 03ede9b May 30, 2018



This is the UI for the MOD software. It's a webserver that delivers an HTML5 interface and communicates with mod-host. It also communicates with the MOD hardware, but does not depend on it to run.


There are instructions for installing in a 64-bit Debian based Linux environment. It will work in x86, other Linux distributions and Mac, but you might need to adjust the instructions.

The following packages will be required:

$ sudo apt-get install python-virtualenv python3-pip python3-dev git build-essential liblilv-dev

Start by cloning the repository:

$ git clone git://github.com/moddevices/mod-ui
$ cd mod-ui

Create a python virtualenv:

$ virtualenv modui-env
$ source modui-env/bin/activate

Install python requirements:

$ pip3 install -r requirements.txt

Compile libmod_utils:

$ cd utils
$ make
$ cd ..


Before running the server, you need to activate your virtualenv (if you have just done that during installation, you can skip this step, but you'll need to do this again when you open a new shell):

$ source modui-env/bin/activate

Run the server:

$ ./server.py

Open your webkit based browser (I use Chromium) and point to http://localhost:8888