Installation

The following describes how to install all the necessary dependencies and packages to run the conductAR program for some of the most popular operating systems.

Ubuntu

Music Playback Module

Before you install the python dependencies, you will need the following packages:

sudo apt-get install -y libasound2-dev libjack-dev timidity fluid-soundfont-gm

These are all necessary packages for getting music playback of .midi files working in the python libraries. Timidity may not have all of the standard midi instruments, and so some instruments may be left out in playback. run the following few lines:

sudo sed -e 's|^source|#source|' -e '$a source /etc/timidity/fluidr3_gm.cfg' -i /etc/timidity/timidity.cfg
sudo /etc/init.d/timidity restart

and now you should be finished with the setup of the music playback module. you can test it by running

# in conductAR:
pytest test/playback_test.py

Tensorflow Object Detection API

To track hand movement, this project makes use of tensorflow models' Object Detection API. Follow this link to install the object_detection api, and make sure that the research and slim are in the PYTHONPATH while running this program.

Python Dependencies

requirements.txt has all of the python dependencies. Install them with

pip install -r requirements.txt

Windows

TODO

Mac OS

Hey, if you are a Mac developer, we need you to help us write this part of the installation guide!