mirror of https://github.com/mpv-player/mpv
215 lines
6.8 KiB
Markdown
215 lines
6.8 KiB
Markdown
Compiling for Windows
|
|
=====================
|
|
|
|
Compiling for Windows is supported with MinGW-w64. This can be used to produce
|
|
both 32-bit and 64-bit executables, and it works for building on Windows and
|
|
cross-compiling from Linux and Cygwin. MinGW-w64 is available from:
|
|
http://mingw-w64.sourceforge.net.
|
|
|
|
While building a complete MinGW-w64 toolchain yourself is possible, there are a
|
|
few build environments and scripts to help ease the process, such as MSYS2 and
|
|
MXE. Note that MinGW environments included in Linux distributions are often
|
|
broken, outdated and useless, and usually don't use MinGW-w64.
|
|
|
|
**Warning**: the original MinGW (http://www.mingw.org) is unsupported.
|
|
|
|
Cross-compilation
|
|
=================
|
|
|
|
When cross-compiling, you have to run mpv's configure with these arguments:
|
|
|
|
```bash
|
|
DEST_OS=win32 TARGET=i686-w64-mingw32 ./waf configure
|
|
```
|
|
|
|
[MXE](http://mxe.cc) makes it very easy to bootstrap a complete MingGW-w64
|
|
environment from a Linux machine. See a working example below.
|
|
|
|
Alternatively, you can try [mingw-w64-cmake](https://github.com/lachs0r/mingw-w64-cmake),
|
|
which bootstraps a MinGW-w64 environment and builds mpv and dependencies.
|
|
|
|
Example with MXE
|
|
----------------
|
|
|
|
```bash
|
|
# Before starting, make sure you install MXE prerequisites. MXE will download
|
|
# and build all target dependencies, but no host dependencies. For example,
|
|
# you need a working compiler, or MXE can't build the crosscompiler.
|
|
#
|
|
# Refer to
|
|
#
|
|
# http://mxe.cc/#requirements
|
|
#
|
|
# Scroll down for disto/OS-specific instructions to install them.
|
|
|
|
# Download MXE. Note that compiling the required packages requires about 1.4 GB
|
|
# or more!
|
|
|
|
cd /opt
|
|
git clone https://github.com/mxe/mxe mxe
|
|
cd mxe
|
|
|
|
# Set build options.
|
|
|
|
# The JOBS environment variable controls threads to use when building. DO NOT
|
|
# use the regular `make -j4` option with MXE as it will slow down the build.
|
|
# Alternatively, you can set this in the make command by appending "JOBS=4"
|
|
# to the end of command:
|
|
echo "JOBS := 4" >> settings.mk
|
|
|
|
# The MXE_TARGET environment variable builds MinGW-w64 for 32 bit targets.
|
|
# Alternatively, you can specify this in the make command by appending
|
|
# "MXE_TARGETS=i686-w64-mingw32" to the end of command:
|
|
echo "MXE_TARGETS := i686-w64-mingw32.static" >> settings.mk
|
|
|
|
# If you want to build 64 bit version, use this:
|
|
# echo "MXE_TARGETS := x86_64-w64-mingw32.static" >> settings.mk
|
|
|
|
# Build required packages. The following provide a minimum required to build
|
|
# a reasonable mpv binary (though not an absolute minimum).
|
|
|
|
make gcc ffmpeg libass jpeg lua
|
|
|
|
# Add MXE binaries to $PATH
|
|
export PATH=/opt/mxe/usr/bin/:$PATH
|
|
|
|
# Build mpv. The target will be used to automatically select the name of the
|
|
# build tools involved (e.g. it will use i686-w64-mingw32.static-gcc).
|
|
|
|
cd ..
|
|
git clone https://github.com/mpv-player/mpv.git
|
|
cd mpv
|
|
python ./bootstrap.py
|
|
DEST_OS=win32 TARGET=i686-w64-mingw32.static ./waf configure
|
|
# Or, if 64 bit version,
|
|
# DEST_OS=win32 TARGET=x86_64-w64-mingw32.static ./waf configure
|
|
./waf build
|
|
```
|
|
|
|
Native compilation with MSYS2
|
|
=============================
|
|
|
|
For Windows developers looking to get started quickly, MSYS2 can be used to
|
|
compile mpv natively on a Windows machine. The MSYS2 repositories have binary
|
|
packages for most of mpv's dependencies, so the process should only involve
|
|
building mpv itself.
|
|
|
|
To build 64-bit mpv on Windows:
|
|
|
|
Installing MSYS2
|
|
----------------
|
|
|
|
1. Download an installer from https://msys2.github.io/
|
|
|
|
It doesn't matter whether the i686 or the x86_64 version is used. Both can
|
|
build 32-bit and 64-bit binaries when running on a 64-bit version of Windows.
|
|
|
|
2. Start a MinGW-w64 shell (``mingw64.exe``). Note that this is different
|
|
from the MSYS2 shell that is started from the final installation dialog.
|
|
|
|
For a 32-bit build, use ``mingw32.exe``.
|
|
|
|
Updating MSYS2
|
|
--------------
|
|
|
|
To prevent errors during post-install, the MSYS2 core runtime must be updated
|
|
separately.
|
|
|
|
```bash
|
|
# Check for core updates. If instructed, close the shell window and reopen it
|
|
# before continuing.
|
|
pacman -Syu
|
|
|
|
# Update everything else
|
|
pacman -Su
|
|
```
|
|
|
|
Installing mpv dependencies
|
|
---------------------------
|
|
|
|
```bash
|
|
# Install MSYS2 build dependencies and a MinGW-w64 compiler
|
|
pacman -S git mingw-w64-x86_64-pkg-config python mingw-w64-x86_64-gcc
|
|
|
|
# Install the most important MinGW-w64 dependencies. libass, libbluray and
|
|
# lcms2 are also pulled in as dependencies of ffmpeg.
|
|
pacman -S mingw-w64-x86_64-ffmpeg mingw-w64-x86_64-libjpeg-turbo mingw-w64-x86_64-lua51
|
|
|
|
# Install additional (optional) dependencies
|
|
pacman -S mingw-w64-x86_64-libdvdnav mingw-w64-x86_64-libguess mingw-w64-x86_64-angleproject-git
|
|
```
|
|
|
|
For a 32-bit build, install ``mingw-w64-i686-*`` packages instead.
|
|
|
|
Building mpv
|
|
------------
|
|
|
|
Clone the latest mpv from git and install waf:
|
|
|
|
```bash
|
|
git clone https://github.com/mpv-player/mpv.git && cd mpv
|
|
./bootstrap.py
|
|
```
|
|
|
|
Finally, compile and install mpv. Binaries will be installed to
|
|
``/mingw64/bin``.
|
|
|
|
```bash
|
|
# For a 32-bit build, use --prefix=/mingw32 instead
|
|
./waf configure CC=gcc.exe --check-c-compiler=gcc --prefix=/mingw64
|
|
./waf install
|
|
```
|
|
|
|
Or, compile and install both libmpv and mpv:
|
|
|
|
```bash
|
|
./waf configure CC=gcc.exe --check-c-compiler=gcc --enable-libmpv-shared --prefix=/mingw64
|
|
./waf install
|
|
|
|
# waf installs libmpv dll to the wrong directory, so fix it up
|
|
mv -f /mingw64/lib/mpv-1.dll /mingw64/bin/
|
|
```
|
|
|
|
Linking libmpv with MSVC programs
|
|
---------------------------------
|
|
|
|
You can build C++ programs in Visual Studio and link them with libmpv. To do
|
|
this, you need a Visual Studio which supports ``stdint.h`` (recent ones do),
|
|
and you need to create a import library for the mpv DLL:
|
|
|
|
```bash
|
|
lib /def:mpv.def /name:mpv-1.dll /out:mpv.lib /MACHINE:X64
|
|
```
|
|
|
|
The string in the ``/name:`` parameter must match the filename of the DLL (this
|
|
is simply the filename the MSVC linker will use). The ``mpv.def`` can be
|
|
retrieved from the mpv build directory, or can be produced by MingGW's
|
|
gendef.exe helper from the mpv DLL.
|
|
|
|
Static linking is not possible.
|
|
|
|
Running mpv
|
|
-----------
|
|
|
|
If you want to run mpv from the MinGW-w64 shell, you will find the experience
|
|
much more pleasant if you use the ``winpty`` utility
|
|
|
|
```bash
|
|
pacman -S winpty
|
|
winpty mpv.com ToS-4k-1920.mov
|
|
```
|
|
|
|
If you want to move / copy ``mpv.exe`` and ``mpv.com`` to somewhere other than
|
|
``/mingw64/bin/`` for use outside the MinGW-w64 shell, they will still depend on
|
|
DLLs in that folder. The simplest solution is to add ``C:\msys64\mingw64\bin``
|
|
to the windows system ``%PATH%``. Beware though that this can cause problems or
|
|
confusion in Cygwin if that is also installed on the machine.
|
|
|
|
Use of the ANGLE OpenGL backend requires a copy of the D3D compiler DLL that
|
|
matches the version of the D3D SDK that ANGLE was built with
|
|
(``d3dcompiler_43.dll`` in case of MinGW-built ANGLE) in the path or in the
|
|
same folder as mpv. It must be of the same architecture (x86_64 / i686) as the
|
|
mpv you compiled. You can find copies here:
|
|
|
|
https://mpv.srsfckn.biz/d3dcompiler.7z
|