Examples for advanced use of VLC's stream output
(transcoding, multiple streaming, etc...)
Transcoding
Transcode the input stream and send it to a
multicast IP address with the associated SAP announce:
% vlc -vvv input_stream --sout '#transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128,deinterlace}:
rtp{mux=ts,dst=239.255.12.42,port=5004,sdp=sap://,name="TestStream"}'
Display the input stream, transcode it and send it
to a multicast IP address with the associated SAP announce:
% vlc -vvv input_stream --sout '#duplicate{dst=display,dst=
"transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128,deinterlace}:
rtp{mux=ts,dst=239.255.12.42,port=5004,sdp=sap://,name="TestStream"}"}'
Transcode the input stream, display the transcoded
stream and send it to a multicast IP address with the associated SAP
announce:
% vlc -vvv input_stream --sout '#transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128,deinterlace}:
duplicate{dst=display,dst=rtp{mux=ts,dst=239.255.12.42,port=5004,sdp=sap://,name="TestStream"}}'
Multiple streaming
Send a stream to a multicast IP address and a
unicast IP address:
% vlc -vvv input_stream --sout '#duplicate{dst=
rtp{mux=ts,dst=239.255.12.42,port=5004,sdp=sap://,name="TestStream"},
dst=rtp{mux=ts,dst=192.168.1.2,port=50000}}'
Display the stream and send it to two unicast IP
addresses:
% vlc -vvv input_stream
--sout '#duplicate{dst=display,
dst=rtp{mux=ts,dst=192.168.1.12,port=50002},
dst=rtp{mux=ts,dst=192.168.1.42,port=50004}}'
Send parts of a multiple program input stream:
% vlc -vvv multiple_program_input_stream
--sout '#duplicate{dst=rtp{mux=ts,dst=239.255.12.42,port=5004},select="program=12345",
dst=rtp{mux=ts,dst=239.255.12.43,port=5004}, select="video,program=1234-2345"}'
This command sends the program of the input stream which id is
12345 to 239.255.12.42 and all video programs with id between 1234 and
2345 to 239.255.12.43.
Transcoding and multiple streaming
Transcode the input stream, display the transcoded
stream and send it to a multicast IP address with the associated SAP
announce and an unicast IP address:
% vlc -vvv input_stream --sout '#transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128,deinterlace}:
duplicate{dst=display,dst=rtp{mux=ts,dst=239.255.12.42,sdp=sap://,name="TestStream"},
dst=rtp{mux=ts,dst=192.168.1.2,port=50006}}'
Display the input stream, transcode it and send it
to two unicast IP addresses:
% vlc -vvv input_stream --sout '#duplicate{dst=display,
dst="transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128}:
duplicate{dst=rtp{mux=ts,dst=192.168.1.2,port=50008},
dst=rtp{mux=ts,dst=192.168.1.12,port=50010}"}'
Send the input stream to a multicast IP address
and the transcoded stream to another multicast IP address with the
associated SAP announces:
% vlc -vvv input_stream --sout '#duplicate{dst=
rtp{mux=ts,dst=239.255.1.2,port=5004,sdp=sap://,name="OriginalStream"},
dst="transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128}:
rtp{mux=ts,dst=239.255.1.3,port=5004,sdp=sap://,name="TranscodedStream"}"}'
HTTP streaming
Stream in HTTP:
on the server, run:
% vlc -vvv input_stream --sout '#standard{access=http,mux=ogg,dst=server.example.org:8080}'
on the client(s), run:
% vlc http://server.example.org:8080
Transcode and stream in HTTP:
% vlc -vvv input_stream --sout '#transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128}:
standard{access=http,mux=ogg,dst=server.example.org:8080}'
For example, if you want to stream an audio CD in
Ogg/Vorbis over HTTP:
% vlc -vvv cdda:///dev/cdrom --sout '#transcode{acodec=vorb,ab=128}:
standard{access=http,mux=ogg,dst=server.example.org:8080}'
RTP streaming
Stream in RTP:
on the server, run:
% vlc -vvv input_stream --sout '#rtp{dst=192.168.0.12,port=1234,sdp=rtsp://server.example.org:8080/test.sdp}'
on the client(s), run:
% vlc rtsp://server.example.org:8080/test.sdp
You can remplace the rtsp URL
by a http one, a file path (prefixed with
file://) or sap:// to export
the sdp file using one of these methods instead of rtsp.
RTSP
See
MMS / MMSH streaming to Windows Media Player
% vlc -vvv input_stream --sout '#transcode{vcodec=DIV3,vb=256,scale=1,acodec=mp3,ab=32,channels=2}:std{access=mmsh,mux=asfh,dst=:8080}'
VLC media player can connect to this by using the following url : mmsh://server_ip_address:8080 .
Windows Media Player can connect to this by using the following url : mms://server_ip_address:8080 .
Use the <emphasis>es</emphasis> module
Separate audio and video in two PS files:
% vlc -vvv input_stream --sout
'#es{access=file,mux=ps,url_audio=audio-%c.%m,url_video=video-%c.%m}'
Extract the audio track of the input stream to a TS
file:
% vlc -vvv input_stream --sout '#es{access_audio=file,mux_audio=ts,url_audio=audio-%c.%m}'
Stream in unicast the audio track on a port and the
video track on another port
(NOTE: This will not only work with VLC 0.8.6 or older - FIXME?)
on the server side:
% vlc -vvv input_stream --sout
'#es{access=rtp,mux=ts,url_audio=192.168.1.2:50002,url_video=192.168.1.2:50004}'
on the client side: to receive the audio:
% vlc rtp://@:50002
to receive the video:
% vlc rtp://@:50004
Stream in multicast the video and dump the audio in a file:
% vlc -vvv input_stream --sout '#es{access-video=udp,mux-video=ts,dst-video=239.255.12.42,
access-audio=file,mux-audio=ps,dst-audio=audio-%c.%m}'
You can also combine the es
module with the other modules to set-up even more complex
solution.