Scenic: Telepresence software for live performances and installations

Scenic is a free software suite for streaming audio, video and MIDI between live events. It was created at the Society for Arts and Technology (SAT) to give to artists a powerful tool for telepresence in contexts of live arts and new media installations.

The streaming is done over RTP with the GStreamer multimedia framework. Users can also choose low-bandwidth or high-quality codecs, depending on what is available on their system. It offers up to as many audio channels that your audio device supports. Scenic consists in a desktop application and several command-line utilities:

  * scenic: Desktop application to stream audio, video and MIDI over RTP
  * milhouse: Streams audio and video over RTP
  * midistream: Streams MIDI notes and controls over RTP
  * dc-ctl: Controls connected DC IEEE 1394 cameras
  * firereset: Resets a IEEE 1394 bus to help in case of problems
  * jack-info: Prints informations about running JACK servers
  * milhouse-listdecklink: Prints information about deckling cards

See http://code.sat.qc.ca/redmine/projects/scenic/

Compiling Scenic
----------------
We use the GNU Autotools. To build it and install it from the sources::

  ./autogen.sh
  ./configure
  make
  sudo make install
  sudo ldconfig

If you have a previous version of Scenic installed, be sure to uninstall it
before installing a new version::

  sudo make uninstall

Backward compatibility
----------------------
Stable branches have an even minor version number, such as 0.8.
Development branches have an odd minor version number, such as 0.7.
Each release in a development branch may not be interoperable with each other.
The third number in the version number are called "micro". There
are only even micro numbers released.

Milhouse dependency for Scenic
  Scenic always needs the same version of milhouse, eg. scenic 0.6.0
  needs milhouse 0.6.0

Build Instructions (Ubuntu LTS 12.04 Precise)
---------------------------------------------
How to install its dependencies, build it and install it::

  sudo apt-add-repository ppa:sat-metalab/metalab
  sudo apt-get update
  sudo apt-get install -y automake autopoint libgstrtspserver-0.10-dev bison cdbs debhelper doxygen ffmpeg flex gettext gnome-doc-utils gstreamer0.10-alsa gstreamer0.10-ffmpeg gstreamer0.10-plugins-bad gstreamer0.10-plugins-base gstreamer0.10-plugins-good gstreamer0.10-plugins-ugly gstreamer0.10-pulseaudio gstreamer0.10-x help2man jackd libasound2-dev libavc1394-dev libboost-all-dev libbz2-dev libdc1394-22-dev libdv4-dev libglew1.5-dev libglu1-mesa-dev libgstreamer-plugins-base0.10-dev libgstreamer0.10-dev libgtk2.0-dev libid3tag0-dev libiec61883-dev libjack0 libjack-dev libmad0-dev liboil0.3-dev libpulse-dev libraw1394-dev libshmdata-0.6-dev libtheora-dev libtool libvorbis-dev libxml2-dev libxv-dev python python-epydoc python-glade2 python-gst0.10 python-gtk2 python-pypm python-twisted

Other software to install::

  sudo apt-get install jackd x11-utils yelp ffmpeg bash-completion gstreamer0.10-tools

Note that you should answer "Yes" when a dialog asks you whether or not you want to enable realtime priority on the audio device.

And then you build it::

  ./one_step_build.sh

Finally, you should install it::

  sudo make install

License
-------
Released under the GPL v3 or above.