Theora Streaming Studio
a GUI to make theora video streams using ffmpeg2theora software
07/05/2007
Use it! | Known bugs | Troubleshooting | Tips
Use it!!
Click on the "Theora Streaming Studio" icon on the desktop :
Alternatively, you can open a terminal and type the command "tss".
The application should start and the first thing you see is something like this : 
As you can see the window is divided basically in four areas.
The upper menu where you can load and save your encoding and streaming settings.
The main notebook is where you can configure the settings of the source and target(s) of your process.
The two big buttons "Execute" and "Stop" will start/stop your encoding/streaming process.
And the Virtual Terminal ( black window at the bottom of the GUI ) will give you some information and error messages for the encoding/streaming process.
1. the first step is to choose the video source of your stream, this is done in the "source" page of the notebook.
As you can see, you can choose between two different video sources: "dv input" to use a dv-camera or other firewire video device or the "video file" option to stream or reencode any video file from your hard drive. 
2. the next step is to setup at least one of the targets, so go to the "target1" page and you will see the target configured with the default settings.
Configure the encodding settings as you like, the default settings are good to send an audio/video stream using about 128Kbps of bandwidth.
All the metadata fields are optionals.
In the "icecast server settings" you must put the correct values for your streaming server, port, mountpoint and password. If you leave any of this fields empty, the target is NOT configured to stream, but still can be used as a video encoder using the "dump to local file" one.
If you put a filename in the "dump to local file" field the theora encoded video will be written on your hard disk.
NOTE: the TSS interface give you the option to encode two "targets" at the same time from the same source. This will be useful for example to stream video in two different qualities in two different mountpoints, to cover different audiences with different bandwidth. But be careful with the CPU usage in that case.
3. the last step: Execute! 

Some tips about the preview window
The preview window is enabled by default, it will show you the result for the first "target", so if you are encodding two targets at the same time, we recommend you to use the "target1" as the lowest quality to reduce the CPU cost of the preview.
If your soundcard does not support full duplex the preview will not work.
If your preview audio or video drops it is likely that you are using too much CPU or too much bandwidth with your settings.
Known Bugs
the "dump to local file" option overwrites files without asking.
the open/save settings feature is not well implemented at all.
the "file input" source doesn't accept spaces in the filename.
with some audio cards you cannot capture audio from /dev/dsp and use the preview feature at the same time.
Troubleshooting
- error :
/usr/bin/ffmpeg2theora: invalid option -- F
ffmpeg2theora should be the version 0.18 or higher.
lower versions will give this error.
this is because versions lower than 0.18 dont support framerates lower than 25 fps.
however, you will still be able to stream but it makes a very heavy kbps.
- error :
raw1394 - failed to get handle: No such device or address.
File `pipe:' does not exist or has an unknown data format.
oggfwd: Connected to server
you need to have dv1394 drivers loaded. check your firewire card.
the kernel should be >= 2.6.18
- error :
Found AV/C device with GUID 0x0800460101c567d9
Warning: Cannot set RR-scheduler
Warning: Cannot disable swapping
probably because you are missing libtheora-bin - doesnt seem to exist in debian but u can
install the ubuntu package :
http://packages.ubuntu.com/dapper/utils/libtheora-bin
you can still stream even though dont have this installed.
the preview feature will not be available.
- error :
raw1394 - failed to get handle: Permission denied
the user who starts "tss" need correct privileges to access the firewire device
Please send bugs and comments to lluis at hangar dot org , thanks.
Back to main page.