View source for Documentation:Modules/shout

__FORCETOC__
The services discovery module was removed. '''The [[#Access_output|Access output module]] is current.'''

== Access output ==
{{Module|name=shout|type=Access output|first_version=0.8.4|description=This module forwards [[vorbis]] streams to an [[icecast]] server}}

This module has a shortcut of <code>shout</code>.

{{Clear}}

There is a comment at the start of the module code (4.0.0-dev):
 /*****************************************************************************
  * Some Comments:
  *
  * - this only works for ogg and/or mp3, and we don't check this yet.
  * - MP3 metadata is not passed along, since metadata is only available after
  *   this module is opened.
  *
  * Typical usage:
  *
  * vlc v4l:/dev/video:input=2:norm=pal:size=192x144 \
  * --sout '#transcode{vcodec=theora,vb=300,acodec=vorb,ab=96}\
  * :std{access=shout,mux=ogg,dst=localhost:8005}'
  *
  *****************************************************************************/
This comment precedes the genre option:
 /* To be listed properly as a public stream on the Yellow Pages of shoutcast/icecast
    the genres should match those used on the corresponding sites. Several examples
    are Alternative, Classical, Comedy, Country etc. */

This comment precedes the stream information options:
 /* The shout module only "transmits" data. It does not have direct access to
    "codec level" information. Stream information such as bitrate, samplerate,
    channel numbers and quality (in case of Ogg streaming) need to be set manually */

=== Options ===
{{Option
|name=sout-shout-name
|value=string
|default="VLC media player - Live stream"
|description=Name to give to this stream/channel on the [[shoutcast]]/[[icecast]] server
}}
{{Option
|name=sout-shout-description
|value=string
|default="Live stream from VLC media player"
|description=Description of the stream content or information about your channel
}}
{{Option
|name=sout-shout-mp3
|value=boolean
|default=disabled
|description=You normally have to feed the shoutcast module with [[Ogg]] streams. It is also possible to stream [[MP3]] instead, so you can forward MP3 streams to the shoutcast/icecast server
}}
{{Option
|name=sout-shout-genre
|value=string
|default="Alternative"
|description=Genre of the content
}}
{{Option
|name=sout-shout-url
|value=string
|default=<nowiki>"http://www.videolan.org/vlc"</nowiki>
|description=URL with information about the stream or your channel
}}
{{Option
|name=sout-shout-bitrate
|value=string
|default=""
|description=[[Bitrate]] information of the [[transcode]]d stream
}}
{{Option
|name=sout-shout-samplerate
|value=string
|default=""
|description=[[Samplerate]] information of the transcoded stream
}}
{{Option
|name=sout-shout-channels
|value=string
|default=""
|description=Number of channels information of the transcoded stream
}}
{{Option
|name=sout-shout-quality
|value=string
|default=""
|description=[[Ogg]] [[Vorbis]] Quality information of the transcoded stream
}}
{{Option
|name=sout-shout-public
|value=boolean
|default=disabled
|description=Make the server publicly available on the 'Yellow Pages' (directory listing of streams) on the icecast/shoutcast website. Requires the bitrate information specified for shoutcast. Requires Ogg streaming for icecast
}}

== Services discovery ==
{{Module|name=shout|type=Services discovery|first_version=0.8.2|last_version=1.0.6|description=Shoutcast services discovery module}}

This module had a shortcut of <code>shoutcast</code> and later an additional shortcut of <code>shout</code>. The three sub-modules had shortcuts of <code>shoutcasttv</code>, <code>frenchtv</code> and <code>freebox</code>.

=== Options ===
None (<code>--shoutcast-limit</code> was deprecated with {{Commitdiff|p=vlc/vlc-1.0.git|acb5da732a27b6c7e8d6e05c2e183d4ae49a9ea9}}).

{{Clear}}
== Source code ==
* {{VLCSourceFile|modules/access_output/shout.c}}
* {{VLCSourceFile|p=vlc/vlc-1.0.git|modules/services_discovery/shout.c}}

{{Documentation}}