Skip to content


Repository files navigation


iMatrixSpray provides a web interface for controlling a iMatrixSpray device running the deltaSpray firmware. It is based on the OctoPrint software and is released under the GNU Affero General Public License V3.

The octoprint website can be found at


iMatrixSpray depends on a couple of python modules to do its job. Those are listed in requirements.txt and can be installed using pip:

pip install -r requirements.txt

You should also do this after pulling from the repository, since the dependencies might have changed.

iMatrixSpray currently only supports Python 2.7.


Just start the server via


By default it binds to all interfaces on port 5000 (so pointing your browser to will do the trick). If you want to change that, use the additional command line parameters host and port, which accept the host ip to bind to and the numeric port number respectively. If for example you want the server to only listen on the local interface on port 8080, the command line would be

./run --host= --port=8080

Alternatively, the host and port on which to bind can be defined via the configuration.

If you want to run iMatrixSpray as a daemon (only supported on Linux), use

./run --daemon {start|stop|restart} [--pid PIDFILE]

If you do not supply a custom pidfile location via --pid PIDFILE, it will be created at /tmp/

You can also specify the configfile or the base directory (for basing off the uploads, timelapse and logs folders), e.g.:

./run --config /path/to/another/config.yaml --basedir /path/to/my/basedir

See run --help for further information.


If not specified via the commandline, the configfile config.yaml for OctoPrint is expected in the settings folder, which is located at ~/.octoprint on Linux, at %APPDATA%/OctoPrint on Windows and at ~/Library/Application Support/OctoPrint on MacOS.

A comprehensive overview of all available configuration settings can be found on the wiki.

Setup on a Raspberry Pi running Raspbian

A comprehensive setup guide can be found on the wiki.