2015-04-03 16:20:59 +00:00
|
|
|
![http://mpv.io/](https://raw.githubusercontent.com/mpv-player/mpv.io/master/source/images/mpv-logo-128.png)
|
|
|
|
|
|
|
|
## mpv
|
|
|
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
|
|
* [Overview](#overview)
|
|
|
|
* [Downloads](#downloads)
|
2016-11-15 22:42:33 +00:00
|
|
|
* [Changelog](#changelog)
|
2015-04-03 16:20:59 +00:00
|
|
|
* [Compilation](#compilation)
|
|
|
|
* [FFmpeg vs. Libav](#ffmpeg-vs-libav)
|
|
|
|
* [Release cycle](#release-cycle)
|
|
|
|
* [Bug reports](#bug-reports)
|
|
|
|
* [Contributing](#contributing)
|
|
|
|
* [Relation to MPlayer and mplayer2](#relation-to-mplayer-and-mplayer2)
|
|
|
|
* [Wiki](https://github.com/mpv-player/mpv/wiki)
|
2016-11-15 22:42:33 +00:00
|
|
|
* [FAQ](https://github.com/mpv-player/mpv/wiki/FAQ)
|
2015-04-03 16:20:59 +00:00
|
|
|
* [Man pages](http://mpv.io/manual/master/)
|
|
|
|
* [Contact](#contact)
|
|
|
|
* [License](#license)
|
|
|
|
|
|
|
|
## Overview
|
2013-05-19 07:19:29 +00:00
|
|
|
|
2012-11-13 06:25:28 +00:00
|
|
|
|
2015-02-08 14:19:49 +00:00
|
|
|
**mpv** is a media player based on MPlayer and mplayer2. It supports a wide
|
2012-11-13 06:25:28 +00:00
|
|
|
variety of video file formats, audio and video codecs, and subtitle types.
|
|
|
|
|
2015-03-04 17:53:40 +00:00
|
|
|
Releases can be found on the [release list][releases].
|
2015-03-04 11:03:24 +00:00
|
|
|
|
2015-11-22 17:19:35 +00:00
|
|
|
## System requirements
|
|
|
|
|
2017-10-04 01:07:12 +00:00
|
|
|
- A not too ancient Linux, or Windows 7 or later, or OSX 10.8 or later.
|
2015-11-22 17:19:35 +00:00
|
|
|
- A somewhat capable CPU. Hardware decoding might sometimes help if the CPU
|
|
|
|
is too slow to decode video realtime, but must be explicitly enabled with
|
2017-03-13 11:36:44 +00:00
|
|
|
the `--hwdec` option.
|
2015-11-22 17:19:35 +00:00
|
|
|
- A not too crappy GPU. mpv is not intended to be used with bad GPUs. There are
|
|
|
|
many caveats with drivers or system compositors causing tearing, stutter,
|
|
|
|
etc. On Windows, you might want to make sure the graphics drivers are
|
2017-03-13 11:36:44 +00:00
|
|
|
current. In some cases, ancient fallback video output methods can help
|
|
|
|
(such as `--vo=xv` on Linux), but this use is not recommended or supported.
|
2015-11-22 17:19:35 +00:00
|
|
|
|
|
|
|
|
2015-04-03 16:20:59 +00:00
|
|
|
## Downloads
|
|
|
|
|
2015-03-04 11:03:24 +00:00
|
|
|
|
|
|
|
For semi-official builds and third-party packages please see
|
|
|
|
[mpv.io](http://mpv.io/installation/).
|
2012-11-13 06:25:28 +00:00
|
|
|
|
2016-11-15 22:42:33 +00:00
|
|
|
## Changelog
|
|
|
|
|
|
|
|
|
2017-06-21 18:55:41 +00:00
|
|
|
There is no complete changelog; however, changes to the player core interface
|
2016-11-15 22:42:33 +00:00
|
|
|
are listed in the [interface changelog][interface-changes].
|
|
|
|
|
|
|
|
Changes to the C API are documented in the [client API changelog][api-changes].
|
|
|
|
|
|
|
|
The [release list][releases] has a summary of most of the important changes
|
|
|
|
on every release.
|
|
|
|
|
2017-06-21 18:55:41 +00:00
|
|
|
Changes to the default key bindings are indicated in
|
2016-11-15 22:42:33 +00:00
|
|
|
[restore-old-bindings.conf][restore-old-bindings].
|
|
|
|
|
2015-04-03 16:20:59 +00:00
|
|
|
## Compilation
|
|
|
|
|
2012-11-13 06:25:28 +00:00
|
|
|
|
|
|
|
Compiling with full features requires development files for several
|
2013-07-16 11:28:28 +00:00
|
|
|
external libraries. Below is a list of some important requirements.
|
|
|
|
|
2017-06-21 18:55:41 +00:00
|
|
|
The mpv build system uses *waf*, but we don't store it in your source tree. The
|
2013-07-16 11:28:28 +00:00
|
|
|
script './bootstrap.py' will download the latest version of waf that was tested
|
|
|
|
with the build system.
|
|
|
|
|
|
|
|
For a list of the available build options use `./waf configure --help`. If
|
|
|
|
you think you have support for some feature installed but configure fails to
|
|
|
|
detect it, the file `build/config.log` may contain information about the
|
|
|
|
reasons for the failure.
|
|
|
|
|
2013-12-14 13:59:07 +00:00
|
|
|
NOTE: To avoid cluttering the output with unreadable spam, `--help` only shows
|
|
|
|
one of the two switches for each option. If the option is autodetected by
|
|
|
|
default, the `--disable-***` switch is printed; if the option is disabled by
|
|
|
|
default, the `--enable-***` switch is printed. Either way, you can use
|
|
|
|
`--enable-***` or `--disable-**` regardless of what is printed by `--help`.
|
|
|
|
|
2013-11-23 10:14:22 +00:00
|
|
|
To build the software you can use `./waf build`: the result of the compilation
|
|
|
|
will be located in `build/mpv`. You can use `./waf install` to install mpv
|
|
|
|
to the *prefix* after it is compiled.
|
2013-07-16 11:28:28 +00:00
|
|
|
|
2017-06-02 19:13:29 +00:00
|
|
|
Example:
|
|
|
|
|
|
|
|
./bootstrap.py
|
|
|
|
./waf configure
|
|
|
|
./waf
|
|
|
|
./waf install
|
|
|
|
|
2012-11-13 06:25:28 +00:00
|
|
|
Essential dependencies (incomplete list):
|
|
|
|
|
|
|
|
- gcc or clang
|
2017-08-20 07:11:26 +00:00
|
|
|
- X development headers (xlib, xrandr, xext, xscrnsaver, xinerama, libvdpau,
|
2017-04-23 13:46:09 +00:00
|
|
|
libGL, GLX, EGL, xv, ...)
|
2015-01-20 14:19:24 +00:00
|
|
|
- Audio output development headers (libasound/ALSA, pulseaudio)
|
|
|
|
- FFmpeg libraries (libavutil libavcodec libavformat libswscale libavfilter
|
2017-10-30 19:55:42 +00:00
|
|
|
and either libswresample or libavresample) from ffmpeg-mpv or Libav
|
2015-02-09 19:41:25 +00:00
|
|
|
- zlib
|
|
|
|
- iconv (normally provided by the system libc)
|
2015-02-18 20:11:53 +00:00
|
|
|
- libass (OSD, OSC, text subtitles)
|
2015-01-30 10:13:14 +00:00
|
|
|
- Lua (optional, required for the OSC pseudo-GUI and youtube-dl integration)
|
2015-01-20 14:19:24 +00:00
|
|
|
- libjpeg (optional, used for screenshots only)
|
2015-11-16 15:24:26 +00:00
|
|
|
- uchardet (optional, for subtitle charset detection)
|
2015-01-20 14:19:24 +00:00
|
|
|
- vdpau and vaapi libraries for hardware decoding on Linux (optional)
|
2014-03-12 16:02:57 +00:00
|
|
|
|
|
|
|
Libass dependencies:
|
|
|
|
|
|
|
|
- gcc or clang, yasm on x86 and x86_64
|
|
|
|
- fribidi, freetype, fontconfig development headers (for libass)
|
2015-01-20 14:19:24 +00:00
|
|
|
- harfbuzz (optional, required for correct rendering of combining characters,
|
|
|
|
particularly for correct rendering of non-English text on OSX, and
|
|
|
|
Arabic/Indic scripts on any platform)
|
2014-03-12 16:02:57 +00:00
|
|
|
|
|
|
|
FFmpeg dependencies:
|
|
|
|
|
|
|
|
- gcc or clang, yasm on x86 and x86_64
|
2017-06-21 18:55:41 +00:00
|
|
|
- OpenSSL or GnuTLS (have to be explicitly enabled when compiling FFmpeg)
|
|
|
|
- libx264/libmp3lame/libfdk-aac if you want to use encoding (have to be
|
|
|
|
explicitly enabled when compiling FFmpeg)
|
2014-03-12 16:02:57 +00:00
|
|
|
- Libav also works, but some features will not work. (See section below.)
|
2012-11-13 06:25:28 +00:00
|
|
|
|
|
|
|
Most of the above libraries are available in suitable versions on normal
|
2017-10-30 19:55:42 +00:00
|
|
|
Linux distributions. However, FFmpeg is an exception - [ffmpeg-mpv][ffmpeg-mpv]
|
|
|
|
or Libav git master is required. For that reason you may want to use
|
2017-04-01 11:42:03 +00:00
|
|
|
the separately available build wrapper ([mpv-build][mpv-build]) that first
|
|
|
|
compiles FFmpeg libraries and libass, and then compiles the player statically
|
|
|
|
linked against those.
|
2012-11-13 06:25:28 +00:00
|
|
|
|
2015-01-20 14:19:24 +00:00
|
|
|
If you want to build a Windows binary, you either have to use MSYS2 and MinGW,
|
2017-04-01 11:42:03 +00:00
|
|
|
or cross-compile from Linux with MinGW. See
|
|
|
|
[Windows compilation][windows_compilation].
|
2015-01-20 14:19:24 +00:00
|
|
|
|
2015-11-22 17:19:35 +00:00
|
|
|
|
2015-04-03 16:20:59 +00:00
|
|
|
## FFmpeg vs. Libav
|
|
|
|
|
2013-10-25 19:23:22 +00:00
|
|
|
|
|
|
|
Generally, mpv should work with the latest release as well as the git version
|
|
|
|
of both FFmpeg and Libav. But FFmpeg is preferred, and some mpv features work
|
2015-04-10 10:50:02 +00:00
|
|
|
with FFmpeg only (subtitle formats in particular).
|
2013-10-25 19:23:22 +00:00
|
|
|
|
2014-05-20 00:31:44 +00:00
|
|
|
|
2016-03-07 13:44:14 +00:00
|
|
|
## Preferred FFmpeg version
|
|
|
|
|
2017-11-01 15:50:18 +00:00
|
|
|
Only [ffmpeg-mpv][ffmpeg-mpv] is supported. Upstream FFmpeg can be forced by
|
|
|
|
passing a certain switch to configure, but compilation or runtime behavior
|
|
|
|
might be broken at times.
|
|
|
|
|
|
|
|
_If_ you force upstream FFmpeg, and it doesn't work, please contact upstream
|
|
|
|
FFmpeg for help, instead of mpv. See
|
2017-11-24 23:11:02 +00:00
|
|
|
[FFmpeg contact](http://ffmpeg.org/contact.html#MailingLists) on how to contact
|
2017-11-01 15:50:18 +00:00
|
|
|
FFmpeg upstream.
|
2016-03-10 21:02:45 +00:00
|
|
|
|
2016-06-29 19:15:52 +00:00
|
|
|
## FFmpeg ABI compatibility
|
|
|
|
|
|
|
|
mpv does not support linking against FFmpeg versions it was not built with, even
|
|
|
|
if the linked version is supposedly ABI-compatible with the version it was
|
|
|
|
compiled against. Expect malfunctions, crashes, and security issues if you
|
|
|
|
do it anyway.
|
|
|
|
|
|
|
|
The reason for not supporting this is because it creates far too much complexity
|
|
|
|
with little to no benefit, coupled with absurd and unusable FFmpeg API
|
|
|
|
artifacts.
|
|
|
|
|
2016-07-01 23:12:26 +00:00
|
|
|
Newer mpv versions will refuse to start if runtime and compile time FFmpeg
|
2016-07-01 18:56:59 +00:00
|
|
|
library versions mismatch.
|
|
|
|
|
2016-03-07 13:44:14 +00:00
|
|
|
## Release cycle
|
2014-06-24 11:36:15 +00:00
|
|
|
|
2016-03-07 13:44:14 +00:00
|
|
|
Every other month, an arbitrary git snapshot is made, and is assigned
|
|
|
|
a 0.X.0 version number. No further maintenance is done.
|
2014-06-24 11:36:15 +00:00
|
|
|
|
2016-03-07 13:44:14 +00:00
|
|
|
The goal of releases is to make Linux distributions happy. Linux distributions
|
|
|
|
are also expected to apply their own patches in case of bugs and security
|
|
|
|
issues.
|
2014-05-20 00:31:44 +00:00
|
|
|
|
|
|
|
Releases other than the latest release are unsupported and unmaintained.
|
|
|
|
|
2014-06-24 11:36:15 +00:00
|
|
|
See the [release policy document][release-policy] for more information.
|
|
|
|
|
2015-04-03 16:20:59 +00:00
|
|
|
## Bug reports
|
|
|
|
|
2012-11-13 06:25:28 +00:00
|
|
|
|
2013-09-13 21:14:20 +00:00
|
|
|
Please use the [issue tracker][issue-tracker] provided by GitHub to send us bug
|
2017-06-21 18:55:41 +00:00
|
|
|
reports or feature requests. Follow the template's instructions or the issue
|
|
|
|
will likely be ignored or closed as invalid.
|
|
|
|
|
|
|
|
Using the bug tracker as place for simple questions is fine but IRC is
|
|
|
|
recommended (see [Contact](#Contact) below).
|
2012-11-13 06:25:28 +00:00
|
|
|
|
2015-04-03 16:20:59 +00:00
|
|
|
## Contributing
|
|
|
|
|
2012-11-13 06:25:28 +00:00
|
|
|
|
2017-10-09 14:00:08 +00:00
|
|
|
Please read [contribute.md][contribute.md].
|
|
|
|
|
2012-11-13 06:25:28 +00:00
|
|
|
For small changes you can just send us pull requests through GitHub. For bigger
|
|
|
|
changes come and talk to us on IRC before you start working on them. It will
|
|
|
|
make code review easier for both parties later on.
|
|
|
|
|
2017-06-21 19:52:55 +00:00
|
|
|
You can check [the wiki](https://github.com/mpv-player/mpv/wiki/Stuff-to-do)
|
|
|
|
or the [issue tracker](https://github.com/mpv-player/mpv/issues?q=is%3Aopen+is%3Aissue+label%3A%22feature+request%22)
|
|
|
|
for ideas on what you could contribute with.
|
|
|
|
|
2015-04-03 16:20:59 +00:00
|
|
|
## Relation to MPlayer and mplayer2
|
|
|
|
|
2017-06-27 09:36:20 +00:00
|
|
|
mpv is a fork of MPlayer. Much has changed, and in general, mpv should be
|
|
|
|
considered a completely new program, rather than a MPlayer drop-in replacement.
|
2015-03-04 11:03:24 +00:00
|
|
|
|
2017-06-27 09:36:20 +00:00
|
|
|
For details see [FAQ entry](https://github.com/mpv-player/mpv/wiki/FAQ#How_is_mpv_related_to_MPlayer).
|
2015-03-04 11:03:24 +00:00
|
|
|
|
|
|
|
If you are wondering what's different from mplayer2 and MPlayer, an incomplete
|
2017-06-21 18:55:41 +00:00
|
|
|
and largely unmaintained list of changes is located [here][mplayer-changes].
|
2015-03-04 11:03:24 +00:00
|
|
|
|
2017-10-09 14:00:08 +00:00
|
|
|
## License
|
|
|
|
|
2017-10-13 13:37:55 +00:00
|
|
|
GPLv2 "or later" by default, LGPLv2.1 "or later" with `--enable-lgpl`.
|
|
|
|
See [details.](https://github.com/mpv-player/mpv/blob/master/Copyright)
|
2017-10-09 14:00:08 +00:00
|
|
|
|
|
|
|
|
2015-04-03 16:20:59 +00:00
|
|
|
## Contact
|
|
|
|
|
2012-11-13 06:25:28 +00:00
|
|
|
|
2017-06-21 18:55:41 +00:00
|
|
|
Most activity happens on the IRC channel and the github issue tracker.
|
2013-09-13 21:14:20 +00:00
|
|
|
|
2015-06-17 20:23:08 +00:00
|
|
|
- **GitHub issue tracker**: [issue tracker][issue-tracker] (report bugs here)
|
2015-04-27 21:02:40 +00:00
|
|
|
- **User IRC Channel**: `#mpv` on `irc.freenode.net`
|
|
|
|
- **Developer IRC Channel**: `#mpv-devel` on `irc.freenode.net`
|
2013-09-13 21:14:20 +00:00
|
|
|
|
2014-11-22 13:37:57 +00:00
|
|
|
To contact the `mpv` team in private write to `mpv-team@googlegroups.com`. Use
|
|
|
|
only if discretion is required.
|
2012-11-13 06:25:28 +00:00
|
|
|
|
2015-03-04 11:03:24 +00:00
|
|
|
[releases]: https://github.com/mpv-player/mpv/releases
|
2013-05-19 07:19:29 +00:00
|
|
|
[mpv-build]: https://github.com/mpv-player/mpv-build
|
|
|
|
[homebrew-mpv]: https://github.com/mpv-player/homebrew-mpv
|
2013-09-13 21:14:20 +00:00
|
|
|
[issue-tracker]: https://github.com/mpv-player/mpv/issues
|
2013-10-25 19:23:22 +00:00
|
|
|
[ffmpeg_vs_libav]: https://github.com/mpv-player/mpv/wiki/FFmpeg-versus-Libav
|
2014-06-30 21:23:50 +00:00
|
|
|
[release-policy]: https://github.com/mpv-player/mpv/blob/master/DOCS/release-policy.md
|
2015-01-20 14:19:24 +00:00
|
|
|
[windows_compilation]: https://github.com/mpv-player/mpv/blob/master/DOCS/compile-windows.md
|
2015-03-04 11:03:24 +00:00
|
|
|
[mplayer-changes]: https://github.com/mpv-player/mpv/blob/master/DOCS/mplayer-changes.rst
|
2016-11-15 22:42:33 +00:00
|
|
|
[interface-changes]: https://github.com/mpv-player/mpv/blob/master/DOCS/interface-changes.rst
|
|
|
|
[api-changes]: https://github.com/mpv-player/mpv/blob/master/DOCS/client-api-changes.rst
|
|
|
|
[restore-old-bindings]: https://github.com/mpv-player/mpv/blob/master/etc/restore-old-bindings.conf
|
2017-10-09 14:00:08 +00:00
|
|
|
[contribute.md]: https://github.com/mpv-player/mpv/blob/master/DOCS/contribute.md
|
2017-10-30 19:55:42 +00:00
|
|
|
[ffmpeg-mpv]: https://github.com/mpv-player/ffmpeg-mpv
|