Difference between revisions of "Documentation:Streaming HowTo/Receive and Save a Stream"

From VideoLAN Wiki
Jump to navigation Jump to search
 
m (minor copy-edit)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{RightMenu|documentation streaming howto toc}}
 +
 
==Receive a stream with VLC==
 
==Receive a stream with VLC==
  
 
===Receive an unicast stream===
 
===Receive an unicast stream===
  
  % '''vlc -vvv udp:'''
+
  {{%}} '''vlc -vvv rtp://'''
 
 
  
 
===Receive a multicast stream===
 
===Receive a multicast stream===
  
  % '''vlc -vvv udp:@239.255.12.42'''
+
  {{%}} '''vlc -vvv rtp://@239.255.12.42'''
 
where '''239.255.12.42''' is the multicast IP address you want to join.
 
where '''239.255.12.42''' is the multicast IP address you want to join.
  
Line 15: Line 16:
 
Use one of the following command lines:
 
Use one of the following command lines:
  
  % '''vlc -vvv http://example/stream.xyz'''
+
  {{%}} '''vlc -vvv http://example/stream.xyz'''
 
where '''http://example/stream.xyz''' is the HTTP address of the stream;
 
where '''http://example/stream.xyz''' is the HTTP address of the stream;
  
  % '''vlc -vvv ftp://example/stream.xyz'''
+
  {{%}} '''vlc -vvv ftp://example/stream.xyz'''
 
where '''ftp://example/stream.xyz''' is the FTP address of the stream;
 
where '''ftp://example/stream.xyz''' is the FTP address of the stream;
  
  % '''vlc -vvv mms://viptvr.yacast.fr/encoderfranceinfo'''
+
  {{%}} '''vlc -vvv mms://viptvr.yacast.fr/encoderfranceinfo'''
 
where '''mms://viptvr.yacast.fr/encoderfranceinfo''' is the MMS address of the stream.
 
where '''mms://viptvr.yacast.fr/encoderfranceinfo''' is the MMS address of the stream.
  
 
===Receive a RTP stream available through RTSP===
 
===Receive a RTP stream available through RTSP===
  
  % '''vlc -vvv rtsp://www.hardradio.com/tonbeme.mov'''
+
  {{%}} '''vlc -vvv rtsp://www.hardradio.com/tonbeme.mov'''
 
where '''rtsp://www.hardradio.com/tonbeme.mov''' is the address of the stream.
 
where '''rtsp://www.hardradio.com/tonbeme.mov''' is the address of the stream.
  
 
===Receive a stream described by an SDP file===
 
===Receive a stream described by an SDP file===
  
  % '''vlc -vvv http://server.example.org/stream.sdp'''
+
  {{%}} '''vlc -vvv http://server.example.org/stream.sdp'''
  
==Save a stream with VLC==
+
== Save a stream with VLC ==
  
VLC can save the stream to the disk. In order to do this, use the Stream Output of VLC : you can do it via the graphical interface, or you can add to the command line the following argument:
+
VLC can save the stream to the disk. In order to do this, use the Stream Output of VLC: you can do it via the graphical interface (Media [menu] → streaming) or use the [http://www.howtogeek.com/howto/2686/how-to-copy-a-dvd-with-vlc-1.0/ record button], or you can add to the command line the following argument:  
  
 
  '''--sout file/muxer:stream.xyz'''
 
  '''--sout file/muxer:stream.xyz'''
where:
+
 
*'''muxer''' is one of the formats supported by VLC's stream output, i.e. :
+
where:  
**'''ogg''' for OGG format,
+
 
**'''ps''' MPEG2-PS format,
+
*'''muxer''' is one of the formats supported by VLC's stream output, i.e. :  
**'''ts''' for MPEG2-PS format.
+
**'''ogg''' for OGG format,  
* and '''stream.xyz''' is the name of the file you want to save the stream to, with the right extension.
+
**'''ps''' MPEG2-PS format,  
 +
**'''ts''' for MPEG2-TS format.  
 +
*and '''stream.xyz''' is the name of the file you want to save the stream to, with the right extension.
 +
 
 +
For example:
 +
'''vlc your_input_file_or_stream_here --sout=file/ps:go.mpg '''
 +
 
 +
This is short hand for the more verbose
 +
'''vlc your_input_file_or_stream_here --sout="#std{access=file,mux=ps,dst=go.mpg}"
 +
 
 +
NB that you must choose a muxer that supports your stream type. See [[Transcode#Compatibility_issues]]
 +
 
 +
It can also be quite helpful to look at the settings VLC uses when it records using its record button. For example, in the logs you might see something like this:
 +
 
 +
...: Using record output `std{access=file,mux='ps',dst='C:\vlc-record-2010__E-.mpg'}'
 +
 
 +
Which gives you a hint/clue as to how to record your current stream. In this case this would translate into --sout "#std{access=file... on the command line.
  
 
==Receive a stream with a set-top-box==
 
==Receive a stream with a set-top-box==
Line 49: Line 66:
 
Some set-top-boxes with Ethernet cards can receive MPEG2-TS streams over UDP and support multicast.
 
Some set-top-boxes with Ethernet cards can receive MPEG2-TS streams over UDP and support multicast.
  
Set-top-boxes known to work with VLC are :
+
Set-top-boxes known to work with VLC are:
*[http://www.pace.co.uk Pace] set top boxes. (Pace Micro DSL 4000)
+
* [http://www.pace.co.uk Pace] set top boxes. (Pace Micro DSL 4000)
*[http://www.aminocom.com Aminocom] set top boxes. (all the models with mpeg2)
+
* [http://www.aminocom.com Aminocom] set top boxes. (all the models with mpeg2)
*tuxia / gct-allwell (mpeg4 and mpeg2) sigma designs8174 chipset
+
* tuxia / gct-allwell (mpeg4 and mpeg2) sigma designs8174 chipset
*i3micro mood200 (mpeg4 and mpeg2 in transport streams)
+
* i3micro mood200 (mpeg4 and mpeg2 in transport streams)
 
+
* ps3 media server streams using VLC (or mencoder) to the PS3
  
 
{{Documentation}}
 
{{Documentation}}

Latest revision as of 23:46, 9 November 2014

VLC Streaming HowTo

Introduction
Streaming, Muxers and Codecs

Main
Easy Streaming
Advanced Streaming Using the Command Line
Command Line Examples

VLM
VLM - Multiple Streaming and Video on Demand

Tutorials and examples
Receive and Save a Stream
Convert files to other formats
Stream a File
Stream a DVD
Stream a DVB Channel
Stream from Encoding Cards and Other Capture Devices
Stream from a DV Camcorder
Streaming for the iPhone

IPv6
Streaming over IPv6
View this alone

Receive a stream with VLC

Receive an unicast stream

% vlc -vvv rtp://

Receive a multicast stream

% vlc -vvv rtp://@239.255.12.42

where 239.255.12.42 is the multicast IP address you want to join.

Receive an HTTP/FTP/MMS stream

Use one of the following command lines:

% vlc -vvv http://example/stream.xyz

where http://example/stream.xyz is the HTTP address of the stream;

% vlc -vvv ftp://example/stream.xyz

where ftp://example/stream.xyz is the FTP address of the stream;

% vlc -vvv mms://viptvr.yacast.fr/encoderfranceinfo

where mms://viptvr.yacast.fr/encoderfranceinfo is the MMS address of the stream.

Receive a RTP stream available through RTSP

% vlc -vvv rtsp://www.hardradio.com/tonbeme.mov

where rtsp://www.hardradio.com/tonbeme.mov is the address of the stream.

Receive a stream described by an SDP file

% vlc -vvv http://server.example.org/stream.sdp

Save a stream with VLC

VLC can save the stream to the disk. In order to do this, use the Stream Output of VLC: you can do it via the graphical interface (Media [menu] → streaming) or use the record button, or you can add to the command line the following argument:

--sout file/muxer:stream.xyz

where:

  • muxer is one of the formats supported by VLC's stream output, i.e. :
    • ogg for OGG format,
    • ps MPEG2-PS format,
    • ts for MPEG2-TS format.
  • and stream.xyz is the name of the file you want to save the stream to, with the right extension.

For example:

vlc your_input_file_or_stream_here --sout=file/ps:go.mpg 

This is short hand for the more verbose

vlc your_input_file_or_stream_here --sout="#std{access=file,mux=ps,dst=go.mpg}" 

NB that you must choose a muxer that supports your stream type. See Transcode#Compatibility_issues

It can also be quite helpful to look at the settings VLC uses when it records using its record button. For example, in the logs you might see something like this:

...: Using record output `std{access=file,mux='ps',dst='C:\vlc-record-2010__E-.mpg'}'

Which gives you a hint/clue as to how to record your current stream. In this case this would translate into --sout "#std{access=file... on the command line.

Receive a stream with a set-top-box

Some set-top-boxes with Ethernet cards can receive MPEG2-TS streams over UDP and support multicast.

Set-top-boxes known to work with VLC are:

  • Pace set top boxes. (Pace Micro DSL 4000)
  • Aminocom set top boxes. (all the models with mpeg2)
  • tuxia / gct-allwell (mpeg4 and mpeg2) sigma designs8174 chipset
  • i3micro mood200 (mpeg4 and mpeg2 in transport streams)
  • ps3 media server streams using VLC (or mencoder) to the PS3
This page is part of official VLC media player Documentation (User GuideStreaming HowToHacker GuideModules)
Please read the Documentation Editing Guidelines before you edit the documentation
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.