Documentation:Modules/shout
The services discovery module was removed. The Access output module is current.
Contents
Access output
Module: shout | |
---|---|
Type | Access output |
First VLC version | 0.8.4 |
Last VLC version | - |
Operating system(s) | all |
Description | This module forwards vorbis streams to an icecast server |
Shortcut(s) | shout
|
Documentation is present directly in the source code (4.0.0-dev) as multiple C comment blocks, relevant comments reproduced here (copyright © 2005 VLC authors and VideoLAN, Authors: Daniel Fischer and Derk-Jan Hartman, LGPL 2.1 or later):
/***************************************************************************** * 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}' * *****************************************************************************/
v4l refers to GNU/Linux Video4Linux and won't work for Windows users.
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
- sout-shout-name <string> : Name to give to this stream/channel on the shoutcast/icecast server default value: "VLC media player - Live stream"
- sout-shout-description <string> : Description of the stream content or information about your channel default value: "Live stream from VLC media player"
- sout-shout-mp3 <boolean> : 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 default value: disabled
- sout-shout-genre <string> : Genre of the content default value: "Alternative"
- sout-shout-url <string> : URL with information about the stream or your channel default value: "http://www.videolan.org/vlc"
- sout-shout-bitrate <string> : Bitrate information of the transcoded stream default value: ""
- sout-shout-samplerate <string> : Samplerate information of the transcoded stream default value: ""
- sout-shout-channels <string> : Number of channels information of the transcoded stream default value: ""
- sout-shout-quality <string> : Ogg Vorbis Quality information of the transcoded stream default value: ""
- sout-shout-public <boolean> : 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 default value: disabled
Services discovery
Module: shout | |
---|---|
Type | Services discovery |
First VLC version | 0.8.2 |
Last VLC version | 1.0.6 |
Operating system(s) | all |
Description | Shoutcast services discovery module |
Shortcut(s) | shoutcast , shout
|
Three sub-modules had shortcuts of shoutcasttv
, frenchtv
and freebox
.
Options
None (--shoutcast-limit
was deprecated with [acb5da732a27b6c7e8d6e05c2e183d4ae49a9ea9]).
shout-winamp
This sub-module had the shortcut shout-winamp
with description "New winamp 5.2 shoutcast import". It is scheduled to be removed (currently in 4.0.0-dev) with the note:
Removes the long unused Winamp/SHOUTcast directory stream filter for playlist handling, which was mostly useful together with the service discovery (modules/services_discovery/shout.c) which is not present anymore.
History:
- [acb5da732a27b6c7e8d6e05c2e183d4ae49a9ea9] (introduction)
- modules/demux/playlist/shoutcast.c (vlc/vlc-0.8.git)
- modules/demux/playlist/shoutcast.c (vlc/vlc-0.9.git)
- modules/demux/playlist/shoutcast.c (vlc/vlc-1.0.git)
- modules/demux/playlist/shoutcast.c (vlc/vlc-1.1.git)
- modules/demux/playlist/shoutcast.c (vlc/vlc-2.0.git)
- modules/demux/playlist/shoutcast.c (vlc/vlc-2.1.git)
- modules/demux/playlist/shoutcast.c (vlc/vlc-2.2.git)
- modules/demux/playlist/shoutcast.c (vlc/vlc-3.0.git)
- [d3859f364921c6f4d48115da331ac3a44d7a6351] (removal)
Source code
- modules/access_output/shout.c
- modules/services_discovery/shout.c (vlc/vlc-1.0.git)
Please read the Documentation Editing Guidelines before you edit the documentation