Installation Guide

1. Install Dependencies

FireMix requires Python 2 (tested in 2.7) and the following libraries:

• PySide
• numpy
• noise
• distribute (You may have pip/distribute already.)

On Windows, you should start by installing PySide 1.1.2 using the official installer. It's easiest to find installers for the other dependencies precompiled, such as the unofficial ones at http://www.lfd.uci.edu/~gohlke/pythonlibs/ .

On Linux, just use pip to install the dependencies:

pip install -r requirements.txt

2. Create default files

The repository ships with example settings and playlist files to get you started (the program can not yet create them automatically). You will need to create local copies (do not include these copies in pull requests!). In the Linux console:

cp data/settings.json.example data/settings.json
cp data/playlists/default.json.example data/playlists/default.json

3. Compile Qt resources

The GUI forms need to be run through Qt's compiler. Since we use PySide, the program is called pyside-uic. There are scripts you can run to automatically compile all of the resources.

On Windows, run the script compile-ui.bat.

On Linux, run ./compile-ui.sh

4. Startup

At this point, you should be able to run FireMix and see output on FireSim. Use the command:

python firemix.py demo