Documentation:Modules/shout - Revision history

DoesItReallyMatter: Paraphrase my own work from Documentation:Modules/access_output_shout: I wrote about the same module twice

2019-05-28T22:33:13Z

Paraphrase my own work from Documentation:Modules/access_output_shout: I wrote about the same module twice

← Older revision		Revision as of 22:33, 28 May 2019
Line 7:		Line 7:
	{{Clear}}		{{Clear}}

	~~There~~ is ~~a comment at~~ the ~~start of the module~~ code (4.0.0-dev):		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:		* Some Comments:
Line 22:		Line 22:
	*		*
	*****************************************************************************/		*****************************************************************************/
			v4l refers to [[GNU/Linux]] Video4Linux and won't work for Windows users.

	This comment precedes the genre option:		This comment precedes the genre option:
	/* To be listed properly as a public stream on the Yellow Pages of shoutcast/icecast		/* To be listed properly as a public stream on the Yellow Pages of shoutcast/icecast

DoesItReallyMatter: /* shout-winamp */ New section, note upcoming removal

2019-05-28T08:33:19Z

shout-winamp: New section, note upcoming removal

← Older revision		Revision as of 08:33, 28 May 2019
Line 95:		Line 95:

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

	~~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>.		Three sub-modules had shortcuts of <code>shoutcasttv</code>, <code>frenchtv</code> and <code>freebox</code>.

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

			=== shout-winamp ===
			This sub-module had the shortcut <code>shout-winamp</code> with description "New winamp 5.2 shoutcast import". It is scheduled [https://git.videolan.org/?p=vlc.git;a=commitdiff;h=d3859f364921c6f4d48115da331ac3a44d7a6351 to be removed] (currently in 4.0.0-dev) with the note:
			<pre>
			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.
			</pre>
			History:
			* [https://git.videolan.org/?p=vlc.git;a=commit;h=acb5da732a27b6c7e8d6e05c2e183d4ae49a9ea9 [acb5da732a27b6c7e8d6e05c2e183d4ae49a9ea9]] (introduction)
			* {{VLCSourceFile\|p=vlc/vlc-0.8.git\|modules/demux/playlist/shoutcast.c}}
			* {{VLCSourceFile\|p=vlc/vlc-0.9.git\|modules/demux/playlist/shoutcast.c}}
			* {{VLCSourceFile\|p=vlc/vlc-1.0.git\|modules/demux/playlist/shoutcast.c}}
			* {{VLCSourceFile\|p=vlc/vlc-1.1.git\|modules/demux/playlist/shoutcast.c}}
			* {{VLCSourceFile\|p=vlc/vlc-2.0.git\|modules/demux/playlist/shoutcast.c}}
			* {{VLCSourceFile\|p=vlc/vlc-2.1.git\|modules/demux/playlist/shoutcast.c}}
			* {{VLCSourceFile\|p=vlc/vlc-2.2.git\|modules/demux/playlist/shoutcast.c}}
			* {{VLCSourceFile\|p=vlc/vlc-3.0.git\|modules/demux/playlist/shoutcast.c}}
			* [https://git.videolan.org/?p=vlc.git;a=commit;h=d3859f364921c6f4d48115da331ac3a44d7a6351 [d3859f364921c6f4d48115da331ac3a44d7a6351]] (removal)
	{{Clear}}		{{Clear}}

	== Source code ==		== Source code ==
	* {{VLCSourceFile\|modules/access_output/shout.c}}		* {{VLCSourceFile\|modules/access_output/shout.c}}

DoesItReallyMatter: Move shortcut(s) to template

2019-05-16T05:50:56Z

Move shortcut(s) to template

← Older revision		Revision as of 05:50, 16 May 2019
Line 3:		Line 3:

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

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

	{{Clear}}		{{Clear}}

DoesItReallyMatter: Create page marked up/adapted from source code/changelog with code comments reproduced

2019-03-28T04:13:27Z

Create page marked up/adapted from source code/changelog with code comments reproduced

New page

__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}}