Difference between revisions of "Media resource locator"

From VideoLAN Wiki
Jump to navigation Jump to search
(initial version)
 
m (Add wikilinks)
 
(8 intermediate revisions by 5 users not shown)
Line 2: Line 2:
  
 
The MRL syntax is:
 
The MRL syntax is:
<PRE>
+
 
[[access][/demux]://]URL[@[title][:chapter][-[title][:chapter]]] [:option=value ...]
+
[[access][/demux]://]URL[#[title][:chapter][-[title][:chapter]]] [:option=value ...]
</PRE>
+
 
 +
(in earlier versions of VLC, the delimiter before the optional title and chapter was '@', not '#'.)
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 17: Line 18:
 
dir: Filesystem-based directory<BR>
 
dir: Filesystem-based directory<BR>
 
dv: Digital Video/FireWire<BR>
 
dv: Digital Video/FireWire<BR>
 +
dvd: DVD<BR>
 
file: Filesystem-based file<BR>
 
file: Filesystem-based file<BR>
 
ftp: FTP<BR>
 
ftp: FTP<BR>
Line 25: Line 27:
 
rtp: RTP<BR>
 
rtp: RTP<BR>
 
rtsp: RTSP<BR>
 
rtsp: RTSP<BR>
 +
simpledvd: simple interface to DVD-Video, bypassing menus (?)<BR>
 
smb: Server Message Block<BR>
 
smb: Server Message Block<BR>
 
tcp: TCP<BR>
 
tcp: TCP<BR>
 
udp: UDP<BR>
 
udp: UDP<BR>
vcdx: Video CD
+
vcdx: Video CD<BR>
 +
vlc: commands to VLC itself, e.g. vlc://pause''seconds'' and vlc://quit
 
|-
 
|-
 
| demux
 
| demux
Line 91: Line 95:
 
| See [[VLC command-line help]] for a full list
 
| See [[VLC command-line help]] for a full list
 
|}
 
|}
 +
 +
== Exception ==
 +
An exception to these rules appears to be with [[UDP]]/[[RTP]] streams, where it may look like:
 +
 +
udp://@:portnumber
 +
# Example:
 +
#  udp://@:1234
 +
#
 +
# Apparently the @ has a meaning like localhost, though
 +
#  udp://localhost:1234
 +
# doesn't seem to work in this circumstance, for some reason.
 +
 +
[[Category:Glossary]]

Latest revision as of 09:13, 24 January 2019

A media resource locator (MRL) is a string of characters used to identify a multimedia resource or part of a multimedia resource. A MRL may be used to identify inputs or outputs to VLC media player.

The MRL syntax is:

[[access][/demux]://]URL[#[title][:chapter][-[title][:chapter]]] [:option=value ...]

(in earlier versions of VLC, the delimiter before the optional title and chapter was '@', not '#'.)

MRL section Description Possible values
access How to obtain the media data

cdda: CD Digital Audio
dir: Filesystem-based directory
dv: Digital Video/FireWire
dvd: DVD
file: Filesystem-based file
ftp: FTP
gnomevfs: GnomeVFS
http: HTTP
mms: Microsoft Media Server
pvr: PVR
rtp: RTP
rtsp: RTSP
simpledvd: simple interface to DVD-Video, bypassing menus (?)
smb: Server Message Block
tcp: TCP
udp: UDP
vcdx: Video CD
vlc: commands to VLC itself, e.g. vlc://pauseseconds and vlc://quit

demux The format of the source data

a52sys/Raw A/52 demuxer
aiff/AIFF demuxer
asf/ASF v1.0 demuxer
au/AU demuxer
avi/AVI demuxer
demuxdump/File dumpper
dtssys/Raw DTS demuxer
flac/FLAC demuxer
h264/H264 video demuxer
m3u/Playlist metademux
m4a/MPEG-4 audio demuxer
m4v/MPEG-4 video demuxer
mjpeg/M-JPEG camera demuxer
mp4/MP4 stream demuxer
mpga/MPEG audio / MP3 demuxer
mpgv/MPEG-I/II video demuxer
nsc/Windows Media NSC metademux
nsv/NullSoft demuxer
nuv/Nuv demuxer
ogg/OGG demuxer
playlist/B4S playlist import
playlist/DVB playlist import
playlist/M3U playlist import
playlist/New winamp 5.2 shoutcast import
playlist/PLS playlist import
playlist/Playlist
playlist/Podcast parser
playlist/XSPF playlist import
ps/MPEG-PS demuxer
ps/MPEG-PS demuxer
pva/PVA demuxer
rawdv/DV (Digital Video) demuxer
real/Real demuxer
sgimb/Kasenna MediaBase parser
subtitle/Text subtitles parser
tta/TTA demuxer
ty/TY Stream audio/video demux
vobsub/Vobsub subtitles parser
voc/VOC demuxer
wav/WAV demuxer
xa/XA demuxer

URL The URI of the source See http://www.w3.org/TR/uri-clarification/
title Which title to select for input Positive integer
chapter Which chapter to select for input Positive integer
option Options to apply only to the specified MRL See VLC command-line help for a full list

Exception

An exception to these rules appears to be with UDP/RTP streams, where it may look like:

udp://@:portnumber
# Example: 
#   udp://@:1234
#
# Apparently the @ has a meaning like localhost, though
#   udp://localhost:1234
# doesn't seem to work in this circumstance, for some reason.