1XINE(1) General Commands Manual XINE(1)
2
6 xine - a free video player
7
9 xine [options] [MRL] ...
10
12 This manual page documents briefly the xine audio/video player.
13 xine plays MPEG system (audio and video) streams, mpeg elementary
15 streams (e.g. .mp3 or .mpv files), mpeg transport streams, ogg files,
16 avi files, asf files, quicktime files, (S)VCDs and DVDs and many more.
17
19 The programs follow the usual GNU command line syntax, with long op‐
20 tions starting with two dashes (`--'). A summary of options are in‐
21 cluded below. For a complete description, see README and FAQ in
22 /usr/share/doc/xine-ui-0.99.14 or on the xine home page.
23 -h, --help
25 Show summary of options and available output drivers (plugins).
26 --verbose[=level]
28 Set verbose level.
29 -c, --config <file>
31 Use config file instead of default one.
32 -a, --audio-channel <num>
34 Select the given audio channel. <num> is the audio channel num‐
35 ber, default is 0.
36 xine 0.5 and newer tries its best to collect all valid audio
37 channels (ac3, mpeg audio, avi audio, ...) from the stream and
38 maps them to "virtual channels" with channel numbers starting at
39 0.
40 -V, --video-driver <drv>
42 Select video driver. Check out xine --help for a list of avail‐
43 able video output plugins on your system. This selection is
44 stored automatically in your ~/.xine/config so you'll have to
45 specify the video driver only once.
46 -A, --audio-driver <drv>
48 Select audio driver. Check out xine --help for a list of avail‐
49 able audio output plugins on your system. This selection is
50 stored automatically in your ~/.xine/config so you'll have to
51 specify the audio driver only once.
52 -u, --spu-channel <num>
54 Select subpicture (subtitle) channel. <num> is the subpicture
55 channel id, default is no subtitle (-1).
56 -p, --auto-play=[f][F][h][w][q][d][v]
58 Start playing immediately after start. Can be followed by:
59 `f' in fullscreen mode,
60 `F' in xinerama fullscreen mode,
61 `h' hide GUI (main panel, etc...),
62 `w' hide video output window,
63 `q' for quitting after playback,
64 It is also possible to request the playlist from DVD `d', or VCD
65 `v'. There is now a more generic option, --auto-scan, for that
66 (see below).
67 -s, --auto-scan <plugin>
69 Auto-scan playlist from named input plugin. Many plugins allow
70 one to read a default playlist, in order to play everything.
71 This works fine for DVDs or VCDs, for example. Giving this op‐
72 tion has the same effect as pressing the according button on
73 xine's main panel.
74 This option is especially useful in combination with auto-play.
76 You could start xine --auto-play --auto-scan dvd in order to
77 play a whole DVD without having to press any additional buttons.
78 This also works for plugins that are not supplied with xine,
79 just give the name of the button that the desired plugin adds to
80 the xine panel!
81 -f, --fullscreen
83 Switch xine to fullscreen mode on start (just like pressing `f')
84 -F, --xineramafull
86 Switch xine to xinerama fullscreen mode on start (just like
87 pressing `F'). That is to say, try to expand display on several
88 screens. Screens to use are defined in config file.
89 -g, --hide-gui
91 Hide all GUI windows (except the video window) on start. This is
92 the same as pressing `G' within xine.
93 -H, --hide-video
95 Hide video output window.
96 -L, --no-lirc
98 Turn off LIRC support. This option is only available if xine has
99 been compiled with LIRC support.
100 --visual <visual-class-or-id>
102 Try to use a specific X11 server visual for xine windows. The
103 <visual-class-or-id> parameter is either the name of an X11 vis‐
104 ual class (StaticGray, GrayScale, StaticColor, PseudoColor,
105 TrueColor or DirectColor) or the hexadecimal value for a spe‐
106 cific X11 visual.
107 When used with a visual class name, xine tries to find such a
109 visual with depth 15 or 16, 24, 32 or 8 (in that order). The
110 default visual class used by xine in absence of a --visual op‐
111 tion is TrueColor.
112 If no usable visual is found, xine falls back to the default
114 visual used on the X11 server's root window.
115 --install
117 When using an X11 visual with changeable colors (colormaps), in‐
118 stall a private colormap for xine. With a private colormap, xine
119 can allocate more colors so that video output may look better.
120 --keymap [=option]
122 Display keymap. Option are:
123 `default' display default keymap table,
124 `lirc' display draft of a ~/.lircrc config file,
125 `remapped' user remapped keymap table,
126 `file:<file>' use file as keymap table,
127 If no option is given, `default' is selected.
128 -n, --network
130 Enable network remote control server. To use network remote
131 control server, a password file is required. If xine cannot
132 find it, the server is stopped. The syntax of the password file
133 follows the (familiar) scheme <identification>:<password>. Since
134 cryptography is subject to legal issues in some countries, the
135 password is not encrypted and also transmitted unencrypted, so
136 take care with remote connections. Two (optional) generic rules
137 are available as well (one at a time)
138 ALL:ALLOW or ALL:DENY
139 In the first case, all clients are allowed to execute all avail‐
140 able commands, without restriction. In the second case, no-one
141 is allowed to execute any commands, except identified users (us‐
142 ing 'identify' command).
143 If a password entry begins with an asterisk `*', the user is
145 blocked. If a password entry is empty, the full entry is ig‐
146 nored. Here is an example of a small ~/.xine/passwd file:
147 ALL:DENY
149 daniel:mypasswd
150 foo:*
151 This will allow only 'daniel' to execute commands, after a suc‐
153 cessfully identifying stage.
154 The default port of the server is 6789, this number is totally
156 arbitrary. You can connect the server using a simple telnet com‐
157 mand:
158 telnet localhost 6789
159 To change the default port, you can (as root) edit your
160 /etc/services, and add an entry like this:
161 xinectl 7890/tcp # xine control
163 This will change the default port from 6789 to 7890, and create
165 a "human" service called xinectl.
166 The server itself offers command help/syntax:
168 help [command]
169 Without command specified, all available commands will be dis‐
170 played. If a command is specified, short text about the command
171 functionality will be given.
172 syntax <command>
173 Display the command syntax.
174 -R, --root
176 Use root window as video window.
177 -G, --geometry <WxH[+X+Y]>
179 You can set video output size and position using the X like ge‐
180 ometry (see X(7)). X and Y offset are optional.
181 -B, --borderless
183 Remove borders of video output window, in windowed mode.
184 -N, --animation <mrl>
186 Specify one or more mrl to play with audio only streams.
187 -P, --playlist <filename>
189 Use file as playlist. Known formats are: asx, toxine, m3u, pls,
190 sfv and raw text file.
191 -l, --loop [=mode]
193 Set playlist loop mode. If mode isn't specified, mode loop is
194 used. Possible modes are:
195 loop: loop entire playlist.
196 repeat: repeat current playlist entry.
197 shuffle: select randomly an entry in playlist from those not yet
198 played.
199 shuffle+: same as shuffle, but indefinitely replay the playlist.
200 --skin-server-url <url>
202 Define the skin server url.
203 --enqueue <mrl>...
205 Enqueue one or more mrl in a running session (session 0).
206 If you want to specify another session, use -S session=x option.
207 -S, --session <option1,option2,...>
209 Session managements. All options can be used more than one time,
210 except session.
211 Options are:
212 session=n specify session <n> number,
213 mrl=m add mrl <m> to the playlist,
214 audio=c select audio channel (<c>: next or prev),
215 spu=c select spu channel (<c>: next or prev),
216 volume=v set audio volume (<v>: 0 to 100),
217 amp=v set audio amplification of instance (<v>: 0 to 200),
218 loop=m set loop mode (<m>: none loop repeat shuffle or shuf‐
219 fle+),
220 get_speed get current speed status. Return values are:
221 - 1: error
222 - 2: stop
223 - 3: play
224 - 4: pause
225 - 5: slow4
226 - 6: slow2
227 - 7: fast2
228 - 8: fast4
229 get_time[=p|pos] get current position status in seconds, or in
230 position in stream (0..65535).
231 (playlist|pl)=p
232 <p> can be:
233 clear: clear the playlist,
234 first: play first entry in the playlist,
235 prev: play previous playlist entry,
236 next: play next playlist entry,
237 last: play last entry in the playlist,
238 load:s: load playlist file <s>,
239 stop: stop playback at the end of the current playback,
240 cont: continue playback at the end of current playback.
241 There are also some self explanatory options.
242 play, slow2, slow4, pause, fast2, fast4, stop, quit,
243 fullscreen, eject.
244 -Z Don't automatically start playback, affect only auto-start when
246 smart mode is used.
247 -D, --deinterlace [post[:..][;]]
249 Deinterlace video output. You can override configuration option
250 of post(s) used to deinterlace the output picture. See --post
251 for syntax.
252 -r, --aspect-ratio <mode>
254 Set aspect ratio of video output. <mode> can be: auto, square,
255 4:3, anamorphic, dvb.
256 --broadcast-port <port>
258 Set port of xine broadcaster (master side), slave is started
259 with 'xine slave://address:port'
260 --no-logo
262 Don't display the logo.
263 -E, --no-reload
265 Don't reload old playlist. Playlist is saved when you leave
266 xine, then it is reloaded and played the next time you lanch
267 xine. This feature can be disabled via setup window.
268 --post <plugin>[:parameter=value][,...][;...]
270 Load one or more post plugin(s). Parameters are comma separated.
271 This option can be used more than one time to chain two or more
272 video postprocess plugins. You can specify two or more plugin,
273 which may be separated by a semi-colon ';'.
274 --disable-post
276 Don't enable post plugin(s). This way, you can specify one more
277 plugin to use, using the --post command line option, but don't
278 enable those effects.
279 --no-splash
281 Don't display the splash screen.
282 --stdctl
284 Turn on controlling xine over STDIN.
285 -T, --tvout<backend>
287 Turn on TVout support. <backend> can be: nvtv, ati.
288 --list-plugins[=type]
290 Display the list of available plugins. Optional <type> can be:
291 audio_out, video_out, demux, input, sub, post, audio_decoder,
292 video_decoder
293 --bug-report[=mrl]
295 Enable bug report mode. This turns verbosity on, gathers all
296 output messages and writes them to a file named BUG-REPORT.TXT.
297 If <mrl> is given, xine will play that mrl then quit (like -pq
298 does).
299 If you don't specify any MRL, you'll have to select a file by drag and
301 drop. Dragging files from the GNOME Midnight Commander (gmc), Nautilus
302 or Konqueror is known to work.
303
305 MRLs are similar to URLs in your web browser. They describe the media
306 to read from. xine(5) describes them in some detail. xine extends the
307 syntax as follows:
308 <mrl>::<subtitlefile>
310 This is the xine-ui specific way to define the subtitle file to
311 use. The filename will be extracted by the frontend, that permit
312 one to change it, save it in a playlist, etc...
313
315 After a delimiting # you can add several stream parameters:
316 novideo
318 video will be ignored
319 noaudio
321 audio will be ignored
322 nospu subpictures will be ignored
324 demux:<demux name>
326 specify the demux plugin to use
327 volume:<level>
329 set audio volume
330 compression:<level>
332 set audio dynamic range compression
333 <config entry>:<config value>
335 assign a new value to any config entry
336 change configuration option 'on the fly':
338 You can change a configuration option at anytime, using the spe‐
339 cial cfg:/ mrl style. The syntax is:
340 cfg:/<config entry> : <config value>
341 Unlike stream config option, you can change anything before
342 playing the stream.
343
345 Many features can be controlled by pressing control keys. `M-' is the
346 Meta key (`Alt' key on PC keyboard), `C-' is the Control `CTRL' key,
347 other special keys are delimited by `<' and `>' characters, e.g. the
348 `HOME' key is displayed as <home>. The default key bindings are:
349 <Return>
351 Start playback
352 <space>
354 Playback pause toggle
355 S Stop playback
357 t Take a snapshot
359 e Eject the current medium
361 <Next> Select and play next MRL in the playlist
363 <Prior>
365 Select and play previous MRL in the playlist
366 l Loop mode toggle
368 C-s Scan playlist to grab stream infos
370 C-a Add a mediamark from current playback
372 C-e Edit selected mediamark
374 <Left> Set position to -60 seconds in current stream
376 <Right>
378 Set position to +60 seconds in current stream
379 M-<Left>
381 Set position to -30 seconds in current stream
382 M-<Right>
384 Set position to +30 seconds in current stream
385 C-<Left>
387 Set position to -15 seconds in current stream
388 C-<Right>
390 Set position to +15 seconds in current stream
391 M3-<Left>
393 Set position to -7 seconds in current stream
394 M3-<Right>
396 Set position to +7 seconds in current stream
397 C-0 Set position to beginning of current stream
399 C-1 Set position to 10% of current stream
401 C-2 Set position to 20% of current stream
403 C-3 Set position to 30% of current stream
405 C-4 Set position to 40% of current stream
407 C-5 Set position to 50% of current stream
409 C-6 Set position to 60% of current stream
411 C-7 Set position to 70% of current stream
413 C-8 Set position to 80% of current stream
415 C-9 Set position to 90% of current stream
417 <Up> Increment playback speed
419 <Down> Decrement playback speed
421 M-<Down>
423 Reset playback speed
424 V Increment audio volume
426 v Decrement audio volume
428 C-V Increment amplification level
430 C-v Decrement amplification level
432 C-A Reset amplification to default value
434 C-m Audio muting toggle
436 <plus> Select next audio channel
438 <minus>
440 Select previous audio channel
441 <period>
443 Select next sub picture (subtitle) channel
444 <comma>
446 Select previous sub picture (subtitle) channel
447 i Interlaced mode toggle
449 a Cycle aspect ratio values
451 <less> Reduce the output window size by factor 1.2
453 <greater>
455 Enlarge the output window size by factor 1.2
456 M-1 Set video output window to 50%
458 M-2 Set video output window to 100%
460 M-3 Set video output window to 200%
462 z Zoom in
464 Z Zoom out
466 C-z Zoom in horizontally
468 C-Z Zoom out horizontally
470 M-z Zoom in vertically
472 M-Z Zoom out vertically
474 C-M-z Reset zooming
476 s Resize output window to stream size
478 f Fullscreen toggle
480 F Xinerama fullscreen toggle
482 b Video window borders appearance toggle
484 <Escape>
486 Jump to media Menu
487 <F1> Jump to Title Menu
489 <F2> Jump to Root Menu
491 <F3> Jump to Subpicture Menu
493 <F4> Jump to Audio Menu
495 <F5> Jump to Angle Menu
497 <F6> Jump to Part Menu
499 <Keypad Up>
501 Menu navigate up
502 <Keypad Down>
504 Menu navigate down
505 <Keypad Left>
507 Menu navigate left
508 <Keypad Right>
510 Menu navigate right
511 <Keypad Enter>
513 Menu select
514 <Keypad Next>
516 Jump to next chapter
517 <Keypad Prior>
519 Jump to previous chapter
520 <Keypad Home>
522 Select next angle
523 <Keypad End>
525 Select previous angle
526 M-h Visibility toggle of help window
528 M-P Visibility toggle of video post effect window
530 C-M-P Toggle post effect usage
532 h Visibility toggle of output window
534 g Visibility toggle of UI windows
536 M-c Visibility toggle of control window
538 M-m Visibility toggle of mrl browser window
540 M-p Visibility toggle of playlist editor window
542 M-s Visibility toggle of the setup window
544 M-e Visibility toggle of the event sender window
546 M-t Visibility toggle of analog TV window
548 M-l Visibility toggle of log viewer
550 M-i Visibility toggle of stream info window
552 C-i Display stream information using OSD
554 M-k Enter key binding editor
556 C-o Open file selector
558 C-S Select a subtitle file
560 C-d Download a skin from the skin server
562 C-t Display MRL/Ident toggle
564 <Insert>
566 Grab pointer toggle
567 0 Enter the number 0
569 1 Enter the number 1
571 2 Enter the number 2
573 3 Enter the number 3
575 4 Enter the number 4
577 5 Enter the number 5
579 6 Enter the number 6
581 7 Enter the number 7
583 8 Enter the number 8
585 9 Enter the number 9
587 M3-<plus>
589 Add 10 to the next entered number
590 <slash>
592 Set position in current stream to numeric percentage See the
593 section on "Numeric Input" below.
594 M-<Up> Set position forward by numeric argument in current stream
596 M3-<Up>
598 Set position back by numeric argument in current stream
599 m Change audio video syncing (delay video)
601 n Change audio video syncing (delay audio)
603 <Home> Reset audio video syncing offset
605 M Change subtitle syncing (delay video)
607 N Change subtitle syncing (delay subtitles)
609 C-M-o Toggle TV modes (on the DXR3)
611 d Switch Monitor to DPMS standby mode
613 C-l Stop playback after played stream
615 q Quit the program
617 Third party plugins
619 Following shortcuts are used by third party plugins, generally for DVD
620 navigation:
621 <KeyPad Up>
623 Up event.
624 <KeyPad Down>
626 Down event.
627 <KeyPad Left>
629 Left event.
630 <KeyPad Right>
632 Right event.
633 <KeyPad Prior>
635 Prior event.
636 <KeyPad Next>
638 Next event.
639 <KeyPad End>
641 Previous angle event.
642 <KeyPad Home>
644 Next angle event.
645 <KeyPad Enter>
647 Select event
648 Synchronization fine tuning
651 Some streams have bad timestamps, so synchronization fails. This can be
652 tweaked using these keys:
653 n press if video lags behind audio
655 m press if video runs ahead of audio
657 <home> press to reset audio/video offset to 0, so stream timestamps are
659 unchanged.
660 Subtitle synchronization
663 You can adjust subtitle synchronization by using these keys:
664 M / N
666 Numeric Input
669 You can specify a numeric argument to be applied to a command typing in
670 a number and then entering a function key. For example entering "99/",
671 that is, the number-9 key twice and then the slash key, you should seek
672 99% of the current stream.
673 The new VCD/SVCD plugin allows some numeric input. Entering a number
675 followed by the "Select event" (by default the keypad enter), one can
676 go to a specific "Chapter" (track or entry) or selection number. As
677 this is a relatively new feature, perhaps over time more plugins will
678 make use of numeric selection.
679 Other commands that can be numeric prefaced by a numeric argument are
681 next/previous MRL (MRL_NEXT, MRL_PRIOR), next/previous subtitle
682 (SPU_NEXT, SPU_PRIOR), and next/previous audio channel (AUDIOCHAN_NEXT,
683 AUDIOCHAN_PRIOR). With a numeric prefix, it is as though one entered
684 that command the number of times. Here, the argument 0, since it would
685 otherwise meaningless, is interpreted here to be 1 instead.
686 Admittedly the use of numeric input here is of limited value. Over time
688 perhaps more useful commands like specifying a specific or absolute
689 MRL, subtitle or audio channel number will be implemented.
690
693 ~/.xine/config Main config file
694 ~/.xine/keymap Key bindings for xine-ui
696 ~/.xine/passwd Passwords file xine-ui
698 ~/.xine/xinerc Additional command line arguments
700 Each line specifies an additional command line argument
701 (one argument per line):
702 --geometry 720x576+0+0
703 --network
704 -s DVD
705 -p
706
708 xine-remote(1)
709 xine(5) for details of the MRL syntax
710 The programs are documented fully on the xine home page:
712 http://www.xine-project.org/ ⟨http://www.xine-project.org/⟩
713
715 This manual page was written by Siggi Langauf <siggi@debian.org>, for
716 the xine project. Lots of additions by Guenter Bartsch
717 <guenter@users.sourceforge.net>, Daniel Caujolle-Bert
718 <f1rmb@users.sourceforge.net>, Rocky Bernstein <rocky@panix.com>, and
719 Philipp Hahn <pmhahn@users.sourceforge.net>.
720The xine project 2002-04-16 XINE(1)