This manual page documents briefly the
xine
audio/video player.
xine
plays MPEG system (audio and video) streams, mpeg elementary streams
(e.g. .mp3 or .mpv files), mpeg transport streams, avi files, asf files,
quicktime files, (S)VCDs and DVDs.
OPTIONS
The programs follow the usual GNU command line syntax, with long
ioptions starting with two dashes (`-').
A summary of options are included below.
For a complete description, see README and FAQ in /usr/share/doc/xine-ui
or on the xine home page.
-h, --help
Show summary of options and available output drivers (plugins).
-a, --audio-channel <num>
Select the given audio channel. <num> is the audio channel number, default
is "0".
xine 0.5 and newer tries its best to collect all valid audio channels
(ac3, mpeg audio, avi audio, ...) from the stream and maps them
to "virtual channels" with channel numbers starting at 0.
-V, --video-driver <drv>
Select video driver. Check out "xine --help" for a list of available
video output plugins on your system. This selection is stored automatically
in your .xinerc so you'll have to specify the video driver only once.
-A, --audio-driver <drv>
Select audio driver. Check out "xine --help" for a list of available
audio output plugins on your system. This selection is stored automatically
in your .xinerc so you'll have to specify the audio driver only once.
-u, --spu-channel <num>
Select subpicture (subtitle) channel. <num> is the subpicture channel
id, default is no subtitle (-1).
-p[q][d][v], --auto-play=[q][d][v]
Start playing immediately after start. Can be followed by "q" for quitting
at the end. As in earlier versions of xine, it is also possible to request
the playlist from DVD 'd', or VCD 'v'. There is now a more generic option,
--auto-scan, for that (see below). So the "d" and "v" suboptions may be
removed some day.
-s <plugin>, --auto-scan <plugin>
Auto-scan playlist from named input plugin. Many plugins allow to read a
default playlist, in order to play "everything". This works fine for DVDs
or VCDs, for example. Giving this option has the same effect as pressing
the according button on xine's main panel.
This option is especially useful in combination with auto-play. You could
start "xine --auto-play --auto-scan dvd" in order to play a whole DVD without
having to press any additional buttons. This also works for plugins that are
not supplied with xine, just give the name of the button that the desired
plugin adds to the xine panel!
-f, --fullscreen
Switch xine to fullscreen mode on start (just like pressing "F")
-g, --hide-gui
Hide all GUI windows (except the video window) on start. This is the same as
pressing "G" within xine.
-R, --recognize-by <option>
Change the way xine will try to recognize stream types.
Valid options are:
"default" (first by content, then by extension),
"revert" (first by extension, then by content),
"content" (only by content),
"extension" (only by extension). If no option is given,
"revert" is selected
--visual <visual-class-or-id>
Try to use a specific X11 server visual for xine windows. The
<visual-class-or-id> parameter is either the name of an X11 visual
class (StaticGray, GrayScale, StaticColor, PseudoColor, TrueColor or
DirectColor) or the hexadecimal value for a specific X11 visual.
When used with a visual class name, xine tries to find such a visual
with depth 15 or 16, 24 or 32, 8 (in that order). The default visual
class used by xine in absence of a --visual option is TrueColor.
If no usable visual is found, xine falls back to
the default visual used on the X11 server's root window.
--install
When using an X11 visual with changable colors (colormaps), install a
private colormap for xine. With a private colormap, xine can allocate
more colors so that video output may look better.
MRL (media resource locator)
MRLs are similar to URLs in your web browser. They describe the media
to read from. valid MRLs may be plain file names or one of the following:
file://<path> fifo://<path> stdin://mpeg1
or
stdin://mpeg2 dvd://VTS_xx_y.VOB vcd://<track number> tcp://<host>:<port> rtp://<host>:<port> udp://<host>:<port>
Several MRLs may be specified in order to play a number of consecutive
streams.
If you don't specify any MRL, you'll have to select a file by drag'n-drop.
Dragging files from the GNOME Midnight Commander (gmc) is known to work.
Many features can be controlled by pressing control keys. 'M-' is the Meta key ('Alt' key on PC keyboard), 'C-' is the Control 'CTRL' key, other special key are delimited by '<' and '>' characters, eg: the HOME key is displayed <home>.
The default key bindings are:
0:
Jump to start of current stream
1..9:
Jump to 10%..90% of current stream
A:
Toggle aspect ratio (AUTO/16:9/4:3/DVB)
M-C|M-c:
Show/hide the video settings window.
E:
Eject the current media.
F:
Toggle fullscreen mode.
G:
Hide/show the gui.
H:
Hide/show the video output window.
i|I:
Toggle deinterlaced methods.
M-m|M-M:
Hide/show the MRL browser.
C-m|C-M:
Audio mute toggle.
M-p|M-P:
Show/hide the playlist window.
Q:
Exit.
z|Z:
Zoom in/out.
v:
Decrease audio volume.
V:
Increase audio volume.
t:
Take a snapshot.
<return>:
Play
<space>:
Pause
<up>/<down>:
fast forward / slow motion
c-<left>/C-<right>:
seek -+ 15 sec.
<left>/<right>:
seek +- 60 sec.
<page up>:
Jump to previous stream in playlist
<page down>:
Jump to next stream in playlist
<:
Reduce the output window.
>:
Enlarge the ouput window.
.:
Select next sub-title channel.
,:
Select previous sub-title channel.
+:
Select next audio channel (may take up to a few seconds to take effect)
-:
Select prev audio channel
Esc:
Menu 1 (e.g. root menu)
F1:
Menu 2 (e.g. title menu)
F2:
Menu 3
M-L:
show log viewer window
Synchronization fine tuning
Some streams have bad timestamps, so synchronization fails. This can be
tweaked using arrow keys:
n|N:
press if video runs ahead of audio
m|M:
press if video lags behind audio
<home>:
press to reset audio/video offset to 0, so stream timestamps are unchanged.
FILES
All config files are now to be found in ~/.xine:
~/.xine/config:
main config file
~/.xine/keymap:
key bindings for xine-ui