View source for Android Ogg Streamer : Giss Vorbis

= GISS Vorbis v 1.0.0 =

This is the Ogg/Vorbis streamer based on the java vorbis library for android : [https://play.google.com/store/apps/details?id=jp.gr.tokotoko.oggDroid Vorbis library for android ].

It should work on any version of android since version 1.6.
 
You should enter your stream parameters in the following screens and type 'Start' to start your stream.

== Screenshots ==

== Configuration Screens ==

[[Image:GissVorbis-server.png]]              [[Image:GissVorbis-quality.png]]                 [[Image:GissVorbis-metadata.png]]

== Streaming Screens ==

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

[[Image:GissVorbis-streaming.png]]

In case of an error, you will get the following screen :

[[Image:GissVorbis-error.png]]

== Synopsis ==

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

* Audio bitrate : the bitrate of your stream.
* Audio channels : the number of requested channels ( usually mono is enough with a phone ).
* Audio rate : the rate of the recording, on small models this should be put to a lower value of 8000 Hz, as a higher rate requires more processing power.

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 recording ( 8000 Hz ),
it has been tested with this value on an HTC Tattoo
and was working fine.

== 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 : [http://www.giss.tv/android/GissVorbis-debug.apk Giss Vorbis]

== Source code ==

The source code can be downloaded from our CVS :

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

have fun!