xine(5) - f7

1XINE(5)                       File Formats Manual                      XINE(5)
2
3
4

NAME

6       xine - a free video player
7

MRL (media resource locator)

9       MRLs  are  similar to URLs in your web browser. They describe the media
10       to read from. Valid MRLs may be plain file names or one of the  follow‐
11       ing (see also the notes below):
12
13       · Filesystem:
14              file:<path>
15              fifo:<path>
16              stdin:/
17
18       · CD and DVD:
19              dvd:/[<device_name>][/<title>.<part>]
20              dvd:/<DVD_image_file_or_directory>[/<title>.<part>]
21              vcd://[<CD_image>|<device_name>][@[letter]<number>]
22              vcdo://<track_number>
23              cdda:/[<device>][/<track-number>]
24
25       · Video devices:
26              v4l://[<tuner_device>/<frequency>]
27              dvb://<number_or_channel_name>
28              dvbc://<channel_name>:<tuning_parameters>
29              dvbs://<channel_name>:<tuning_parameters>
30              dvbt://<channel_name>:<tuning_parameters>
31              dvba://<channel_name>:<tuning_parameters>
32              pvr:/<tmp_files_path>!<saved_files_path>!<max_page_age>     (for
33              WinTV PVR 250 and 350)
34
35       · Network:
36              http://<host>...
37              tcp://<host>[:<port>] (default port is 7658)
38              udp://<host>[:<port>[?iface=<interface>]] (default port is 7658)
39              rtp://<host>[:<port>[?iface=<interface>]] (default port is 7658)
40              smb://...
41              mms://<host>...
42              pnm://<host>...
43              rtsp://<host>... (requires Real codecs)
44
45       Additional input plugins will provide additional MRL  types.  The  ones
46       listed above are available with stock libxine.
47
48       NOTE:  where  a file name is required, the full path must be provided -
49       from a shell, you can use "$PWD/file" or "$(pwd)/file" or  "`pwd`/file"
50       if  the  file  is  in the current directory. (Which one depends on your
51       shell; all three work in bash.)
52
53       As of xine-lib 1.1.3, the DVD title number may be 0 (select navigation)
54       and the chapter number may be 0 (full title).
55
56
57   VCD MRL Syntax
58       A  simple vcd:/ runs the default item (e.g. perhaps track 1 or entry 0)
59       using the default VCD device (perhaps  /dev/cdrom).  Both  the  default
60       item and default device are user-configurable.
61
62       It  is  however  also possible to specify both Video CD device/filename
63       and item explicitly in the MRL.
64
65       For example vcd:/dev/dvd  specifies  the  default  entry  using  device
66       /dev/dvd which might useful if this is your DVD which is different than
67       your  CD-ROM  device  and  your  DVD   drive   can   play   CD's.   And
68       vcd://test_svcd_ntsc.cue  specifies  the cue file for CD image on disk.
69       (test_svcd_ntsc.bin is the corresponding bin file, but using that won't
70       work.)
71
72       After  the  optional device name or file name, you can name the kind of
73       unit, preceded by a colon. An MRL which ends in a  colon  is  like  not
74       adding it at all: the default entry type and number is used. Items come
75       in 4 flavours: "Track", "Entry", "Playback" and "Segment". These  units
76       are  indicated  with the capital first letter of each type: T, E, P, S,
77       s. An uppercase S in the MRL display indicates a NTSC segment  while  a
78       lowercase  s  indicates a PAL segment.  However, when you enter an MRL,
79       the case of these letters is insignificant.
80
81       Depending on the Video CD, you might not  have  any  playable  segments
82       (S,s)  or  playback  control  (P).   If you give a MRL that refers to a
83       playback control entry but there is no playback control, your  playback
84       number will silently be converted into the corresponding entry number.
85
86       You  can  configure  various  things that affect MRLs are selected when
87       there is some ambiguity in the MRL name. media.vcd.autoplay  sets  what
88       kind  of  unit to to use in a MRL is none is given.  Another configura‐
89       tion setting, vcd.device, determines what device to use if that part is
90       not given.  When you hit the VCD button, that is equivalent to entering
91       vcd:/ and thus these two configuration settings are used to expand  the
92       MRL.
93
94       Some  examples  of MRLs are given below. In the examples, we assume the
95       following configuration settings:
96
97
98       vcd:// Play (navigate) default item (in this case Entry ID 0) from  the
99              default device (in this case set to /dev/cdrom)
100
101       vcd://@
102              Same as above
103
104       vcd:///dev/cdrom@
105              Same  effect  as  above  since  the  default  device  is  set to
106              /dev/cdrom.
107
108       vcd:///dev/cdrom@E0
109              Same as above. But note that  this  is  because  we  have  auto‐
110              play:entry which is no longer the default value.
111
112       vcd:///dev/cdrom2@
113              Play (navigate) the default item of /dev/cdrom2
114
115       vcd:///dev/cdrom2
116              should be same as above but is currently broken?
117
118       vcd:///dev/cdrom2@T1
119              Play Track 1 from /dev/cdrom2
120
121       vcd:///dev/cdrom@S1
122              Play  segment  1 from /dev/cdrom. This assumes that there *is* a
123              segment 1.  Check the MRL list to see if that is the case.
124
125       vcd://@P1
126              Play playlist item 1 from default device. If there is  no  play‐
127              back  control,  the  MRL will be converted into vcd:/@E0.  Again
128              check the MRL list to see if there is a P1.
129
130       vcd://@P1*
131              Probably same as above.
132
133       vcd:///dev/cdrom@E1
134              Play Entry id 1 from default device.
135
136       vcd://@S0
137              Play segment 0 from default device.
138
139       vcd://@3
140              Play track 3 from default device.
141
142       vcd:///dev/cdrom2:1
143              Play track 1 from /dev/cdrom2.
144
145       vcd:///tmp/ntsc.cue@
146              Play default item (E0) of /tmp/ntsc.bin. Note trailing @.
147
148       vcd://ntsc.cue/@E0
149              Play entry 0 of ntsc.bin.
150
151       vcd:///tmp/ntsc.nrg/@E0
152              Play entry 0 of /tmp/ntsc.nrg (Nero file). Works for some simple
153              Nero images.
154
155   DVB
156       DVB  MRLs  require that ~/.xine/channels.conf exists and contains valid
157       data.  This can be obtained by generating a tuning file using the  Lin‐
158       uxTV  DVB  apps  utility "scan" (or "dvbscan" if you're using a version
159       newer than 1.1.0):
160
161       scan -o zap  /usr/share/doc/dvb-utils/examples/scan/dvb-t/uk-PontopPike
162       >~/.config/xine-lib/channels.conf
163
164       (This  example is for the writer's local transmitter, using a file from
165       the Debian dvb-utils package.)
166
167       For the dvbc, dvbs and dvbt MRLs, tuning parameters are expected,  tak‐
168       ing one of the following forms:
169
170       DVB-S  <frequency>:<polarisation>:<sat-no>:<sym-
171              rate>:<vpid>:<apid>:<service-id>
172
173       DVB-C  <frequency>:<inversion>:<sym-
174              rate>:<fec>:<qam>:<vpid>:<apid>:<service-id>
175
176       DVB-T  <frequency>:<inversion>:<bw>:<fec-hp>:<fec-lp>:<qam>:<transmis‐
177              sion-mode>:<guardlist>:<hierarchy-info>:<vpid>:<apid>:<service-
178              id>
179
180       DVB-A  <frequency>:<qam>:<vpid>:<apid>:<service-id>
181
182       The individual parameters are:
183
184       frequency           number, usually in kHz
185
186       polarisation        `v' or `h'
187
188       sat-no              unsigned long, usually 0
189
190       sym-rate            symbol rate in MSyms/sec
191
192       inversion           INVERSION_ON, INVERSION_OFF, INVERSION_AUTO
193
194       fec, fec-hp, fec-lp FEC_1_2,  FEC_2_3,  FEC_3_4  ... FEC_8_9, FEC_AUTO,
195                           FEC_NONE
196
197       qam                 QPSK, QAM_128, QAM_16 ...
198
199       bw                  BANDWIDTH_6_MHZ, BANDWIDTH_7_MHZ, BANDWIDTH_8_MHZ
200
201       transmission-mode   TRANSMISSION_MODE_2K, TRANSMISSION_MODE_8K
202
203       guardlist           GUARD_INTERVAL_1_4,             GUARD_INTERVAL_1_8,
204                           GUARD_INTERVAL_1_16, GUARD_INTERVAL_1_32,
205
206       hierarchy-info      HIERARCHY_1,   HIERARCHY_2,   HIERARCHY_4,  HIERAR‐
207                           CHY_NONE
208
209       vpid                video program ID
210
211       apid                audio program ID
212
213       service-id          service ID (needed for now/next information etc.)
214
215       The following keyboard & mouse inputs may be accepted:
216
217       Menu 2                  Start/stop recording
218
219       Menu 3                  Toggle zoom
220
221       Menu 7                  Toggle now/next display
222
223       Previous/Next Chapter   Previous/next channel
224
225       Mouse wheel & button 1  Scroll through channel list & select the  high‐
226                               lighted channel
227

SUBTITLE

229       external subtitle files (any mrl)
230       Text subtitle files may be appended to the MRL:.
231
232       <mrl>#subtitle:<subtitlefile>
233              This  is  the normal way to define the subtitle file to use. The
234              frontend will not take any notice  of  the  subtitle  file.  For
235              example:
236              file://home/user/wibble.mpg#subtitle:/home/user/wibble.sub
237              (Note  that some front ends can detect subtitles files where the
238              name differs as shown in the example.)
239

STREAM OPTIONS

241       After a delimiting # you can add several stream parameters:
242
243       novideo
244              Video will be ignored.
245
246       noaudio
247              Audio will be ignored.
248
249       nospu  Subpictures will be ignored.
250
251       demux:<demux name>
252              Specify the demux plugin to use.
253
254       volume:<level>
255              Set audio volume.
256
257       compression:<level>
258              Set audio dynamic range compression.
259
260       <config entry>:<config value>
261              Assign a new value to any config entry.
262
263       save:<file>
264              Save the stream (if allowed) to the named file, relative to  the
265              directory given by the option "media.capture.save_dir".
266
267       change configuration option 'on the fly':
268              You  can  change  a  configuration option at any time, using the
269              special cfg:/ MRL style. The syntax is:
270                   cfg:/<config entry> : <config value>
271              Unlike stream config option,  you  can  change  anything  before
272              playing the stream.
273
274

AUTHOR

282       This text  was  extracted  from  the  xine  man  page  by  Darren  Salt
283       <dsalt@users.sourceforge.net>.   The xine man page was written by Siggi
284       Langauf <siggi@debian.org> for the xine project.  Lots of additions  by
285       Guenter  Bartsch  <guenter@users.sourceforge.net>, Daniel Caujolle-Bert
286       <f1rmb@users.sourceforge.net>, Rocky Bernstein  <rocky@panix.com>,  and
287       Philipp Hahn <pmhahn@users.sourceforge.net>.
288
289
290
291The xine project                  2005-06-15                           XINE(5)

NAME

MRL (media resource locator)

SUBTITLE

STREAM OPTIONS

SEE ALSO

AUTHOR