diff options
Diffstat (limited to 'DOCS/man/en')
-rw-r--r-- | DOCS/man/en/af.rst | 42 | ||||
-rw-r--r-- | DOCS/man/en/ao.rst | 4 | ||||
-rw-r--r-- | DOCS/man/en/changes.rst | 17 | ||||
-rw-r--r-- | DOCS/man/en/mpv.rst (renamed from DOCS/man/en/mplayer.rst) | 130 | ||||
-rw-r--r-- | DOCS/man/en/options.rst | 162 | ||||
-rw-r--r-- | DOCS/man/en/vo.rst | 12 |
6 files changed, 177 insertions, 190 deletions
diff --git a/DOCS/man/en/af.rst b/DOCS/man/en/af.rst index dc0450241f..1fe480dcdc 100644 --- a/DOCS/man/en/af.rst +++ b/DOCS/man/en/af.rst @@ -57,7 +57,7 @@ resample[=srate[:sloppy[:type]]] *EXAMPLE*: - ``mplayer --af=resample=44100:0:0`` + ``mpv --af=resample=44100:0:0`` would set the output frequency of the resample filter to 44100Hz using exact output frequency scaling and linear interpolation. @@ -200,7 +200,7 @@ equalizer=[g1:g2:g3:...:g10] *EXAMPLE*: - ``mplayer --af=equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi`` + ``mpv --af=equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi`` Would amplify the sound in the upper and lower frequency region while canceling it almost completely around 1kHz. @@ -223,13 +223,13 @@ channels=nch[:nr:from1:to1:from2:to2:from3:to3:...] *EXAMPLE*: - ``mplayer --af=channels=4:4:0:1:1:0:2:2:3:3 media.avi`` + ``mpv --af=channels=4:4:0:1:1:0:2:2:3:3 media.avi`` Would change the number of channels to 4 and set up 4 routes that swap channel 0 and channel 1 and leave channel 2 and 3 intact. Observe that if media containing two channels was played back, channels 2 and 3 would contain silence but 0 and 1 would still be swapped. - ``mplayer --af=channels=6:4:0:0:0:1:0:2:0:3 media.avi`` + ``mpv --af=channels=6:4:0:0:0:1:0:2:0:3 media.avi`` Would change the number of channels to 6 and set up 4 routes that copy channel 0 to channels 0 to 3. Channel 4 and 5 will contain silence. @@ -242,7 +242,7 @@ format[=format] the sign (either 's' for signed or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32) and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian and 'ne' the - endianness of the computer MPlayer is running on). Valid values + endianness of the computer mpv is running on). Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'. Exceptions to this rule that are also valid format specifiers: u8, s8, floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm. @@ -260,7 +260,7 @@ volume[=v[:sc]] background is gone. This filter has a second feature: It measures the overall maximum sound - level and prints out that level when MPlayer exits. This feature currently + level and prints out that level when mpv exits. This feature currently only works with floating-point data, use e.g. ``--af-adv=force=5``, or use ``--af=stats``. @@ -281,7 +281,7 @@ volume[=v[:sc]] *EXAMPLE*: - ``mplayer --af=volume=10.1:0 media.avi`` + ``mpv --af=volume=10.1:0 media.avi`` Would amplify the sound by 10.1dB and hard-clip if the sound level is too high. @@ -306,10 +306,10 @@ pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...] *EXAMPLE*: - ``mplayer --af=pan=1:0.5:0.5 media.avi`` + ``mpv --af=pan=1:0.5:0.5 media.avi`` Would down-mix from stereo to mono. - ``mplayer --af=pan=3:1:0:0.5:0:1:0.5 media.avi`` + ``mpv --af=pan=3:1:0:0.5:0:1:0.5 media.avi`` Would give 3 channel output leaving channels 0 and 1 intact, and mix channels 0 and 1 into output channel 2 (which could be sent to a subwoofer for example). @@ -338,7 +338,7 @@ sub[=fc:ch] *EXAMPLE*: - ``mplayer --af=sub=100:4 --channels=5 media.avi`` + ``mpv --af=sub=100:4 --channels=5 media.avi`` Would add a sub-woofer channel with a cutoff frequency of 100Hz to output channel 4. @@ -367,7 +367,7 @@ surround[=delay] *EXAMPLE*: - ``mplayer --af=surround=15 --channels=4 media.avi`` + ``mpv --af=surround=15 --channels=4 media.avi`` Would add surround sound decoding with 15ms delay for the sound to the rear speakers. @@ -395,7 +395,7 @@ delay[=ch1:ch2:...] *EXAMPLE*: - ``mplayer --af=delay=10.5:10.5:0:0:7:0 media.avi`` + ``mpv --af=delay=10.5:10.5:0:0:7:0 media.avi`` Would delay front left and right by 10.5ms, the two rear channels and the sub by 0ms and the center channel by 7ms. @@ -410,14 +410,14 @@ export[=mmapped_file[:nsamples]] The rest is payload (non-interleaved) 16 bit data. <mmapped_file> - file to map data to (default: ``~/.mplayer/mplayer-af_export``) + file to map data to (default: ``~/.mpv/mpv-af_export``) <nsamples> number of samples per channel (default: 512) *EXAMPLE*: - ``mplayer --af=export=/tmp/mplayer-af_export:1024 media.avi`` - Would export 1024 samples per channel to ``/tmp/mplayer-af_export``. + ``mpv --af=export=/tmp/mpv-af_export:1024 media.avi`` + Would export 1024 samples per channel to ``/tmp/mpv-af_export``. extrastereo[=mul] (Linearly) increases the difference between left and right channels which @@ -461,7 +461,7 @@ ladspa=file:label[:controls...] <controls> Controls are zero or more floating point values that determine the behavior of the loaded plugin (for example delay, threshold or gain). - In verbose mode (add ``-v`` to the MPlayer command line), all + In verbose mode (add ``-v`` to the mpv command line), all available controls and their valid ranges are printed. This eliminates the use of 'analyseplugin' from the LADSPA SDK. @@ -516,21 +516,21 @@ scaletempo[=option1:option2:...] *EXAMPLE*: - ``mplayer --af=scaletempo --speed=1.2 media.ogg`` + ``mpv --af=scaletempo --speed=1.2 media.ogg`` Would playback media at 1.2x normal speed, with audio at normal pitch. Changing playback speed, would change audio tempo to match. - ``mplayer --af=scaletempo=scale=1.2:speed=none --speed=1.2 media.ogg`` + ``mpv --af=scaletempo=scale=1.2:speed=none --speed=1.2 media.ogg`` Would playback media at 1.2x normal speed, with audio at normal pitch, but changing playback speed has no effect on audio tempo. - ``mplayer --af=scaletempo=stride=30:overlap=.50:search=10 media.ogg`` + ``mpv --af=scaletempo=stride=30:overlap=.50:search=10 media.ogg`` Would tweak the quality and performace parameters. - ``mplayer --af=format=floatne,scaletempo media.ogg`` + ``mpv --af=format=floatne,scaletempo media.ogg`` Would make scaletempo use float code. Maybe faster on some platforms. - ``mplayer --af=scaletempo=scale=1.2:speed=pitch audio.ogg`` + ``mpv --af=scaletempo=scale=1.2:speed=pitch audio.ogg`` Would playback audio file at 1.2x normal speed, with audio at normal pitch. Changing playback speed, would change pitch, leaving audio tempo at 1.2x. diff --git a/DOCS/man/en/ao.rst b/DOCS/man/en/ao.rst index 00dd1e9e6d..412d9ac939 100644 --- a/DOCS/man/en/ao.rst +++ b/DOCS/man/en/ao.rst @@ -9,7 +9,7 @@ syntax is: --ao=<driver1[:suboption1[=value]:...],driver2,...[,]> Specify a priority list of audio output drivers to be used. -If the list has a trailing ',' MPlayer will fall back on drivers not contained +If the list has a trailing ',' mpv will fall back on drivers not contained in the list. Suboptions are optional and can mostly be omitted. *NOTE*: See ``--ao=help`` for a list of compiled-in audio output drivers. @@ -48,7 +48,7 @@ jack port=<name> Connects to the ports with the given name (default: physical ports). name=<client> - Client name that is passed to JACK (default: MPlayer [<PID>]). Useful + Client name that is passed to JACK (default: mpv [<PID>]). Useful if you want to have certain connections established automatically. (no-)estimate Estimate the audio delay, supposed to make the video playback smoother diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst index cdbfb8f0ab..5b1c3ea4a6 100644 --- a/DOCS/man/en/changes.rst +++ b/DOCS/man/en/changes.rst @@ -3,10 +3,7 @@ CHANGES FROM OTHER VERSIONS OF MPLAYER ====================================== -xxx: since I don't have a new name yet, I'm referring to this version of mplayer -as **mplayer3**, I don't intend to use that name. - -**mplayer3** is based on mplayer2, which in turn is based on the original +**mpv** is based on mplayer2, which in turn is based on the original MPlayer (also called mplayer, mplayer-svn, mplayer1). Many changes have been made. Some changes are incompatible, or completely change how the player behaves. @@ -37,7 +34,7 @@ General changes for mplayer-svn to mplayer2 * General code cleanups * Many more changes -General changes for mplayer2 to mplayer3 +General changes for mplayer2 to mpv ---------------------------------------- * Removal of lots of unneeded code to encourage developer activity (less @@ -51,9 +48,9 @@ General changes for mplayer2 to mplayer3 languages like Arabic should be better supported. * Cleaned up terminal output (nicer status line, less useless noise) * Support for playing URLs of popular streaming sites directly - (e.g. ``mplayer3 https://www.youtube.com/watch?v=...``) + (e.g. ``mpv https://www.youtube.com/watch?v=...``) * Improved OpenGL output (``vo_opengl``) -* Make ``--softvol`` default (**mplayer3** is not a mixer control panel) +* Make ``--softvol`` default (**mpv** is not a mixer control panel) * Improved support for .cue files * Screenshot improvements (can save screenshots as JPG, configurable filenames) * Removal of teletext support @@ -113,7 +110,7 @@ input.conf and slave commands Other ~~~~~ -* The playtree has been removed. **mplayer3**'s internal playlist is a simple and +* The playtree has been removed. **mpv**'s internal playlist is a simple and flat list now. This makes the code easier, and makes using it less confusing. * Slave mode is broken. This mode is entirely insane in the ``old`` versions of mplayer. A proper slave mode application needed tons of code and hacks to get @@ -123,7 +120,7 @@ Other slave mode application, and as such it's virtually impossible to improve terminal output intended for users without possibly breaking something. - This is absolutely insane, and **mplayer3** will not try to keep slave mode + This is absolutely insane, and **mpv** will not try to keep slave mode compatible. If you're a developer of a slave mode application, contact us, and a new and better protocol can be developed. @@ -152,6 +149,6 @@ Why this fork? withheld as to not turn this into a rant. * mplayer-svn rarely merged from mplayer2, and mplayer2 practically stopped merging from mplayer-svn (not even code cleanups or new features are merged) -* **mplayer3** intents to continuously merge from mplayer-svn and mplayer2, while +* **mpv** intents to continuously merge from mplayer-svn and mplayer2, while speeding up development. There is willingness for significant changes, even if this means breaking compatibility. diff --git a/DOCS/man/en/mplayer.rst b/DOCS/man/en/mpv.rst index 89b03737c3..2cca30c383 100644 --- a/DOCS/man/en/mplayer.rst +++ b/DOCS/man/en/mpv.rst @@ -1,32 +1,32 @@ -mplayer2 manual page +mpv manual page #################### Synopsis ======== -| **mplayer** [options] [file|URL|-] -| **mplayer** [options] --playlist=PLAYLIST -| **mplayer** [options] files -| **mplayer** [options] {group of files and options} -| **mplayer** [bd]://[title][/device] [options] -| **mplayer** dvd://[title|[start\_title]-end\_title][/device] [options] -| **mplayer** \vcd://track[/device] -| **mplayer** \tv://[channel][/input_id] [options] -| **mplayer** radio://[channel|frequency][/capture] [options] -| **mplayer** \pvr:// [options] -| **mplayer** \dvb://[card\_number@]channel [options] -| **mplayer** \mf://[filemask|\@listfile] [-mf options] [options] -| **mplayer** [cdda|cddb]://track[-endtrack][:speed][/device] [options] -| **mplayer** [file|mms[t]|http|http\_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]:// [user:pass\@]URL[:port] [options] -| **mplayer** \sdp://file [options] -| **mplayer** \mpst://host[:port]/URL [options] -| **mplayer** \tivo://host/[list|llist|fsid] [options] +| **mpv** [options] [file|URL|-] +| **mpv** [options] --playlist=PLAYLIST +| **mpv** [options] files +| **mpv** [options] {group of files and options} +| **mpv** [bd]://[title][/device] [options] +| **mpv** dvd://[title|[start\_title]-end\_title][/device] [options] +| **mpv** \vcd://track[/device] +| **mpv** \tv://[channel][/input_id] [options] +| **mpv** radio://[channel|frequency][/capture] [options] +| **mpv** \pvr:// [options] +| **mpv** \dvb://[card\_number@]channel [options] +| **mpv** \mf://[filemask|\@listfile] [-mf options] [options] +| **mpv** [cdda|cddb]://track[-endtrack][:speed][/device] [options] +| **mpv** [file|mms[t]|http|http\_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]:// [user:pass\@]URL[:port] [options] +| **mpv** \sdp://file [options] +| **mpv** \mpst://host[:port]/URL [options] +| **mpv** \tivo://host/[list|llist|fsid] [options] DESCRIPTION =========== -**mplayer** is a movie player for Linux. It supports a wide variety of video +**mpv** is a movie player based on MPlayer and mplayer2. It supports a wide variety of video file formats, audio and video codecs, and subtitle types. Special input URL types are available to read input from a variety of sources other than disk files. Depending on platform, a variety of different video and audio output @@ -39,8 +39,8 @@ page. INTERACTIVE CONTROL =================== -MPlayer has a fully configurable, command-driven control layer which allows you -to control MPlayer using keyboard, mouse, joystick or remote control (with +mpv has a fully configurable, command-driven control layer which allows you +to control mpv using keyboard, mouse, joystick or remote control (with LIRC). See the ``--input`` option for ways to customize it. keyboard control @@ -283,9 +283,9 @@ the *XXX* option or if *XXX* is compiled in. | It has the following format: | %n%string\_of\_length\_n | *EXAMPLES*: -| `mplayer --ao pcm:file=%10%C:test.wav test.avi` +| `mpv --ao pcm:file=%10%C:test.wav test.avi` | Or in a script: -| `mplayer --ao pcm:file=%\`expr length "$NAME"\`%"$NAME" test.avi` +| `mpv --ao pcm:file=%\`expr length "$NAME"\`%"$NAME" test.avi` Per-file options @@ -294,7 +294,7 @@ Per-file options When playing multiple files, any option given on the command line usually affects all files. Example: -`mplayer --a file1.mkv --b file2.mkv --c` +`mpv --a file1.mkv --b file2.mkv --c` +-----------+-------------------------+ | File | Active options | @@ -311,7 +311,7 @@ Sometimes, it's useful to change options per-file. This can be achieved by adding the special per-file markers `--{` and `--}`. (Note that you must escape these on some shells.) Example: -`mplayer --a file1.mkv --b --\\\{ --c file2.mkv --d file3.mkv --e --\\\} file4.mkv --f` +`mpv --a file1.mkv --b --\\\{ --c file2.mkv --d file3.mkv --e --\\\} file4.mkv --f` +-----------+-------------------------+ | File | Active options | @@ -334,9 +334,9 @@ CONFIGURATION FILES =================== You can put all of the options in configuration files which will be read every -time MPlayer is run. The system-wide configuration file 'mplayer.conf' is in -your configuration directory (e.g. ``/etc/mplayer`` or -``/usr/local/etc/mplayer``), the user specific one is ``~/.mplayer/config``. +time mpv is run. The system-wide configuration file 'mpv.conf' is in +your configuration directory (e.g. ``/etc/mpv`` or +``/usr/local/etc/mpv``), the user specific one is ``~/.mpv/config``. User specific options override system-wide options and options given on the command line override either. The syntax of the configuration files is ``option=<value>``, everything after a *#* is considered a comment. Options @@ -347,16 +347,16 @@ can be specified in this way. You can also write file-specific configuration files. If you wish to have a configuration file for a file called 'movie.avi', create a file named 'movie.avi.conf' with the file-specific options in it and put it in -``~/.mplayer/``. You can also put the configuration file in the same directory +``~/.mpv/``. You can also put the configuration file in the same directory as the file to be played, as long as you give the ``--use-filedir-conf`` option (either on the command line or in your global config file). If a file-specific configuration file is found in the same directory, no -file-specific configuration is loaded from ``~/.mplayer``. In addition, the +file-specific configuration is loaded from ``~/.mpv``. In addition, the ``--use-filedir-conf`` option enables directory-specific configuration files. -For this, MPlayer first tries to load a mplayer.conf from the same directory +For this, mpv first tries to load a mpv.conf from the same directory as the file played and then tries to load any file-specific configuration. -*EXAMPLE MPLAYER CONFIGURATION FILE:* +*EXAMPLE MPV CONFIGURATION FILE:* | # Use gl3 video output by default. | vo=gl3 @@ -379,7 +379,7 @@ description (shown by ``--profile=help``) can be defined with the profile-desc option. To end the profile, start another one or use the profile name *default* to continue with normal options. -*EXAMPLE MPLAYER PROFILE:* +*EXAMPLE MPV PROFILE:* | [protocol.dvd] | profile-desc="profile for dvd:// streams" @@ -438,22 +438,22 @@ ENVIRONMENT VARIABLES ===================== There are a number of environment variables that can be used to control the -behavior of MPlayer. +behavior of mpv. -``MPLAYER_CHARSET`` (see also ``--msgcharset``) +``MPV_CHARSET`` (see also ``--msgcharset``) Convert console messages to the specified charset (default: autodetect). A value of "noconv" means no conversion. -``MPLAYER_HOME`` - Directory where MPlayer looks for user settings. +``MPV_HOME`` + Directory where mpv looks for user settings. -``MPLAYER_LOCALEDIR`` - Directory where MPlayer looks for gettext translation files (if enabled). +``MPV_LOCALEDIR`` + Directory where mpv looks for gettext translation files (if enabled). -``MPLAYER_VERBOSE`` (see also ``-v`` and ``--msglevel``) +``MPV_VERBOSE`` (see also ``-v`` and ``--msglevel``) Set the initial verbosity level across all message modules (default: 0). The resulting verbosity corresponds to that of ``--msglevel=5`` plus the - value of ``MPLAYER_VERBOSE``. + value of ``MPV_VERBOSE``. libaf: ``LADSPA_PATH`` @@ -595,58 +595,58 @@ libavformat: FILES ===== -``/usr/local/etc/mplayer/mplayer.conf`` - MPlayer system-wide settings +``/usr/local/etc/mpv/mpv.conf`` + mpv system-wide settings -``~/.mplayer/config`` - MPlayer user settings +``~/.mpv/config`` + mpv user settings -``~/.mplayer/input.conf`` +``~/.mpv/input.conf`` input bindings (see ``--input=keylist`` for the full list) -``~/.mplayer/DVDkeys/`` +``~/.mpv/DVDkeys/`` cached CSS keys -EXAMPLES OF MPLAYER USAGE +EXAMPLES OF MPV USAGE ========================= Quickstart Blu-ray playing: - - ``mplayer bd:////path/to/disc`` - - ``mplayer bd:// --bluray-device=/path/to/disc`` + - ``mpv bd:////path/to/disc`` + - ``mpv bd:// --bluray-device=/path/to/disc`` Quickstart DVD playing: - ``mplayer dvd://1`` + ``mpv dvd://1`` Play in Japanese with English subtitles: - ``mplayer dvd://1 --alang=ja --slang=en`` + ``mpv dvd://1 --alang=ja --slang=en`` Play only chapters 5, 6, 7: - ``mplayer dvd://1 --chapter=5-7`` + ``mpv dvd://1 --chapter=5-7`` Play only titles 5, 6, 7: - ``mplayer dvd://5-7`` + ``mpv dvd://5-7`` Play a multiangle DVD: - ``mplayer dvd://1 --dvdangle=2`` + ``mpv dvd://1 --dvdangle=2`` Play from a different DVD device: - ``mplayer dvd://1 --dvd-device=/dev/dvd2`` + ``mpv dvd://1 --dvd-device=/dev/dvd2`` Play DVD video from a directory with VOB files: - ``mplayer dvd://1 --dvd-device=/path/to/directory/`` + ``mpv dvd://1 --dvd-device=/path/to/directory/`` Stream from HTTP: - ``mplayer http://mplayer.hq/example.avi`` + ``mpv http://mpv.hq/example.avi`` Stream using RTSP: - ``mplayer rtsp://server.example.com/streamName`` + ``mpv rtsp://server.example.com/streamName`` input from standard V4L: - ``mplayer tv:// --tv=driver=v4l:width=640:height=480:outfmt=i420 --vc=rawi420 --vo=xv`` + ``mpv tv:// --tv=driver=v4l:width=640:height=480:outfmt=i420 --vc=rawi420 --vo=xv`` Play DTS-CD with passthrough: - ``mplayer --ac=hwdts --rawaudio=format=0x2001 --cdrom-device=/dev/cdrom cdda://`` + ``mpv --ac=hwdts --rawaudio=format=0x2001 --cdrom-device=/dev/cdrom cdda://`` You can also use ``--afm=hwac3`` instead of ``--ac=hwdts``. Adjust ``/dev/cdrom`` to match the CD-ROM device on your system. If your external @@ -654,21 +654,23 @@ Play DTS-CD with passthrough: ``cdda://`` without setting format, hwac3 or hwdts. Play a 6-channel AAC file with only two speakers: - ``mplayer --rawaudio=format=0xff --demuxer=rawaudio --af=pan=2:.32:.32:.39:.06:.06:.39:.17:-.17:-.17:.17:.33:.33 adts_he-aac160_51.aac`` + ``mpv --rawaudio=format=0xff --demuxer=rawaudio --af=pan=2:.32:.32:.39:.06:.06:.39:.17:-.17:-.17:.17:.33:.33 adts_he-aac160_51.aac`` You might want to play a bit with the pan values (e.g multiply with a value) to increase volume or avoid clipping. checkerboard invert with geq filter: - ``mplayer --vf=geq='128+(p(X\,Y)-128)*(0.5-gt(mod(X/SW\,128)\,64))*(0.5-gt(mod(Y/SH\,128)\,64))*4'`` + ``mpv --vf=geq='128+(p(X\,Y)-128)*(0.5-gt(mod(X/SW\,128)\,64))*(0.5-gt(mod(Y/SH\,128)\,64))*4'`` AUTHORS ======= +mpv is a MPlayer fork based on mplayer2, which in turn is a fork of MPlayer. + MPlayer was initially written by Arpad Gereoffy. See the ``AUTHORS`` file for a list of some of the many other contributors. -MPlayer is (C) 2000-2011 The MPlayer Team +MPlayer is (C) 2000-2012 The MPlayer Team This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun. diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst index c52c8b307e..dbac793fa9 100644 --- a/DOCS/man/en/options.rst +++ b/DOCS/man/en/options.rst @@ -14,7 +14,7 @@ Specify a priority list of audio codecs to be used, according to their codec name in codecs.conf. Use a '-' before the codec name to omit it. Use a '+' before the codec name to force it, this will likely crash! If - the list has a trailing ',' MPlayer will fall back on codecs not contained + the list has a trailing ',' mpv will fall back on codecs not contained in the list. *NOTE*: See ``--ac=help`` for a full list of available codecs. @@ -58,7 +58,7 @@ may silently fail, and the sound quality may drop. 3 Use no automatic insertion of filters and no optimization. - *Warning*: It may be possible to crash MPlayer using this setting. + *Warning*: It may be possible to crash mpv using this setting. 4 Use automatic insertion of filters according to 0 above, but use floating point processing when possible. @@ -95,15 +95,15 @@ Specify a priority list of audio languages to use. Different container formats employ different language codes. DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT use ISO 639-2 three letter - language codes while OGM uses a free-form identifier. MPlayer prints the + language codes while OGM uses a free-form identifier. mpv prints the available languages when run in verbose (``-v``) mode. See also ``--aid``. *EXAMPLE*: - ``mplayer dvd://1 --alang=hu,en`` + ``mpv dvd://1 --alang=hu,en`` Chooses the Hungarian language track on a DVD and falls back on English if Hungarian is not available. - ``mplayer --alang=jpn example.mkv`` + ``mpv --alang=jpn example.mkv`` Plays a Matroska file in Japanese. --ao=<driver1[:suboption1[=value]:...],driver2,...[,]> @@ -245,11 +245,11 @@ --bluray-angle=<ID> Some Blu-ray discs contain scenes that can be viewed from multiple angles. - Here you can tell MPlayer which angles to use (default: 1). + Here you can tell mpv which angles to use (default: 1). --bluray-chapter=<ID> (Blu-ray only) - Tells MPlayer which Blu-ray chapter to start the current title from + Tells mpv which Blu-ray chapter to start the current title from (default: 1). --bluray-device=<path> @@ -278,12 +278,12 @@ --cache-seek-min=<percentage> If a seek is to be made to a position within <percentage> of the cache - size from the current position, MPlayer will wait for the cache to be + size from the current position, mpv will wait for the cache to be filled to this position rather than performing a stream seek (default: 50). --cdda=<option1:option2> - This option can be used to tune the CD Audio reading feature of MPlayer. + This option can be used to tune the CD Audio reading feature of mpv. Available options are: @@ -323,7 +323,7 @@ Specify the CD-ROM device (default: ``/dev/cdrom``). --channels=<number> - Request the number of playback channels (default: 2). MPlayer asks the + Request the number of playback channels (default: 2). mpv asks the decoder to decode the audio into as many channels as specified. Then it is up to the decoder to fulfill the requirement. This is usually only important when playing videos with AC-3 audio (like DVDs). In that case @@ -457,7 +457,7 @@ assumed to be in Netscape format. --correct-pts, --no-correct-pts - Switches MPlayer to a mode where timestamps for video frames are + Switches mpv to a mode where timestamps for video frames are calculated differently and video filters which add new frames or modify timestamps of existing ones are supported. Now enabled automatically for most common file formats. The more accurate timestamps can be visible for @@ -502,10 +502,10 @@ override the default ones: :card=<1-4>: Specifies using card number 1-4 (default: 1). - :file=<filename>: Instructs MPlayer to read the channels list from + :file=<filename>: Instructs mpv to read the channels list from <filename>. Default is - ``~/.mplayer/channels.conf.{sat,ter,cbl,atsc}`` (based - on your card type) or ``~/.mplayer/channels.conf`` as a + ``~/.mpv/channels.conf.{sat,ter,cbl,atsc}`` (based + on your card type) or ``~/.mpv/channels.conf`` as a last resort. :timeout=<1-30>: Maximum number of seconds to wait when trying to tune a frequency before giving up (default: 30). @@ -519,7 +519,7 @@ Try to limit DVD speed (default: 0, no change). DVD base speed is 1385 kB/s, so a 8x drive can read at speeds up to 11080 kB/s. Slower speeds make the drive more quiet. For watching DVDs 2700 kB/s should be quiet and - fast enough. MPlayer resets the speed to the drive default value on close. + fast enough. mpv resets the speed to the drive default value on close. Values of at least 100 mean speed in kB/s. Values less than 100 mean multiples of 1385 kB/s, i.e. ``--dvd-speed=8`` selects 11080 kB/s. @@ -527,12 +527,12 @@ --dvdangle=<ID> Some DVD discs contain scenes that can be viewed from multiple angles. - Here you can tell MPlayer which angles to use (default: 1). + Here you can tell mpv which angles to use (default: 1). --edition=<ID> (Matroska files only) Specify the edition (set of chapters) to use, where 0 is the first. If set - to -1 (the default), MPlayer will choose the first edition declared as a + to -1 (the default), mpv will choose the first edition declared as a default, or if there is no default, the first edition defined. --edlout=<filename> @@ -611,16 +611,16 @@ specify a particular font. See also ``--subfont``. With fontconfig enabled the argument is a fontconfig pattern and the default is ``sans``. Without fontconfig the argument is a filename and the default is - ``~/.mplayer/subfont.ttf``. + ``~/.mpv/subfont.ttf``. *EXAMPLE*: - - ``--font=~/.mplayer/arialuni.ttf`` (no fontconfig) + - ``--font=~/.mpv/arialuni.ttf`` (no fontconfig) - ``--font='Bitstream Vera Sans'`` (usual case with fontconfig) - ``--font='Bitstream Vera Sans:style=Bold'`` (usual case with fontconfig) --force-window-position - Forcefully move MPlayer's video output window to default location whenever + Forcefully move mpv's video output window to default location whenever there is a change in video parameters, video stream or file. This used to be the default behavior. Currently only affects X11 VOs. @@ -760,7 +760,7 @@ Command that is executed every 30 seconds during playback via *system()* - i.e. using the shell. - *NOTE*: mplayer uses this command without any checking, it is your + *NOTE*: mpv uses this command without any checking, it is your responsibility to ensure it does not cause security problems (e.g. make sure to use full paths if "." is in your path like on Windows). It also only works when playing video (i.e. not with ``--no-video`` but works with @@ -771,10 +771,10 @@ complicated, ask the author of the screensaver program to support the proper X APIs. - *EXAMPLE for xscreensaver*: ``mplayer --heartbeat-cmd="xscreensaver-command + *EXAMPLE for xscreensaver*: ``mpv --heartbeat-cmd="xscreensaver-command -deactivate" file`` - *EXAMPLE for GNOME screensaver*: ``mplayer + *EXAMPLE for GNOME screensaver*: ``mpv --heartbeat-cmd="gnome-screensaver-command -p" file`` --help @@ -821,7 +821,7 @@ *EXAMPLE*: - ``mplayer --http-header-fields='Field1: value1','Field2: value2' http://localhost:1234`` + ``mpv --http-header-fields='Field1: value1','Field2: value2' http://localhost:1234`` Will generate HTTP request: @@ -845,12 +845,12 @@ by using ``--msglevel=identify=6``. For example, for a DVD or Blu-ray it will list the chapters and time length of each title, as well as a disk ID. Combine this with ``--frames=0`` to suppress all video output. The - wrapper script ``TOOLS/midentify.sh`` suppresses the other MPlayer output + wrapper script ``TOOLS/midentify.sh`` suppresses the other mpv output and (hopefully) shellescapes the filenames. --idle - Makes MPlayer wait idly instead of quitting when there is no file to play. - Mostly useful in slave mode where MPlayer can be controlled through input + Makes mpv wait idly instead of quitting when there is no file to play. + Mostly useful in slave mode where mpv can be controlled through input commands (see also ``--slave``). --idx @@ -874,17 +874,17 @@ Specify configuration file to be parsed after the default ones. --initial-audio-sync, --no-initial-audio-sync - When starting a video file or after events such as seeking MPlayer will by + When starting a video file or after events such as seeking mpv will by default modify the audio stream to make it start from the same timestamp as video, by either inserting silence at the start or cutting away the first samples. Disabling this option makes the player behave like older - MPlayer versions did: video and audio are both started immediately even if + mpv versions did: video and audio are both started immediately even if their start timestamps differ, and then video timing is gradually adjusted if necessary to reach correct synchronization later. --input=<commands> This option can be used to configure certain parts of the input system. - Paths are relative to ``~/.mplayer/``. + Paths are relative to ``~/.mpv/``. *NOTE*: Autorepeat is currently only supported by joysticks. @@ -892,7 +892,7 @@ conf=<filename> Specify input configuration file other than the default - ``~/.mplayer/input.conf``. ``~/.mplayer/<filename>`` is assumed if no + ``~/.mpv/input.conf``. ``~/.mpv/<filename>`` is assumed if no full path is given. ar-dev=<device> @@ -907,7 +907,7 @@ Number of key presses to generate per second on autorepeat. (no)default-bindings - Use the key bindings that MPlayer ships with by default. + Use the key bindings that mpv ships with by default. keylist Prints all keys that can be bound to commands. @@ -922,7 +922,7 @@ Read commands from the given file. Mostly useful with a FIFO. See also ``--slave``. - *NOTE*: When the given file is a FIFO MPlayer opens both ends so you + *NOTE*: When the given file is a FIFO mpv opens both ends so you can do several `echo "seek 10" > mp_pipe` and the pipe will stay valid. @@ -935,7 +935,7 @@ --keepaspect, --no-keepaspect Keep window aspect ratio when resizing windows. Enabled by default. By - default MPlayer tries to keep the correct video aspect ratio by + default mpv tries to keep the correct video aspect ratio by instructing the window manager to maintain window aspect when resizing, and by adding black bars if the window manager nevertheless allows window shape to change. --no-keepaspect disables window manager aspect hints and @@ -1106,7 +1106,7 @@ Note, a patch to make the *o=* unneeded and pass all unknown options through the AVOption system is welcome. A full list of AVOptions can be found in the FFmpeg manual. Note that some options may conflict - with MPlayer options. + with mpv options. *EXAMPLE*: ``o=fflags=+ignidx`` probesize=<value> @@ -1133,11 +1133,11 @@ --loadidx=<filename> The file from which to read the video index data saved by ``--saveidx``. This index will be used for seeking, overriding any index data contained - in the AVI itself. MPlayer will not prevent you from loading an index file + in the AVI itself. mpv will not prevent you from loading an index file generated from a different AVI, but this is sure to cause unfavorable results. - *NOTE*: This option is obsolete now that MPlayer has OpenDML support. + *NOTE*: This option is obsolete now that mpv has OpenDML support. --loop=<number|inf|no> Loops playback <number> times. ``inf`` means forever and ``no`` disables @@ -1162,7 +1162,7 @@ --mixer-channel=<name[,index]> (``--ao=oss`` and ``--ao=alsa`` only) - This option will tell MPlayer to use a different channel for controlling + This option will tell mpv to use a different channel for controlling volume than the default PCM. Options for OSS include **vol, pcm, line**. For a complete list of options look for ``SOUND_DEVICE_NAMES`` in ``/usr/include/linux/soundcard.h``. For ALSA you can use the names e.g. @@ -1189,7 +1189,7 @@ also ``--monitoraspect`` and ``--aspect``. --mouse-movements - Permit MPlayer to receive pointer events reported by the video output + Permit mpv to receive pointer events reported by the video output driver. Necessary to select the buttons in DVD menus. Supported for X11-based VOs (x11, xv, etc) and the gl, direct3d and corevideo VOs. @@ -1208,7 +1208,7 @@ *NOTE*: Some messages are printed before the command line is parsed and are therefore not affected by ``--msglevel``. To control these messages - you have to use the ``MPLAYER_VERBOSE`` environment variable; see its + you have to use the ``MPV_VERBOSE`` environment variable; see its description below for details. Available levels: @@ -1284,7 +1284,7 @@ --ordered-chapters, --no-ordered-chapters Enabled by default. - Disable support for Matroska ordered chapters. MPlayer will not load or + Disable support for Matroska ordered chapters. mpv will not load or search for video segments from other files, and will also ignore any chapter order specified for the main file. @@ -1342,9 +1342,9 @@ Play files according to a playlist file (ASX, Winamp, SMIL, or one-file-per-line format). - *WARNING*: The way MPlayer parses and uses playlist files is not safe + *WARNING*: The way mpv parses and uses playlist files is not safe against maliciously constructed files. Such files may trigger harmful - actions. This has been the case for all MPlayer versions, but + actions. This has been the case |