Android Ogg/Theora Streamer : Giss Streamer

From Giss
Revision as of 15:47, 21 April 2012 by Sevy (talk | contribs)

GISS Ogg/Theora Streamer v 1.0.0

This is the Ogg/Theora streamer based on the java vorbis library for android : Vorbis library for android and using a native theora library.

It will only work with version of android >= 2.1 and will not work on devices with simplified processors, it was tested with success on an HTC Desire, it would not work on an HTC Tattoo, because it doesn't support floating point operations.

You should enter your stream parameters in the following screens and type 'Start' to start your stream.

Screenshots

Configuration Screens

GissStreamer-server.png GissStreamer-quality.png GissStreamer-metadata.png

Streaming Screens

If all is fine, you will see the following screen during streaming :

File:GissStreamer-streaming.png

In case of an error, you will see an error in the status message or will have a pop-up alert :

GissStreamer-error.png

Synopsis

Enter the stream server parameters in the main screen, than go to 'Stream quality' screen and enter the parameters you choose :

  • WidthxHeight : size of the video that is transmitted ( different form the size you see on the screen )
  • Framerate : framerate of the video stream
  • Video quality : theora encoding quality
  • Audio bitrate : the audio bitrate of your stream.
  • Audio channels : the number of requested channels ( usually mono is enough with a phone ).
  • Audio rate : the audio rate of the recording.

Finally, enter your stream metadata in the 'Meta Data' screen :

  • Name : name of the stream
  • Description : description of the stream
  • Genre : genre
  • More info : an url that describes more your project.

Then, click the 'Start' button and the stream should start.

Notes

On small android models, use a low value for the video size ( 160x128 ) as well as a low framerate ( 3 ).

Acknowledgements

Thanks to K Ichimaru ( http://tokotoko.gr.jp/ ) for his Vorbis library and to Karl Heyes ( xiph.org ) for his precious help.

License

To use this application, you need to respect the Terms Of Use of giss.tv :

The code published here can be studied, modified, used by anyone that provides all the original credits and sources in derivative projects.

There are restrictions on its use, it cannot be used for :

  • military and/or repressive use
  • commercial installations and products
  • any project that promotes : racism, nationalism, xenophobia, sexism,

homophobia, religious hatred or missionarism .. ( expandable list)

This is not a standard license.

Download

Download version 1.0.0 : Giss Streamer

Source code

The source code can be downloaded from our CVS :

 export CVSROOT=:pserver:anonymous@giss.tv:/home/cvs
 cvs co GissStreamer

have fun!