root / README @ master
History | View | Annotate | Download (3.3 kB)
| 1 |
Scenic: Telepresence software for live performances and installations |
|---|---|
| 2 |
|
| 3 |
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. |
| 4 |
|
| 5 |
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: |
| 6 |
|
| 7 |
* scenic: Desktop application to stream audio, video and MIDI over RTP |
| 8 |
* milhouse: Streams audio and video over RTP |
| 9 |
* midistream: Streams MIDI notes and controls over RTP |
| 10 |
* dc-ctl: Controls connected DC IEEE 1394 cameras |
| 11 |
* firereset: Resets a IEEE 1394 bus to help in case of problems |
| 12 |
* jack-info: Prints informations about running JACK servers |
| 13 |
* milhouse-listdecklink: Prints information about deckling cards |
| 14 |
|
| 15 |
See http://code.sat.qc.ca/redmine/projects/scenic/ |
| 16 |
|
| 17 |
Compiling Scenic |
| 18 |
---------------- |
| 19 |
We use the GNU Autotools. To build it and install it from the sources:: |
| 20 |
|
| 21 |
./autogen.sh |
| 22 |
./configure |
| 23 |
make |
| 24 |
sudo make install |
| 25 |
sudo ldconfig |
| 26 |
|
| 27 |
If you have a previous version of Scenic installed, be sure to uninstall it |
| 28 |
before installing a new version:: |
| 29 |
|
| 30 |
sudo make uninstall |
| 31 |
|
| 32 |
Backward compatibility |
| 33 |
---------------------- |
| 34 |
Stable branches have an even minor version number, such as 0.8. |
| 35 |
Development branches have an odd minor version number, such as 0.7. |
| 36 |
Each release in a development branch may not be interoperable with each other. |
| 37 |
The third number in the version number are called "micro". There |
| 38 |
are only even micro numbers released. |
| 39 |
|
| 40 |
Milhouse dependency for Scenic |
| 41 |
Scenic always needs the same version of milhouse, eg. scenic 0.6.0 |
| 42 |
needs milhouse 0.6.0 |
| 43 |
|
| 44 |
Build Instructions (Ubuntu LTS 12.04 Precise) |
| 45 |
--------------------------------------------- |
| 46 |
How to install its dependencies, build it and install it:: |
| 47 |
|
| 48 |
sudo apt-add-repository ppa:sat-metalab/metalab |
| 49 |
sudo apt-get update |
| 50 |
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 |
| 51 |
|
| 52 |
Other software to install:: |
| 53 |
|
| 54 |
sudo apt-get install jackd x11-utils yelp ffmpeg bash-completion gstreamer0.10-tools |
| 55 |
|
| 56 |
Note that you should answer "Yes" when a dialog asks you whether or not you want to enable realtime priority on the audio device. |
| 57 |
|
| 58 |
And then you build it:: |
| 59 |
|
| 60 |
./one_step_build.sh |
| 61 |
|
| 62 |
Finally, you should install it:: |
| 63 |
|
| 64 |
sudo make install |
| 65 |
|
| 66 |
License |
| 67 |
------- |
| 68 |
Released under the GPL v3 or above. |
| 69 |
|