Documentation:Streaming HowTo New - Revision history

DoesItReallyMatter: Change Mac OS X → macOS

2019-01-30T05:43:42Z

Change Mac OS X → macOS

← Older revision		Revision as of 05:43, 30 January 2019
Line 85:		Line 85:
	[[File:Qt4_Streaming_Transcoding.png\|frame\|center\|Transcoding options]]		[[File:Qt4_Streaming_Transcoding.png\|frame\|center\|Transcoding options]]

	Select methods to announce your stream. You can use SAP (Service Announce Protocol) or SLP (Service Location Protocol). You must also specify a channel name. The ~~Mac OS X~~ interface also allows you to export the description (SDP) file of a RTP session using the internal HTTP or RTSP server of VLC, or as a file. This can be done using the according checkboxes. The ''SDP URL'' text box allows to give the url or destination where the SDP file will be available. There is a text box displays the ''Stream Output MRL'' (Media Resource Locator). This is updated as you change options in the Stream output dialog, and can be tweaked by hand if necessary.		Select methods to announce your stream. You can use SAP (Service Announce Protocol) or SLP (Service Location Protocol). You must also specify a channel name. The macOS interface also allows you to export the description (SDP) file of a RTP session using the internal HTTP or RTSP server of VLC, or as a file. This can be done using the according checkboxes. The ''SDP URL'' text box allows to give the url or destination where the SDP file will be available. There is a text box displays the ''Stream Output MRL'' (Media Resource Locator). This is updated as you change options in the Stream output dialog, and can be tweaked by hand if necessary.
	[[File:Qt4_Streaming_Misc.png\|frame\|center\|Selecting methods to announce the stream]]		[[File:Qt4_Streaming_Misc.png\|frame\|center\|Selecting methods to announce the stream]]

DoesItReallyMatter: Remove dead link to videolan.org/doc, change HTTP → HTTPS, `...` → `...`, add wikilinks, make use of {{See also}}, Mac OS X → macOS

2019-01-25T07:28:13Z

Remove dead link to videolan.org/doc, change HTTP → HTTPS, <tt>...</tt> → <code>...</code>, add wikilinks, make use of {{See also}}, Mac OS X → macOS

← Older revision		Revision as of 07:28, 25 January 2019
Line 4:		Line 4:

	==Introduction==		==Introduction==
	VLC media player is able to stream, transcode and save different media streams. For more information about the formats and codecs supported please see the [~~http~~://www.videolan.org/streaming-features.html VideoLAN Streaming Features list].		VLC media player is able to stream, transcode and save different media streams. For more information about the formats and codecs supported please see the [https://www.videolan.org/streaming-features.html VideoLAN Streaming Features list].

	==Transcoding==		==Transcoding==
Line 11:		Line 11:

	===Transcoding using the GUI===		===Transcoding using the GUI===
	One of the methods of transcoding is via the GUI. To access this:		One of the methods of transcoding is via the [[GUI]]. To access this:
	#In VLC, go to "Media >> Convert / Save..." (Ctrl+R).		#In VLC, go to "Media >> Convert / Save..." (Ctrl+R).
	#Add the input file(s) or stream(s) you want to transcode. Press "Convert / Save".		#Add the input file(s) or stream(s) you want to transcode. Press "Convert / Save".
Line 22:		Line 22:

	===Using the commandline===		===Using the commandline===
	Another method of transcoding is via the commandline. This is more flexible than via the GUI as it enables full usage of the modules and options available in VLC.		Another method of transcoding is via the [[commandline]]. This is more flexible than via the GUI as it enables full usage of the modules and options available in VLC.

	To use the VLC's commandline you need to have access to the commandline interface, for example via a shell.		To use the VLC's commandline you need to have access to the commandline interface, for example via a shell.
Line 34:		Line 34:

	====Unix systems====		====Unix systems====
	On Unix-based system (such as Linux and ~~Mac OS X~~) a terminal window can be opened. Running "vlc" should be all that is needed to open VLC:		On Unix-based system (such as Linux and macOS) a terminal window can be opened. Running "vlc" should be all that is needed to open VLC:
	../VLC.app/Contents/MacOS/VLC		../VLC.app/Contents/MacOS/VLC

Line 40:		Line 40:
	A typical commandline string for converting a file to another format is:		A typical commandline string for converting a file to another format is:
	vlc --sout "#transcode{[TRANSCODE_OPTIONS]}:std{[OUTPUT_OPTIONS]}" INPUT		vlc --sout "#transcode{[TRANSCODE_OPTIONS]}:std{[OUTPUT_OPTIONS]}" INPUT
	Where <tt>INPUT</tt> is the input stream, <tt>[TRANSCODE_OPTIONS]</tt> are the options set for the desired output format, [[codec]]s, [[bitrate]] etc. and <tt>[OUTPUT_OPTIONS]</tt> are the option set for the output type. <tt>--sout</tt> is the stream output commandline option.		Where <code>INPUT</code> is the input stream, <code>[TRANSCODE_OPTIONS]</code> are the options set for the desired output format, [[codec]]s, [[bitrate]] etc. and <code>[OUTPUT_OPTIONS]</code> are the option set for the output type. <code>--sout</code> is the stream output commandline option.

	====Example commandline: Converting an audio file to a MP3 file====		====Example commandline: Converting an audio file to a MP3 file====
Line 46:		Line 46:
	vlc --sout "#transcode{acodec=mp3,ab=128,channels=2,samplerate=44100}:std{access=file,mux=raw,dst=OUTPUT}" INPUT		vlc --sout "#transcode{acodec=mp3,ab=128,channels=2,samplerate=44100}:std{access=file,mux=raw,dst=OUTPUT}" INPUT
	Where INPUT is the input file and OUTPUT is the destination file (for example "C:\out.mp3" on Windows or "/home/username/out.mp3" on a *nix system).		Where INPUT is the input file and OUTPUT is the destination file (for example "C:\out.mp3" on Windows or "/home/username/out.mp3" on a *nix system).
	The above sout string is the default "Audio - MP3" profile setting accessible via the GUI. It will convert an audio input to a 128kbps CBR MP3 file (sample rate 44100Hz, 2 channels).		The above sout string is the default "Audio - MP3" profile setting accessible via the GUI. It will convert an audio input to a 128kbps [[CBR]] MP3 file (sample rate 44100Hz, 2 channels).

	====Other examples commandline strings====		====Other examples commandline strings====
Line 57:		Line 57:

	===Streaming using the GUI===		===Streaming using the GUI===
	Streaming using the GUI is only available on the Qt interface. To stream using the GUI, open VLC, then Media [menu] -> Stream:		Streaming using the [[GUI]] is only available on the Qt interface. To stream using the GUI, open VLC, then Media [menu] -> Stream:
	[[File:Qt4_Streaming_Starting.png\|frame\|center\|Launching the Wizard]]		[[File:Qt4_Streaming_Starting.png\|frame\|center\|Launching the Wizard]]

Line 79:		Line 79:
	A few caveats:		A few caveats:
	* even though you click on "enable transcoding" and specify some other container type, it will give you the [[flv]] container type unless you use a suffix, like ".mpg" [http://forum.videolan.org/viewtopic.php?f=14&t=80722 ref]		* even though you click on "enable transcoding" and specify some other container type, it will give you the [[flv]] container type unless you use a suffix, like ".mpg" [http://forum.videolan.org/viewtopic.php?f=14&t=80722 ref]
	* VLC client cannot receive a stream at less than 5 fps, though it can stream it alright for those speeds (and other players can receive it). [~~http~~://trac.videolan.org/vlc/ticket/214 ref].		* VLC client cannot receive a stream at less than 5 fps, though it can stream it alright for those speeds (and other players can receive it). [https://trac.videolan.org/vlc/ticket/214 ref].
	* NB that many times when using the GUI to stream it will choose the wrong thing. For example, if you give a path of "/" it will use FLV container type (which you probably didn't want, and which overrides your transcoding settings' container type silently), and if you give it "/go.mp4" it will silently fail (you can look at the log messages to see what the error is—it says "mp4 type is not supported except for files"). It is tricky to get it set up. It's like the GUI sets it up wrong most times. Here is a [http://forum.videolan.org/viewtopic.php?f=14&t=80722 laundry list].		* NB that many times when using the GUI to stream it will choose the wrong thing. For example, if you give a path of "/" it will use FLV container type (which you probably didn't want, and which overrides your transcoding settings' container type silently), and if you give it "/go.mp4" it will silently fail (you can look at the log messages to see what the error is—it says "mp4 type is not supported except for files"). It is tricky to get it set up. It's like the GUI sets it up wrong most times. Here is a [http://forum.videolan.org/viewtopic.php?f=14&t=80722 laundry list].

Line 91:		Line 91:

	===Streaming using the command line interface===		===Streaming using the command line interface===
	~~:''~~See also~~: [[~~Documentation:Streaming HowTo/Command Line Examples~~]]''~~		{{See also\|Documentation:Streaming HowTo/Command Line Examples}}

	If you want to stream using the command line interface instead of the GUI (more control, for example you can specify your own container), you can "sniff" the options the GUI is using by opening up the logger (Tools menu -> message) and setting verbosity level to "2" then doing a stream. It will output debug messages that basically tell you what it is using for command line parameters, then you will take those same parameters and use them on the command line (you may need to add quotation marks around words that have spaces in them, and you may need to add --'s).		If you want to stream using the command line interface instead of the GUI (more control, for example you can specify your own container), you can "sniff" the options the GUI is using by opening up the logger (Tools menu -> message) and setting verbosity level to "2" then doing a stream. It will output debug messages that basically tell you what it is using for command line parameters, then you will take those same parameters and use them on the command line (you may need to add quotation marks around words that have spaces in them, and you may need to add --'s).

Line 102:		Line 103:
	* [[Documentation:Streaming HowTo\|Streaming HowTo]] - Outdated HowTo for streaming with VLC		* [[Documentation:Streaming HowTo\|Streaming HowTo]] - Outdated HowTo for streaming with VLC
	* [[Transcode]] - Further information about transcoding with VLC		* [[Transcode]] - Further information about transcoding with VLC
	* [http://www.videolan.org/doc/vlc-user-guide/en/ch04.html VideoLAN documentation site, chapter 4]{{dead link}}

	{{Documentation}}		{{Documentation}}

DoesItReallyMatter: /* See also */ Flagging dead link (will be minor from now on)

2019-01-24T00:29:26Z

See also: Flagging dead link (will be minor from now on)

← Older revision		Revision as of 00:29, 24 January 2019
Line 102:		Line 102:
	* [[Documentation:Streaming HowTo\|Streaming HowTo]] - Outdated HowTo for streaming with VLC		* [[Documentation:Streaming HowTo\|Streaming HowTo]] - Outdated HowTo for streaming with VLC
	* [[Transcode]] - Further information about transcoding with VLC		* [[Transcode]] - Further information about transcoding with VLC
	* [http://www.videolan.org/doc/vlc-user-guide/en/ch04.html VideoLAN documentation site, chapter 4]		* [http://www.videolan.org/doc/vlc-user-guide/en/ch04.html VideoLAN documentation site, chapter 4]{{dead link}}

	{{Documentation}}		{{Documentation}}

DoesItReallyMatter: copy-edit

2014-11-10T00:08:33Z

copy-edit

Knola2 at 00:54, 2 December 2013

2013-12-02T00:54:19Z

← Older revision		Revision as of 00:54, 2 December 2013
Line 16:		Line 16:
	#Select the desired codec from the profile list. To check/edit the settings of a given profile press the "Edit selected profile" button. Profiles can also be added/deleted.		#Select the desired codec from the profile list. To check/edit the settings of a given profile press the "Edit selected profile" button. Profiles can also be added/deleted.
	#Press "Start".		#Press "Start".
	If the profile settings were compatible and transcoding was ~~sucessful~~ a playable destination file should be created.		If the profile settings were compatible and transcoding was successful a playable destination file should be created.

	[[File:Basic_interface_convert.png]]		[[File:Basic_interface_convert.png]]
Line 32:		Line 32:

	====Unix systems====		====Unix systems====
	On Unix-based system (such as Linux and Mac OS X) a terminal window can be opened. Running "vlc" should be all that is needed to open VLC.		On Unix-based system (such as Linux and Mac OS X) a terminal window can be opened. Running "vlc" should be all that is needed to open VLC:
			../VLC.app/Contents/MacOS/VLC

	====Transcoding commandline string structure====		====Transcoding commandline string structure====
Line 42:		Line 43:
	An example usage might be converting an audio file to a MP3 file:		An example usage might be converting an audio file to a MP3 file:
	vlc --sout "#transcode{acodec=mp3,ab=128,channels=2,samplerate=44100}:std{access=file,mux=raw,dst=OUTPUT}" INPUT		vlc --sout "#transcode{acodec=mp3,ab=128,channels=2,samplerate=44100}:std{access=file,mux=raw,dst=OUTPUT}" INPUT
	Where INPUT is the input file ~~ans~~ OUTPUT is the destination file (for example "C:\out.mp3" on Windows or "/home/username/out.mp3" on a *nix system).		Where INPUT is the input file and OUTPUT is the destination file (for example "C:\out.mp3" on Windows or "/home/username/out.mp3" on a *nix system).
	The above sout string is the default "Audio - MP3" profile setting accessible via the GUI. It will convert an audio input to a 128kbps CBR MP3 file (sample rate 44100Hz, 2 channels).		The above sout string is the default "Audio - MP3" profile setting accessible via the GUI. It will convert an audio input to a 128kbps CBR MP3 file (sample rate 44100Hz, 2 channels).
	====Other examples commandline strings====		====Other examples commandline strings====

Corbax: /* See also */

2013-11-15T16:36:04Z

Edwardw: /* Streaming using the command line interface */

2012-06-20T16:32:05Z

Streaming using the command line interface

← Older revision		Revision as of 16:32, 20 June 2012
Line 87:		Line 87:

	===Streaming using the command line interface===		===Streaming using the command line interface===
			:''See also: [[Documentation:Streaming_HowTo/Command_Line_Examples]]''
	If you want to stream using the command line interface instead of the GUI (more control, for example you can specify your own container), you can "sniff" the options the GUI is using by opening up the logger (Tools menu -> message) and setting verbosity level to "2" then doing a stream. It will output debug messages that basically tell you what it is using for command line parameters, then you will take those same parameters and use them on the command line (you may need to add quotation marks around words that have spaces in them, and you may need to add --'s).		If you want to stream using the command line interface instead of the GUI (more control, for example you can specify your own container), you can "sniff" the options the GUI is using by opening up the logger (Tools menu -> message) and setting verbosity level to "2" then doing a stream. It will output debug messages that basically tell you what it is using for command line parameters, then you will take those same parameters and use them on the command line (you may need to add quotation marks around words that have spaces in them, and you may need to add --'s).

Edwardw: /* Streaming using the GUI */

2012-06-20T16:31:20Z

Streaming using the GUI

← Older revision		Revision as of 16:31, 20 June 2012
Line 53:		Line 53:

	===Streaming using the GUI===		===Streaming using the GUI===
			Streaming using the GUI is only available on the Qt interface. To stream using the GUI, open VLC, then Media [menu] -> Stream:
			[[File:Qt4_Streaming_Starting.png\|frame\|center\|Launching the Wizard]]

	~~Basically, to~~ stream ~~using the GUI, open VLC, then Media [menu] -> Streaming ->~~ (~~select any media to stream~~, ~~then hit Stream button). At this point it asks you how to stream it. The most common way is via HTTP. To~~ stream ~~via HTTP~~, ~~click on "Destinations"~~, ~~choose HTTP from the drop down as~~ a ~~"New Destination" and click add~~. ~~Now if you are streaming video, you will want to stream to something like "/go~~.~~mpg~~.~~" Now hit stream, and you should be able to use a different instance of VLC as a client, and listen to that stream now (ex: on~~ the ~~same computer it would be~~ "Media" ~~[menu] -> Open Network Stream -> "http://localhost:8080/go.mpg" and it should work~~.		Select a stream (such as a file, a network stream, a disk, a capture device ...) from the "Open Media" dialogs that pops up.

	~~A few caveats:~~		[[File:Qt4_Streaming_File_Select.png\|frame\|center\|After selecting an item, the wizard is ready to begin]]
	* even though you click on "enable transcoding" and specify some other container type, it will give you the flv container type unless you use a suffix, like ".mpg" [~~http://forum.videolan.org/viewtopic.php?f=14&t=80722 ref]~~
	* VLC client cannot receive a stream at less than 5 fps, though it can stream it all right for those speeds (and other players can receive it). [~~http~~:~~//trac~~.~~videolan.org/vlc/ticket/214 ref].~~
	* NB that many times when using the GUI to stream it will choose the wrong thing. Like if you give a path of "/" it will use FLV container type (which you probably didn't want, ~~and which overrides your transcoding settings' container type silently), and if you give it "/go.mp4" it will silently fail (you can look at~~ the ~~log messages to see what the error~~ is~~--it says "mp4 type is not supported except for files"). It is tricky~~ to ~~get it setup. It's like the GUI sets it up wrong most times. Here is a [[http://forum.videolan.org/viewtopic.php?f=14&t=80722 laundry list~~]].

	~~First there~~ is ~~an input text called~~ '''~~Source~~''', ~~where you~~'~~ll find your media path~~ and the ~~its type~~.		The following streaming methods are available for use with VLC:
			*''Display locally'': display the stream on your screen. This allows you to display the stream you are actually streaming. Effects of transcoding, rescaling, etc. can be monitored locally using this function.
			*''File'': Save the stream to a file.
			*''HTTP'': Use the HTTP streaming method. Specify the TCP port number on which to listen.
			*''MS-WMSP (MMSH)'': This access method allows you to stream to Microsoft Windows Media Player. Specify the IP address and TCP port number on which to listen. Note: This will only work with the ''ASF'' encapsulation method.
			*''UDP'': Stream in unicast by providing an address in the 0.0.0.0 - 223.255.255.255 range or in multicast by providing an address in the 224.0.0.0 - 239.255.255.255 range. It is also possible to stream to IPv6 addresses. Note: This will only work with the ''TS'' encapsulation method.
			*''RTP'': Use the Real-Time Transfer Protocol. Like UDP, it can use both unicast and multicast addresses.
			*''IceCast'': Stream to an IceCast server. Specify the address, port, mount point and authentication of the IceCast server to stream to.

	[~~[File~~:~~VlcStream~~.~~png]]~~		The most common way is via HTTP. To stream via HTTP, click on "Destinations", choose HTTP from the drop down as a "New Destination" and click add. Now if you are streaming video, you will want to stream to something like "/go.mpg." Now hit stream, and you should be able to use a different instance of VLC as a client, and listen to that stream now (ex: on the same computer it would be "Media" [menu] -> Open Network Stream -> "http://localhost:8080/go.mpg" and it should work.

			[[File:Qt4_Streaming_Stream_Options.png\|frame\|center\|Wizard streaming method]]

	If you~~'ll~~ click on ~~Destination~~ you~~'ll see~~ the ~~destination of~~ stream that ~~could be: ''File''~~, ~~''HTTP'', ''MS-WSMP'', ''RTSP'', ''RTP~~/~~MPG'~~', '~~'RTP~~, ~~Audio~~/~~Video'', ''UDP'' and ''Icecast'~~'.		A few caveats:
			* even though you click on "enable transcoding" and specify some other container type, it will give you the flv container type unless you use a suffix, like ".mpg" [http://forum.videolan.org/viewtopic.php?f=14&t=80722 ref]
			* VLC client cannot receive a stream at less than 5 fps, though it can stream it all right for those speeds (and other players can receive it). [http://trac.videolan.org/vlc/ticket/214 ref].
	[[~~File~~:~~Stream-destination~~.~~png~~]]		* NB that many times when using the GUI to stream it will choose the wrong thing. For example, if you give a path of "/" it will use FLV container type (which you probably didn't want, and which overrides your transcoding settings' container type silently), and if you give it "/go.mp4" it will silently fail (you can look at the log messages to see what the error is--it says "mp4 type is not supported except for files"). It is tricky to get it setup. It's like the GUI sets it up wrong most times. Here is a [[http://forum.videolan.org/viewtopic.php?f=14&t=80722 laundry list]].

	~~You can abilitate '''Transcoding''' to transcode your video to one in the list or in a one you can specify by clicking on the proper icon~~.

	~~Last you have~~ the ~~option~~ of stream ~~you'll share~~.		Select a transcoding profile that fits the codecs and access method of your stream, such as MPEG TS, MPEG PS, MPEG 1, OGG, Raw, ASF, AVI, MP4 and MOV. You can also create or modify profiles by clicking the "Edit selected profile" button next to the selection combobox.
			[[File:Qt4_Streaming_Transcoding.png\|frame\|center\|Transcoding options]]

	[[File:~~Stream-option~~.png]]		Select methods to announce your stream. You can use SAP (Service Announce Protocol) or SLP (Service Location Protocol). You must also specify a channel name. The Mac OS X interface also allows you to export the description (SDP) file of a RTP session using the internal HTTP or RTSP server of VLC, or as a file. This can be done using the according checkboxes. The ''SDP URL'' text box allows to give the url or destination where the SDP file will be available. There is a text box displays the ''Stream Output MRL'' (Media Resource Locator). This is updated as you change options in the Stream output dialog, and can be tweaked by hand if necessary.
			[[File:Qt4_Streaming_Misc.png\|frame\|center\|Selecting methods to announce the stream]]

	~~By clicking stream it will return~~ to ~~VLC main user interface and the playbar will scroll as the video will play~~.		Click "Stream" to start streaming.

	===Streaming using the command line interface===		===Streaming using the command line interface===

Gth: /* More Links */ Link was incorrect; moved to "See Also" and corrected.

2012-04-26T22:45:05Z

More Links: Link was incorrect; moved to "See Also" and corrected.

← Older revision		Revision as of 22:45, 26 April 2012
Line 87:		Line 87:
	C:\Program Files\VideoLAN\VLC>vlc "C:\Users\Public\Videos\Sample Videos\Wildlife.wmv":		C:\Program Files\VideoLAN\VLC>vlc "C:\Users\Public\Videos\Sample Videos\Wildlife.wmv":
	sout=#transcode{vcodec=h264,acodec=mp3,ab=128,channels=2,samplerate=44100}:http{dst=:8090/go.mpg}		sout=#transcode{vcodec=h264,acodec=mp3,ab=128,channels=2,samplerate=44100}:http{dst=:8090/go.mpg}

	~~=== More Links ===~~
	~~The [http://www.videolan.org/doc/videolan-howto/en/ch04.html Documentation chapter 4].~~

	==See also==		==See also==

Gth: /* See also */ Moved a link to this more appropriate section, and corrected it

2012-04-26T22:44:15Z

See also: Moved a link to this more appropriate section, and corrected it

← Older revision		Revision as of 22:44, 26 April 2012
Line 92:		Line 92:

	==See also==		==See also==
	*[[Documentation:Streaming HowTo\|Streaming HowTo]] - Outdated HowTo for streaming with VLC		* [[Documentation:Streaming HowTo\|Streaming HowTo]] - Outdated HowTo for streaming with VLC
	*[[Transcode]] - Further information about transcoding with VLC		* [[Transcode]] - Further information about transcoding with VLC
			* [http://www.videolan.org/doc/vlc-user-guide/en/ch04.html VideoLAN documentation site, chapter 4]

← Older revision		Revision as of 00:08, 10 November 2014
Line 7:		Line 7:

	==Transcoding==		==Transcoding==
	[[Transcode\|Transcoding]] is the process of taking a media file or stream and converting it to a different format or bitrate. There are two methods for transcoding in VLC, via the GUI (VLC's default interface) or via the commandline. The term ''transcode'' by itself normally refers to converting one media format to another and saving the output to a file (i.e. no streaming involved).		[[Transcode\|Transcoding]] is the process of taking a media file or stream and converting it to a different format or bitrate.<br />
			There are two methods for transcoding in VLC: via the GUI (VLC's default interface) or via the commandline. The term ''transcode'' by itself normally refers to converting one media format to another and saving the output to a file (i.e. no streaming involved).

	===Transcoding using the GUI===		===Transcoding using the GUI===
Line 16:		Line 17:
	#Select the desired codec from the profile list. To check/edit the settings of a given profile press the "Edit selected profile" button. Profiles can also be added/deleted.		#Select the desired codec from the profile list. To check/edit the settings of a given profile press the "Edit selected profile" button. Profiles can also be added/deleted.
	#Press "Start".		#Press "Start".
	If the profile settings were compatible and transcoding was successful a playable destination file should be created.		If the profile settings were compatible and transcoding was successful, a playable destination file should be created.

	[[File:Basic_interface_convert.png]]		[[File:Basic_interface_convert.png]]
Line 24:		Line 25:

	To use the VLC's commandline you need to have access to the commandline interface, for example via a shell.		To use the VLC's commandline you need to have access to the commandline interface, for example via a shell.

	====Windows-based systems====		====Windows-based systems====
	On Windows-based ~~system~~ Command Prompt can be used. This can be found in the "Accessories" folder of the Start menu. Alternatively by going to "Start >> Run..." or pressing "Windows key + R", entering "cmd" into the text field and press "OK" or Enter.		On Windows-based systems the Command Prompt can be used. This can be found in the "Accessories" folder of the Start menu. Alternatively by going to "Start >> Run..." or pressing "Windows key + R", entering "cmd" into the text field and press "OK" or Enter.

	Once the Command Prompt window is opened navigating to the folder/directory where VLC is located is easiest for using the commandline as only "vlc.exe" or "vlc" (as the .exe part is assumed) needs to entered to run VLC. If VLC is installed in the default location (on a 32-bit system) running:		Once the Command Prompt window is opened navigating to the folder/directory where VLC is located is easiest for using the commandline as only "vlc.exe" or "vlc" (as the .exe part is assumed) needs to entered to run VLC. If VLC is installed in the default location (on a 32-bit system) running:
Line 38:		Line 40:
	A typical commandline string for converting a file to another format is:		A typical commandline string for converting a file to another format is:
	vlc --sout "#transcode{[TRANSCODE_OPTIONS]}:std{[OUTPUT_OPTIONS]}" INPUT		vlc --sout "#transcode{[TRANSCODE_OPTIONS]}:std{[OUTPUT_OPTIONS]}" INPUT
	Where <tt>INPUT</tt> is the input stream, <tt>[TRANSCODE_OPTIONS]</tt> are the options set for the desired output format, ~~codecs~~, bitrate etc. and <tt>[OUTPUT_OPTIONS]</tt> are the option set for the output type. <tt>--sout</tt> is the stream output commandline option.		Where <tt>INPUT</tt> is the input stream, <tt>[TRANSCODE_OPTIONS]</tt> are the options set for the desired output format, [[codec]]s, [[bitrate]] etc. and <tt>[OUTPUT_OPTIONS]</tt> are the option set for the output type. <tt>--sout</tt> is the stream output commandline option.

	====Example commandline: Converting an audio file to a MP3 file====		====Example commandline: Converting an audio file to a MP3 file====
Line 45:		Line 47:
	Where INPUT is the input file and OUTPUT is the destination file (for example "C:\out.mp3" on Windows or "/home/username/out.mp3" on a *nix system).		Where INPUT is the input file and OUTPUT is the destination file (for example "C:\out.mp3" on Windows or "/home/username/out.mp3" on a *nix system).
	The above sout string is the default "Audio - MP3" profile setting accessible via the GUI. It will convert an audio input to a 128kbps CBR MP3 file (sample rate 44100Hz, 2 channels).		The above sout string is the default "Audio - MP3" profile setting accessible via the GUI. It will convert an audio input to a 128kbps CBR MP3 file (sample rate 44100Hz, 2 channels).

	====Other examples commandline strings====		====Other examples commandline strings====
	Convert an audio input to an uncompressed WAVE (*.wav) file:		Convert an audio input to an uncompressed WAVE (*.wav) file:
Line 70:		Line 73:
	*''IceCast'': Stream to an IceCast server. Specify the address, port, mount point and authentication of the IceCast server to stream to.		*''IceCast'': Stream to an IceCast server. Specify the address, port, mount point and authentication of the IceCast server to stream to.

	The most common way is via HTTP. To stream via HTTP, click on "Destinations", choose HTTP from the drop down as a "New Destination" and click add. Now if you are streaming video, you will want to stream to something like "/go.mpg." Now hit stream, and you should be able to use a different instance of VLC as a client, and listen to that stream now (ex: on the same computer it would be "Media" [menu] -> Open Network Stream -> "http://localhost:8080/go.mpg" and it should work.		The most common way is via [[HTTP]]. To stream via HTTP, click on "Destinations", choose HTTP from the drop down as a "New Destination" and click add. Now if you are streaming video, you will want to stream to something like "/go.mpg." Now hit stream, and you should be able to use a different instance of VLC as a client, and listen to that stream now (ex: on the same computer it would be "Media" [menu] -> Open Network Stream -> "http://localhost:8080/go.mpg" and it should work.

	[[File:Qt4_Streaming_Stream_Options.png\|frame\|center\|Wizard streaming method]]		[[File:Qt4_Streaming_Stream_Options.png\|frame\|center\|Wizard streaming method]]

	A few caveats:		A few caveats:
	* even though you click on "enable transcoding" and specify some other container type, it will give you the flv container type unless you use a suffix, like ".mpg" [http://forum.videolan.org/viewtopic.php?f=14&t=80722 ref]		* even though you click on "enable transcoding" and specify some other container type, it will give you the [[flv]] container type unless you use a suffix, like ".mpg" [http://forum.videolan.org/viewtopic.php?f=14&t=80722 ref]
	* VLC client cannot receive a stream at less than 5 fps, though it can stream it ~~all right~~ for those speeds (and other players can receive it). [http://trac.videolan.org/vlc/ticket/214 ref].		* VLC client cannot receive a stream at less than 5 fps, though it can stream it alright for those speeds (and other players can receive it). [http://trac.videolan.org/vlc/ticket/214 ref].
	* NB that many times when using the GUI to stream it will choose the wrong thing. For example, if you give a path of "/" it will use FLV container type (which you probably didn't want, and which overrides your transcoding settings' container type silently), and if you give it "/go.mp4" it will silently fail (you can look at the log messages to see what the error ~~is--it~~ says "mp4 type is not supported except for files"). It is tricky to get it ~~setup~~. It's like the GUI sets it up wrong most times. Here is a [[http://forum.videolan.org/viewtopic.php?f=14&t=80722 laundry list]].		* NB that many times when using the GUI to stream it will choose the wrong thing. For example, if you give a path of "/" it will use FLV container type (which you probably didn't want, and which overrides your transcoding settings' container type silently), and if you give it "/go.mp4" it will silently fail (you can look at the log messages to see what the error is—it says "mp4 type is not supported except for files"). It is tricky to get it set up. It's like the GUI sets it up wrong most times. Here is a [http://forum.videolan.org/viewtopic.php?f=14&t=80722 laundry list].

	Select a transcoding profile that fits the codecs and access method of your stream, such as MPEG TS, MPEG PS, MPEG 1, ~~OGG~~, Raw, ASF, AVI, MP4 and MOV. You can also create or modify profiles by clicking the "Edit selected profile" button next to the selection combobox.		Select a transcoding profile that fits the codecs and access method of your stream, such as [[MPEG-TS]], [[MPEG-PS]], [[MPEG-1]], [[Ogg]], [[Raw]], [[ASF]], [[AVI]], [[MP4]] and [[MOV]]. You can also create or modify profiles by clicking the "Edit selected profile" button next to the selection combobox.
	[[File:Qt4_Streaming_Transcoding.png\|frame\|center\|Transcoding options]]		[[File:Qt4_Streaming_Transcoding.png\|frame\|center\|Transcoding options]]

Line 88:		Line 91:

	===Streaming using the command line interface===		===Streaming using the command line interface===
	:''See also: [[Documentation:~~Streaming_HowTo~~/~~Command_Line_Examples~~]]''		:''See also: [[Documentation:Streaming HowTo/Command Line Examples]]''
	If you want to stream using the command line interface instead of the GUI (more control, for example you can specify your own container), you can "sniff" the options the GUI is using by opening up the logger (Tools menu -> message) and setting verbosity level to "2" then doing a stream. It will output debug messages that basically tell you what it is using for command line parameters, then you will take those same parameters and use them on the command line (you may need to add quotation marks around words that have spaces in them, and you may need to add --'s).		If you want to stream using the command line interface instead of the GUI (more control, for example you can specify your own container), you can "sniff" the options the GUI is using by opening up the logger (Tools menu -> message) and setting verbosity level to "2" then doing a stream. It will output debug messages that basically tell you what it is using for command line parameters, then you will take those same parameters and use them on the command line (you may need to add quotation marks around words that have spaces in them, and you may need to add --'s).

	An example is in a unique command line:		An example is in a unique command line:

← Older revision		Revision as of 16:36, 15 November 2013
Line 99:		Line 99:
	* [[Transcode]] - Further information about transcoding with VLC		* [[Transcode]] - Further information about transcoding with VLC
	* [http://www.videolan.org/doc/vlc-user-guide/en/ch04.html VideoLAN documentation site, chapter 4]		* [http://www.videolan.org/doc/vlc-user-guide/en/ch04.html VideoLAN documentation site, chapter 4]

			{{Documentation}}