Namexine - a free video playerSynopsisxine [options] [MRL] ...DescriptionThis 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, ogg files, avi files, asf files, quicktime files, (S)VCDs and DVDs and many more.OptionsThe programs follow the usual GNU command line syntax, with long options 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-0.99.6 or on the xine home page.-h, --help Show summary of options and available output drivers (plugins). --verbose[=level] Set verbose level. --config Use config file instead of default one. -a, --audio-channel Select the given audio channel. 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 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 ~/.xine/config so you'll have to specify the video driver only once. -A, --audio-driver 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 ~/.xine/config so you'll have to specify the audio driver only once. -u, --spu-channel Select subpicture (subtitle) channel. is the subpicture channel id, default is no subtitle (-1). -p, --auto-play=[f][F][h][w][q][d][v] Start playing immediately after start. Can be followed by: 'f' in fullscreen mode, 'F' in xinerama fullscreen mode, 'h' hide GUI (main panel, etc...), 'w' hide video output window, 'q' for quitting after playback, 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). -s, --auto-scan 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') -F, --xineramafull Switch xine to xinerama fullscreen mode on start (just like pressing 'F'). That is to say, try to expand display on several screens. Screens to use are defined in config file. -g, --hide-gui Hide all GUI windows (except the video window) on start. This is the same as pressing 'G' within xine. -H, --hide-video Hide video output window. -L, --no-lirc Turn off LIRC support. This option is only available if xine has been compiled with LIRC support. --visual Try to use a specific X11 server visual for xine windows. The 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, 32 or 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 changeable colors (colormaps), install a private colormap for xine. With a private colormap, xine can allocate more colors so that video output may look better. --keymap [=option] Display keymap. Option are: 'default' display default keymap table, 'lirc' display draft of a ~/.lircrc config file, 'remapped' user remapped keymap table, 'file:' use file as keymap table, If no option is given, 'default' is selected. -n, --network Enable network remote control server. To use network remote control server, a password file is required. If xine cannot find it, the server is stopped. The syntax of the password file follows the (familiar) scheme :. Since cryptography is subject to legal issues in some countries, the password is not encrypted and also transmitted unencrypted, so take care with remote connections. Two (optional) generic rules are available as well (one at a time) ALL:ALLOW or ALL:DENY In the first case, all clients are allowed to execute all available commands, without restriction. In the second case, no-one is allowed to execute any commands, except identified users (using 'identify' command). If a password entry begins with an asterisk '*', the user is blocked. If a password entry is empty, the full entry is ignored. Here is an example of a small ~/.xine/passwd file: ALL:DENY daniel:mypasswd foo:* This will allow only 'daniel' to execute commands, after a successfully identifying stage. The default port of the server is 6789, this number is totally arbitrary. You can connect the server using a simple telnet command: telnet localhost 6789 To change the default port, you can (as root) edit your /etc/services, and add an entry like this: xinectl 7890/tcp # xine control This will change the default port from 6789 to 7890, and create a "human" service called xinectl. The server itself offers command help/syntax: help [command] Without command specified, all available commands will be displayed. If a command is specified, short text about the command functionality will be given. syntax Display the command syntax. -R, --root Use root window as video window. -G, --geometry You can set video output size and position using the X like geometry (see x(7)). X and Y offset are optional. -B, --borderless Remove borders of video output window, in windowed mode. -N, --animation Specify one or more mrl to play with audio only streams. -P, --playlist Use file as playlist. Known formats are: asx, toxine, m3u, pls, sfv and raw text file. -l, --loop [=mode] Set playlist loop mode. If mode isn't specified, mode loop is used. Possible modes are: loop: loop entire playlist. repeat: repeat current playlist entry. shuffle: select randomly an entry in playlist from those not yet played. shuffle+: same as shuffle, but indefinitely replay the playlist. --skin-server-url Define the skin server url. --enqueue ... Enqueue one or more mrl in a running session (session 0). If you want to specify another session, use -S session=x option. -S, --session Session managements. All options can be used more than one time, except session. Options are: session=n specify session number, mrl=m add mrl to the playlist, audio=c select audio channel (: next or prev), spu=c select spu channel (: next or prev), volume=v set audio volume (: 0 to 100), amp=v set audio amplification of instance (: 0 to 200), loop=m set loop mode (: none loop repeat shuffle or shuffle+), get_speed get current speed status. Return values are: - 1: error - 2: stop - 3: play - 4: pause - 5: slow4 - 6: slow2 - 7: fast2 - 8: fast4 get_time[=p|pos] get current position status in seconds, or in position in stream (0..65535). (playlist|pl)=p can be: clear: clear the playlist, first: play first entry in the playlist, prev: play previous playlist entry, next: play next playlist entry, last: play last entry in the playlist, load:s: load playlist file , stop: stop playback at the end of the current playback, cont: continue playback at the end of current playback. There are also some self explanatory options. play, slow2, slow4, pause, fast2, fast4, stop, quit, fullscreen, eject. -ZDon't automatically start playback, affect only auto-start when smart mode is used.-D, --deinterlace [post[:..][;]] Deinterlace video output. You can override configuration option of post(s) used to deinterlace the output picture. See --post for syntax. -r, --aspect-ratio Set aspect ratio of video output. can be: auto, square, 4:3, anamorphic, dvb. --broadcast-port Set port of xine broadcaster (master side), slave is started with 'xine slave://address:port' --no-logo Don't display the logo. -E, --no-reload Don't reload old playlist. Playlist is saved when you leave xine, then it is reloaded and played the next time you lanch xine. This feature can be disabled via setup window. --post [:parameter=value][,...][;...] Load one or more post plugin(s). Parameters are comma separated. This option can be used more than one time to chain two or more video postprocess plugins. You can specify two or more plugin, which may be separated by a semi-colon ';'. --disable-post Don't enable post plugin(s). This way, you can specify one more plugin to use, using the --post command line option, but don't enable those effects. --no-splash Don't display the splash screen. --stdctl Turn on controlling xine over STDIN. -T, --tvout Turn on TVout support. can be: nvtv, ati. --list-plugins[=type] Display the list of available plugins. Optional can be: audio_out, video_out, demux, input, sub, post, audio_decoder, video_decoder --bug-report[=mrl] Enable bug report mode. It turn verbosity on, gather all output messages and write them to a file names BUG-REPORT.TXT. If is given, xine will play that mrl then quit (like -pq does). 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), Nautilus or Konqueror is known to work.MRL (media resource locator)MRLs are similar to URLs in your web browser. They describe the media to read from. xine(5) describes them in some detail. xine extends the syntax as follows::: This is the xine-ui specific way to define the subtitle file to use. The filename will be extracted by the frontend, that permit to change it, save it in a playlist, etc... Stream OptionsAfter a delimiting # you can add several stream parameters:novideo video will be ignored noaudio audio will be ignored nospusubpictures will be ignoreddemux: specify the demux plugin to use volume: set audio volume compression: set audio dynamic range compression : assign a new value to any config entry change configuration option 'on the fly': You can change a configuration option at anytime, using the special cfg:/ mrl style. The syntax is: cfg:/ : Unlike stream config option, you can change anything before playing the stream. Control KeysMany 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 keys are delimited by '' characters, e.g. the 'HOME' key is displayed as . The default key bindings are:

Start playback

Playback pause toggle SStop playbacktTake a snapshoteEject the current medium

Select and play next MRL in the playlist

Select and play previous MRL in the playlist lLoop mode toggleC-sScan playlist to grab stream infosC-aAdd a mediamark from current playbackC-eEdit selected mediamark

Set position to -60 seconds in current stream

Set position to +60 seconds in current stream M- Set position to -30 seconds in current stream M- Set position to +30 seconds in current stream C- Set position to -15 seconds in current stream C- Set position to +15 seconds in current stream M3- Set position to -7 seconds in current stream M3- Set position to +7 seconds in current stream C-0Set position to beginning of current streamC-1Set position to 10% of current streamC-2Set position to 20% of current streamC-3Set position to 30% of current streamC-4Set position to 40% of current streamC-5Set position to 50% of current streamC-6Set position to 60% of current streamC-7Set position to 70% of current streamC-8Set position to 80% of current streamC-9Set position to 90% of current stream

Increment playback speed

Decrement playback speedM- Reset playback speed VIncrement audio volumevDecrement audio volumeC-VIncrement amplification levelC-vDecrement amplification levelC-AReset amplification to default valueC-mAudio muting toggle