This is the software running on the late generation TellStick ZNet Lite and TellStick Net

This software is only supported under Linux and macOS.

Although most of the prerequisites can be installed sandboxed, locally in the project folder, there are some libraries that must exist on the system.

The following applications must be available:

• python (2.7)
• virtualenv
• Node.js

In many Linux distributions the packages for python and virtualenv already exist. On a Debian/Ubuntu based system these can be installed using this command:

sudo apt-get install python virtualenv

If virtualenv is not available on your system, you can install it with either pip or easy install:

sudo pip install virtualenv

or

sudo easy_install virtualenv

Pyhon is already shipped on macOS. You only need to install virtualenv using:

sudo easy_install virtualenv

To setup the source and prepare the base plugins run the following script:

./tellstick.sh setup

This vill create a virtualenv folder under the build folder and download and install the required libraries for running the software. The installation is completely sandboxed and nothing is installed in the system. You can wipe the build folder at any time to remove any installed packages.

Start the server by issuing:

./tellstick.sh run

By default the server will restart itself any time it detects a file has been modified.

To install a plugin run:

./tellstick.sh install [path-to-plugin]

Replace [path-to-plugin] with the path to the plugin root folder.

Build the documentation:

./tellstick.sh build-docs

The documentation can be read online here: http://tellstick-server.readthedocs.io