Difference between revisions of "Android Ogg/Theora Streamer : Giss Streamer"

From Giss
Line 75: Line 75:
== Download ==
== Download ==
Download version 1.0.0 : [http://www.giss.tv/android/GissStreamer-debug.apk Giss Streamer]
Download version 1.0.0 : [http://giss.tv/android/GissStreamer-debug.apk Giss Streamer]
== Source code ==
== Source code ==

Revision as of 21:34, 14 June 2021

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.


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 :


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



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.


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


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


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 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!