🔨 Helper scripts to compile mpv on Linux
This is a collection of scripts to make downloading and building mpv, ffmpeg and libass easier. ffmpeg and libass get special treatment, because they are essential, and distribution packages are often too old or too broken.
Make sure git is installed. Also check that the dependencies listed in the next section are installed.
Checkout the build repo::
git clone https://github.com/mpv-player/mpv-build.git
To get the ffmpeg, libass and mpv sources and build them, run the command::
-j4asks it to use 4 parallel processes.
Note that this command implicitly does an update followed by a full cleanup (even if nothing changes), which is supposed to reduce possible problems with incremental builds. You can do incremental builds by explicitly calling
./build. This can be faster on minor updates, but breaks sometimes, e.g. the FFmpeg build system can sometimes be a bit glitchy.
Install mpv with::
mpv doesn't need to be installed. The binary ./mpv/build/mpv can be used as-is. You can copy it to /usr/local/bin manually. Note that libass and ffmpeg will be statically linked with mpv when using the provided scripts, and no ffmpeg or libass libraries are/need to be installed. There are no required config or data files either.
Essential dependencies (incomplete list):
Note: most dependencies are optional and autodetected. If they're missing, these features will be disabled silently. This includes some dependencies which could be considered essential.
ffmpeg doesn't autodetect many dependencies. Instead, it requires you to enable them explicitly at configuration time. (And it will simply fail if the dependencies are not available.)
You can put additional ffmpeg configure flags into ffmpeg_options. For example, to enable some dependencies needed for encoding::
echo --enable-libx264 >> ffmpeg_options
echo --enable-libmp3lame >> ffmpeg_options
echo --enable-libfdk-aac >> ffmpeg_options
Do this in the mpv-build top-level directory (the same that contains the build scripts and this readme file). It must be done prior running ./build or ./rebuild.
To help track dependencies and installed files, there is the option to create a Debian package containing the mpv binary and documentation. This is considered advanced usage and you may experience problems if you have weird third party repositories enabled or use exotic Debian derivatives. This procedure is regularly tested on Debian Sid.
Install some basic packaging tools with the command::
apt-get install devscripts equivs
In the mpv-build root directory, create and install a dummy build dependency package::
mk-build-deps -s sudo -i
You can now build the mpv Debian package with the following command::
dpkg-buildpackage -uc -us -b -j4
Adjust the "4" to your number of available processors as appropriate. On completion, the file mpv.deb will be created in the parent directory. Install it with::
sudo dpkg -i ../mpv__.deb
where you must replace with the version of mpv you just built (as indicated in debian/changelog) and with your architecture.
To keep your package up to date, simply repeat the above commands after running the
./updatescript in the mpv-build root directory from time to time.
Making local changes to the created git repositories is generally discouraged. Updating might remove local changes or conflict with them. Sometimes the repositories might be wiped entirely. If you make local changes, always keep them in a separate repository and merge them after updating.
In general, changes to the mpv-build repository itself are relatively safe, keeping branches in sub-repositories might be ok, and making local, uncommitted changes in sub-repositories will break.
By default, mpv, ffmpeg and libass use the git master versions. These are bleeding edge, but should usually work fine. To get a stable (slightly stale) version, you can use release versions. Note that at least for mpv, releases are not actually maintained - releases are for Linux distributions, which are expected to maintain them and to backport bug fixes (which they usually fail to do).
The following command can be used to delete all local changes, and to checkout the latest release version of mpv::
./rebuildor similar. Use this to switch back to git master::
Or this to switch to a custom tag/branch/commit FOO::
Likewise, you can use
./use-ffmpeg-custom BARto switch between git master, the latest FFmpeg release, or to a custom tag/branch/commit BAR.
Use on your own risk.
ffmpeg_options, the file
mpv_optionsin the mpv-build top-level directory can be used to set custom mpv configure options prior to compiling. Like with ffmpeg_option, it expects one switch per line (e.g.
But normally, you shouldn't need this.
You can enable building libmpv by enabling the configure option::
echo --enable-libmpv-shared > mpv_options
Note that this will make the mpv-build scripts also enable PIC for all used libraries. For this reason, be sure to run
The Debian packaging scripts do not currently support libmpv.
You can find us on IRC in
Report bugs to the
issues tracker_ provided by GitHub to send us bug reports or feature requests.
.. _issues tracker: https://github.com/mpv-player/mpv/issues