Manpages

Manpage of XINE

XINE

Section: Misc. Reference Manual Pages (1x)
Updated: 2001-10-13
Index
Return to Main Contents
 

NAME

xine - a free video player  

SYNOPSIS

xine [options] [MRL] ...  

DESCRIPTION

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.  

SEE ALSO

The programs are documented fully on the xine home page: http://xine.sourceforge.net/  

CONTROL KEYS

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

 

AUTHOR

This manual page was written by Siggi Langauf <siggi@debian.org>, for the xine project. Lots of additions by Guenter Bartsch <guenter@users.sourceforge.net> and Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
CONTROL KEYS
Synchronization fine tuning
FILES
AUTHOR

This document was created by man2html, using the manual pages.
Time: 08:49:34 GMT, April 24, 2024