Difference between revisions of "Win32Compile"

From VideoLAN Wiki
Jump to navigation Jump to search
(pkgconfig files also contain absolute paths)
Line 1: Line 1:
−
From http://developers.videolan.org/vlc/vlc/INSTALL.win32
+
== Before you start ==
  
−
$Id: INSTALL.win32 15707 2006-05-22 09:42:08Z xtophe $
+
One common desire that leads people to want to rebuild VLC is to "rebuild a debug version" or "add printf()s", but this is not strictly necessary, as VLC includes a debug logging feature by default. If you are using a binary release (or have already built VLC), just run <code>'vlc.exe'</code> and select "Messages..." from the "Tools" menu.
−
INSTALL file for the Windows9x/Me/NT4/2k/XP version of the VLC media player
 
  
−
==Before you start==
+
You can also run VLC from the Windows command-line interpreter, <code>cmd.exe</code> (a.k.a. "DOS window"), in which case you'll be able to use the command-line arguments. You can obtain a list of these command line arguments by typing <code>'vlc --help'</code> or <code>'vlc --help --advanced'</code>.
  
−
One common desire that leads people to want to rebuild VLC is to "rebuild a debug version" or "add printf()s", but this is not strictly necessary, as VLC includes a debug logging feature by default.  If you are using a binary release (or have already built VLC), just run <CODE>'vlc.exe'</CODE> and select "Messages..." from the "Tools" menu.
+
To store a debug log of the current VLC session, you can use <code>'vlc -vvv --extraintf=logger'</code>. You will end-up with a <code>vlc-log.txt</code> file in your current directory.  
  
−
You can also run VLC from the Windows command-line interpreter, <CODE>cmd.exe</CODE> (a.k.a. "DOS window"), in which case you'll be able to use the command-line arguments. You can obtain a list of these command line arguments by typing <CODE>'vlc --help'</CODE> or <CODE>'vlc --help --advanced'</CODE>.
+
== Building VLC from source ==
  
−
To store a debug log of the current VLC session, you can use <CODE>'vlc -vvv --extraintf=logger'</CODE>. You will end-up with a <CODE>vlc-log.txt</CODE> file in your current directory.
+
If you want to build VLC from source, you have several choices:  
−
 
 
−
==Building VLC from source==
 
−
 
 
−
If you want to build VLC from source, you have several choices:
 
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! Method
 
−
! Documentation
 
−
! Notes
 
 
|-
 
|-
−
| Cross-compile with mingw32 on GNU/Linux
+
! Method
−
| None
+
! Documentation
 +
! Notes
 +
|-
 +
| Cross-compile with Mingw32 on Linux  
 +
| None  
 
| '''Preferred''' method (uses cross compilation)
 
| '''Preferred''' method (uses cross compilation)
 
|-
 
|-
−
| Native-compile with [http://www.mingw.org MSYS+MINGW]
+
| Native-compile with [http://www.mingw.org MSYS+MINGW]  
−
| [[Win32CompileMSYSNew]]
+
| [[Win32CompileMSYSNew]]  
 
| '''Preferred''' native compilation method. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows. It provides all the commonly-required Unix tools (like sh, gmake, and so forth).
 
| '''Preferred''' native compilation method. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows. It provides all the commonly-required Unix tools (like sh, gmake, and so forth).
 
|-
 
|-
−
| Native-compile with [http://www.cygwin.com Cygwin]
+
| Native-compile with [http://www.cygwin.com Cygwin]  
−
| [[Win32CompileCygwinNew]]
+
| [[Win32CompileCygwinNew]]  
−
| '''Working''' native compilation method
+
| '''OUTDATED''' native compilation method
 
|-
 
|-
−
| Native-compile with Microsoft Visual C++
+
| Native-compile with Microsoft Visual C++  
−
| None
+
| None  
−
|
+
| '''Not advised.'''  
−
'''Not advised.''' <P>
+
Even though VLC includes some MSVC project files, this method is advised only if you just want to experiment/play with some basic functionality in VLC. VLC depends on a lot of third-party libraries and building them in MSVC is inconvenient (and in some cases, impossible). <br> If you want to run VLC under the MSVC debugger, use <code>--fast-mutex --win9x-cv-method=1</code> because the debugger usually loses signals sent by PulseEvent().
−
Even though VLC includes some MSVC project files, this method is advised only if you just want to experiment/play with some basic functionality in VLC. VLC depends on a lot of third-party libraries and building them in MSVC is inconvenient (and in some cases, impossible). <BR>  
+
 
−
If you want to run VLC under the MSVC debugger, use <CODE>--fast-mutex --win9x-cv-method=1</CODE> because the debugger usually loses signals sent by PulseEvent().
 
 
|}
 
|}
  
−
==Obtaining the build tools==
+
== Obtaining the build tools ==
  
−
Each build method requires its own toolchain:
+
Each build method requires its own toolchain:  
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! Method
 
−
! Notes
 
 
|-
 
|-
−
| Cross-compile with mingw32 on GNU/Linux
+
! Method
−
|
+
! Notes
−
*Debian/Ubuntu users can <CODE>apt-get install mingw32 mingw32-binutils</CODE>, however building FFmpeg now requires mingw32-runtime >= 3.15 and w32api >= 3.13 so these will have to be updated manually.
+
|-
−
*Gentoo users can <CODE>emerge crossdev && crossdev mingw32</CODE>
+
| Cross-compile with mingw32 on GNU/Linux  
 +
|  
 +
*Debian/Ubuntu users can <code>apt-get install mingw32 mingw32-binutils</code>, however building FFmpeg now requires mingw32-runtime &gt;= 3.15 and w32api &gt;= 3.13 so these will have to be updated manually.  
 +
*Gentoo users can <code>emerge crossdev &amp;&amp; crossdev mingw32</code>  
 
*Other systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW
 
*Other systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW
 +
 
|-
 
|-
−
| Native-compile with [http://www.mingw.org MSYS+MINGW]
+
| Native-compile with [http://www.mingw.org MSYS+MINGW]  
 
| Read the [[Win32CompileMSYSNew|documentation]]
 
| Read the [[Win32CompileMSYSNew|documentation]]
 
|-
 
|-
−
| Native-compile with [http://www.cygwin.com Cygwin]
+
| Native-compile with [http://www.cygwin.com Cygwin]  
 
| Read the [[Win32CompileCygwinNew|documentation]]
 
| Read the [[Win32CompileCygwinNew|documentation]]
−
|-
 
−
 
 
|}
 
|}
  
−
==Saving time by using pre-built libraries==
+
== Saving time by using pre-built libraries ==
  
−
VLC requires other open source projects to provide some features (like AC3 audio decoding and MPEG-4 video decoding). A complete list of required libraries from these projects can be found at http://developers.videolan.org/vlc/. Depending on your needs, you must either build your own versions of these libraries or use VLC's convenient pre-built versions.
+
VLC requires other open source projects to provide some features (like AC3 audio decoding and MPEG-4 video decoding). A complete list of required libraries from these projects can be found at http://developers.videolan.org/vlc/. Depending on your needs, you must either build your own versions of these libraries or use VLC's convenient pre-built versions.  
  
−
If you feel you must build these libraries from source, the blessed source code may be found at http://download.videolan.org/pub/testing/contrib/. An automated way of building the contrib libraries is provided in extra/contrib. It will download, configure, and build the libraries. See the extras/contrib/README for more info.
+
If you feel you must build these libraries from source, the blessed source code may be found at http://download.videolan.org/pub/testing/contrib/. An automated way of building the contrib libraries is provided in extra/contrib. It will download, configure, and build the libraries. See the extras/contrib/README for more info.  
  
−
If you want to save yourself time and energy by using the pre-built versions of these libraries, you may download them from http://people.videolan.org/~jb/Contribs/, named in fashion of contrib-'''yyyymmdd'''-win32-'''version'''-bin-gcc-'''gccversion'''-only.tar.bz2 . The pre-built versions will ''only work with MINGW or Cygwin''. Note that the version you download must match that of the MINGW compiler, <CODE>i586-mingw32msvc-gcc</CODE>, which you can verify by typing <CODE>'i586-mingw32msvc-gcc --ver'</CODE>.
+
If you want to save yourself time and energy by using the pre-built versions of these libraries, you may download them from http://people.videolan.org/~jb/Contribs/, named in fashion of contrib-'''yyyymmdd'''-win32-'''version'''-bin-gcc-'''gccversion'''-only.tar.bz2 . The pre-built versions will ''only work with MINGW or Cygwin''. Note that the version you download must match that of the MINGW compiler, <code>i586-mingw32msvc-gcc</code>, which you can verify by typing <code>'i586-mingw32msvc-gcc --ver'</code>.  
  
−
There are two installation strategies:
+
There are two installation strategies:  
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! Location
 
−
! Command
 
−
! Advantages
 
−
! Disadvantages
 
 
|-
 
|-
−
| Install the pre-built libraries into the Cygwin standard directories (/usr/win32/*)
+
! Location
−
| <CODE>tar jxf contrib-20061122-win32-bin-gcc-3.4.5-only.tar.bz2 -C /</CODE> (Note the <CODE>"-C /"</CODE>!)
+
! Command
−
|
+
! Advantages
 +
! Disadvantages
 +
|-
 +
| Install the pre-built libraries into the Cygwin standard directories (/usr/win32/*)  
 +
| <code>tar jxf contrib-20061122-win32-bin-gcc-3.4.5-only.tar.bz2 -C /</code> (Note the <code>"-C /"</code>!)  
 +
|  
 
*Shorter initial setup time
 
*Shorter initial setup time
−
|
+
 
−
*May conflict with other headers/libraries in the standard directories
+
|  
 +
*May conflict with other headers/libraries in the standard directories  
 
*Difficult to get rid of if you want to free up space or to upgrade to the next version of the pre-built libraries (Installing over the top of older versions is highly discouraged!)
 
*Difficult to get rid of if you want to free up space or to upgrade to the next version of the pre-built libraries (Installing over the top of older versions is highly discouraged!)
 +
 
|-
 
|-
−
| Install the pre-built libraries into a project-specific directory (e.g., <CODE>D:\VLC</CODE>)
+
| Install the pre-built libraries into a project-specific directory (e.g., <code>D:\VLC</code>)  
−
| <CODE>tar jxf contrib-20061122-win32-bin-gcc-3.4.5-only.tar.bz2 -C /cygdrive/d/VLC</CODE>
+
| <code>tar jxf contrib-20061122-win32-bin-gcc-3.4.5-only.tar.bz2 -C /cygdrive/d/VLC</code>  
−
|
+
|  
−
*No conflicts with other projects built under Cygwin
+
*No conflicts with other projects built under Cygwin  
−
*Easy to get rid of if you want to free up space or to upgrade to the next version of the pre-built libraries
+
*Easy to get rid of if you want to free up space or to upgrade to the next version of the pre-built libraries  
 
*For multi-person projects, easy to put under revision control to ensure all project members are using the correct pre-built versions
 
*For multi-person projects, easy to put under revision control to ensure all project members are using the correct pre-built versions
−
|
+
 
−
*Requires that you set <CODE>CPPFLAGS</CODE>, <CODE>LDFLAGS</CODE> appropriately when building
+
|  
 +
*Requires that you set <code>CPPFLAGS</code>, <code>LDFLAGS</code> appropriately when building  
 
*Requires that you modify hard-coded paths in the pre-built libraries (see below)
 
*Requires that you modify hard-coded paths in the pre-built libraries (see below)
 +
 
|}
 
|}
  
−
If installing into a project-specific directory, you must modify some hard-coded paths in the pre-build libraries as follows:
+
If installing into a project-specific directory, you must modify some hard-coded paths in the pre-build libraries as follows:  
−
<PRE>
+
<pre>CONTRIBS=/cygdrive/d/VLC
−
CONTRIBS=/cygdrive/d/VLC
+
for file in $CONTRIBS/bin/*-config $CONTRIBS/lib/*.la $CONTRIBS/lib/pkgconfig/*.pc&nbsp;; do
−
for file in $CONTRIBS/bin/*-config $CONTRIBS/lib/*.la $CONTRIBS/lib/pkgconfig/*.pc ; do
 
 
perl -i.bak -p -e 's|/usr/win32|$ENV{"CONTRIBS"}|g' $file
 
perl -i.bak -p -e 's|/usr/win32|$ENV{"CONTRIBS"}|g' $file
 
done
 
done
−
</PRE>
+
</pre>  
 +
== Configuring the build ==
  
−
==Configuring the build==
+
Once you've got all the files you need in place, you need to configure the build with the <code>configure</code> script. In the following examples, assume that the third-party libraries are installed in <code>$CONTRIBS</code>. If installed in the Cygwin standard directories, use <code>export CONTRIBS=/usr/win32</code>. Otherwise use <code>export CONTRIBS=/cygdrive/d/VLC</code>.
  
−
Once you've got all the files you need in place, you need to configure the build with the <CODE>configure</CODE> script.  In the following examples, assume that the third-party libraries are installed in <CODE>$CONTRIBS</CODE>.  If installed in the Cygwin standard directories, use <CODE>export CONTRIBS=/usr/win32</CODE>. Otherwise use <CODE>export CONTRIBS=/cygdrive/d/VLC</CODE>.
+
If you are cross-compiling under GNU/Linux, you can use something along these lines:
  
−
If you are cross-compiling under GNU/Linux, you can use something along these lines:
+
   ./bootstrap &amp;&amp; \
−
 
 
−
   ./bootstrap && \
 
 
   export PKG_CONFIG_LIBDIR=$CONTRIBS/lib/pkgconfig PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 
   export PKG_CONFIG_LIBDIR=$CONTRIBS/lib/pkgconfig PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 
   CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=i586-mingw32msvc-cpp \
 
   CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=i586-mingw32msvc-cpp \
Line 119: Line 117:
 
   CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++
 
   CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++
 
   ./configure --host=i586-mingw32msvc --build=i386-linux \
 
   ./configure --host=i586-mingw32msvc --build=i386-linux \
−
       --disable-[[gtk]] \
+
       --disable-[[Gtk]] \
−
       --enable-[[nls]] --enable-[[sdl]] --with-sdl-config-path=$CONTRIBS/bin \
+
       --enable-[[Nls]] --enable-[[Sdl]] --with-sdl-config-path=$CONTRIBS/bin \
−
       --enable-[[ffmpeg]] --with-ffmpeg-mp3lame --with-ffmpeg-[[faac]] \
+
       --enable-[[Ffmpeg]] --with-ffmpeg-mp3lame --with-ffmpeg-[[Faac]] \
−
       --with-ffmpeg-[[zlib]] --enable-[[faad]] --enable-[[flac]] --enable-[[theora]] \
+
       --with-ffmpeg-[[Zlib]] --enable-[[Faad]] --enable-[[Flac]] --enable-[[Theora]] \
−
       --with-[[wx]]-config-path=$CONTRIBS/bin \
+
       --with-[[Wx]]-config-path=$CONTRIBS/bin \
−
       --with-[[freetype]]-config-path=$CONTRIBS/bin \
+
       --with-[[Freetype]]-config-path=$CONTRIBS/bin \
−
       --with-[[fribidi]]-config-path=$CONTRIBS/bin \
+
       --with-[[Fribidi]]-config-path=$CONTRIBS/bin \
−
       --with-[[libgcrypt]]-prefix=$CONTRIBS \
+
       --with-[[Libgcrypt]]-prefix=$CONTRIBS \
−
       --enable-[[live555]] --with-live555-tree=$CONTRIBS/live.com \
+
       --enable-[[Live555]] --with-live555-tree=$CONTRIBS/live.com \
−
       --enable-[[caca]] --with-caca-config-path=$CONTRIBS/bin \
+
       --enable-[[Caca]] --with-caca-config-path=$CONTRIBS/bin \
−
       --with-[[xml2]]-config-path=$CONTRIBS/bin \
+
       --with-[[Xml2]]-config-path=$CONTRIBS/bin \
−
       --with-[[dvdnav]]-config-path=$CONTRIBS/bin \
+
       --with-[[Dvdnav]]-config-path=$CONTRIBS/bin \
−
       --disable-[[cddax]] --disable-[[vcdx]] --enable-[[goom]] \
+
       --disable-[[Cddax]] --disable-[[Vcdx]] --enable-[[Goom]] \
−
       --enable-[[twolame]] --enable-[[dvdread]] \
+
       --enable-[[Twolame]] --enable-[[Dvdread]] \
−
       --enable-[[debug]]
+
       --enable-[[Debug]]
  
−
If you are using cygwin, you can build VLC with or without the POSIX emulation layer. Without is usually better and with POSIX emulation hasn't been tested in over a year. So to build without the emulation layer, use something like this:
+
If you are using cygwin, you can build VLC with or without the POSIX emulation layer. Without is usually better and with POSIX emulation hasn't been tested in over a year. So to build without the emulation layer, use something like this:  
  
−
   ./bootstrap && \
+
   ./bootstrap &amp;&amp; \
 
   export PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 
   export PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 
   CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=$CPPFLAGS \
 
   CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=$CPPFLAGS \
Line 158: Line 156:
 
       --enable-debug
 
       --enable-debug
  
−
If you want to use the emulation layer, then just omit <CODE>CFLAGS</CODE> and <CODE>CXXFLAGS</CODE>. You're on your own, though.
+
If you want to use the emulation layer, then just omit <code>CFLAGS</code> and <code>CXXFLAGS</code>. You're on your own, though.  
  
−
If you are compiling with MSYS/MINGW, then you can use something along those lines:
+
If you are compiling with MSYS/MINGW, then you can use something along those lines:  
−
   ./bootstrap && \
+
 
 +
   ./bootstrap &amp;&amp; \
 
   export PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 
   export PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 
   CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=$CPPFLAGS \
 
   CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=$CPPFLAGS \
Line 178: Line 177:
 
       --disable-cddax --disable-vcdx --enable-goom \
 
       --disable-cddax --disable-vcdx --enable-goom \
 
       --enable-twolame --enable-dvdread \
 
       --enable-twolame --enable-dvdread \
−
       --disable-[[mkv]] \
+
       --disable-[[Mkv]] \
 
       --enable-debug
 
       --enable-debug
  
−
If you have used the "extras/contrib" way, you don't need to specify <CODE>CFLAGS</CODE>, <CODE>LDFLAGS</CODE> and <CODE>--with-foo-config-path=</CODE>.
+
If you have used the "extras/contrib" way, you don't need to specify <code>CFLAGS</code>, <code>LDFLAGS</code> and <code>--with-foo-config-path=</code>.  
−
  ./bootstrap && \
+
 
 +
  ./bootstrap &amp;&amp; \
 
   ./configure \
 
   ./configure \
 
       --disable-gtk \
 
       --disable-gtk \
Line 192: Line 192:
 
       --enable-debug
 
       --enable-debug
  
−
See <CODE>'./configure --help'</CODE> for more information.
+
See <code>'./configure --help'</code> for more information.  
  
−
==Building VLC==
+
== Building VLC ==
  
−
Once configured, to build VLC, just run <CODE>'make'</CODE>.
+
Once configured, to build VLC, just run <code>'make'</code>.  
  
−
Once the compilation is done, you can either run VLC directly from the source tree or you can build self-contained VLC packages with the following <CODE>make</CODE> rules:
+
Once the compilation is done, you can either run VLC directly from the source tree or you can build self-contained VLC packages with the following <code>make</code> rules:  
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! Command
 
−
! Description
 
 
|-
 
|-
−
| <CODE>make package-win32-base</CODE>
+
! Command
−
| Creates a subdirectory named <CODE>vlc-x.x.x</CODE> with all the binaries 'stripped' (that is, smallest size, unusable with a debugger)
+
! Description
 +
|-
 +
| <code>make package-win32-base</code>  
 +
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries 'stripped' (that is, smallest size, unusable with a debugger)
 
|-
 
|-
−
| <CODE>make package-win32-zip</CODE>
+
| <code>make package-win32-zip</code>  
 
| Same as above but will package the directory in a zip file.
 
| Same as above but will package the directory in a zip file.
 
|-
 
|-
−
| <CODE>make package-win32</CODE>
+
| <code>make package-win32</code>  
 
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
 
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
 
|}
 
|}
  
−
'''''Well done&mdash;you're ready to use VLC!'''''
+
'''''Well done—you're ready to use VLC!'''''
 +
 
 +
 
  
 
[[Category:Building]]
 
[[Category:Building]]

Revision as of 13:01, 13 June 2010

Before you start

One common desire that leads people to want to rebuild VLC is to "rebuild a debug version" or "add printf()s", but this is not strictly necessary, as VLC includes a debug logging feature by default. If you are using a binary release (or have already built VLC), just run 'vlc.exe' and select "Messages..." from the "Tools" menu.

You can also run VLC from the Windows command-line interpreter, cmd.exe (a.k.a. "DOS window"), in which case you'll be able to use the command-line arguments. You can obtain a list of these command line arguments by typing 'vlc --help' or 'vlc --help --advanced'.

To store a debug log of the current VLC session, you can use 'vlc -vvv --extraintf=logger'. You will end-up with a vlc-log.txt file in your current directory.

Building VLC from source

If you want to build VLC from source, you have several choices:

Method Documentation Notes
Cross-compile with Mingw32 on Linux None Preferred method (uses cross compilation)
Native-compile with MSYS+MINGW Win32CompileMSYSNew Preferred native compilation method. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows. It provides all the commonly-required Unix tools (like sh, gmake, and so forth).
Native-compile with Cygwin Win32CompileCygwinNew OUTDATED native compilation method
Native-compile with Microsoft Visual C++ None Not advised.

Even though VLC includes some MSVC project files, this method is advised only if you just want to experiment/play with some basic functionality in VLC. VLC depends on a lot of third-party libraries and building them in MSVC is inconvenient (and in some cases, impossible).
If you want to run VLC under the MSVC debugger, use --fast-mutex --win9x-cv-method=1 because the debugger usually loses signals sent by PulseEvent().

Obtaining the build tools

Each build method requires its own toolchain:

Method Notes
Cross-compile with mingw32 on GNU/Linux
  • Debian/Ubuntu users can apt-get install mingw32 mingw32-binutils, however building FFmpeg now requires mingw32-runtime >= 3.15 and w32api >= 3.13 so these will have to be updated manually.
  • Gentoo users can emerge crossdev && crossdev mingw32
  • Other systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW
Native-compile with MSYS+MINGW Read the documentation
Native-compile with Cygwin Read the documentation

Saving time by using pre-built libraries

VLC requires other open source projects to provide some features (like AC3 audio decoding and MPEG-4 video decoding). A complete list of required libraries from these projects can be found at http://developers.videolan.org/vlc/. Depending on your needs, you must either build your own versions of these libraries or use VLC's convenient pre-built versions.

If you feel you must build these libraries from source, the blessed source code may be found at http://download.videolan.org/pub/testing/contrib/. An automated way of building the contrib libraries is provided in extra/contrib. It will download, configure, and build the libraries. See the extras/contrib/README for more info.

If you want to save yourself time and energy by using the pre-built versions of these libraries, you may download them from http://people.videolan.org/~jb/Contribs/, named in fashion of contrib-yyyymmdd-win32-version-bin-gcc-gccversion-only.tar.bz2 . The pre-built versions will only work with MINGW or Cygwin. Note that the version you download must match that of the MINGW compiler, i586-mingw32msvc-gcc, which you can verify by typing 'i586-mingw32msvc-gcc --ver'.

There are two installation strategies:

Location Command Advantages Disadvantages
Install the pre-built libraries into the Cygwin standard directories (/usr/win32/*) tar jxf contrib-20061122-win32-bin-gcc-3.4.5-only.tar.bz2 -C / (Note the "-C /"!)
  • Shorter initial setup time
  • May conflict with other headers/libraries in the standard directories
  • Difficult to get rid of if you want to free up space or to upgrade to the next version of the pre-built libraries (Installing over the top of older versions is highly discouraged!)
Install the pre-built libraries into a project-specific directory (e.g., D:\VLC) tar jxf contrib-20061122-win32-bin-gcc-3.4.5-only.tar.bz2 -C /cygdrive/d/VLC
  • No conflicts with other projects built under Cygwin
  • Easy to get rid of if you want to free up space or to upgrade to the next version of the pre-built libraries
  • For multi-person projects, easy to put under revision control to ensure all project members are using the correct pre-built versions
  • Requires that you set CPPFLAGS, LDFLAGS appropriately when building
  • Requires that you modify hard-coded paths in the pre-built libraries (see below)

If installing into a project-specific directory, you must modify some hard-coded paths in the pre-build libraries as follows: 

CONTRIBS=/cygdrive/d/VLC
for file in $CONTRIBS/bin/*-config $CONTRIBS/lib/*.la $CONTRIBS/lib/pkgconfig/*.pc ; do
	perl -i.bak -p -e 's|/usr/win32|$ENV{"CONTRIBS"}|g' $file
done

Configuring the build

Once you've got all the files you need in place, you need to configure the build with the configure script. In the following examples, assume that the third-party libraries are installed in $CONTRIBS. If installed in the Cygwin standard directories, use export CONTRIBS=/usr/win32. Otherwise use export CONTRIBS=/cygdrive/d/VLC.

If you are cross-compiling under GNU/Linux, you can use something along these lines: 

 ./bootstrap && \
 export PKG_CONFIG_LIBDIR=$CONTRIBS/lib/pkgconfig PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=i586-mingw32msvc-cpp \
 LDFLAGS=-L$CONTRIBS/lib \
 CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++
 ./configure --host=i586-mingw32msvc --build=i386-linux \
     --disable-Gtk \
     --enable-Nls --enable-Sdl --with-sdl-config-path=$CONTRIBS/bin \
     --enable-Ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-Faac \
     --with-ffmpeg-Zlib --enable-Faad --enable-Flac --enable-Theora \
     --with-Wx-config-path=$CONTRIBS/bin \
     --with-Freetype-config-path=$CONTRIBS/bin \
     --with-Fribidi-config-path=$CONTRIBS/bin \
     --with-Libgcrypt-prefix=$CONTRIBS \
     --enable-Live555 --with-live555-tree=$CONTRIBS/live.com \
     --enable-Caca --with-caca-config-path=$CONTRIBS/bin \
     --with-Xml2-config-path=$CONTRIBS/bin \
     --with-Dvdnav-config-path=$CONTRIBS/bin \
     --disable-Cddax --disable-Vcdx --enable-Goom \
     --enable-Twolame --enable-Dvdread \
     --enable-Debug

If you are using cygwin, you can build VLC with or without the POSIX emulation layer. Without is usually better and with POSIX emulation hasn't been tested in over a year. So to build without the emulation layer, use something like this: 

 ./bootstrap && \
 export PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=$CPPFLAGS \
 LDFLAGS=-L$CONTRIBS/lib \
 CC='gcc -mno-cygwin' CXX='g++ -mno-cygwin' \
 ./configure \
     --disable-gtk \
     --enable-nls --enable-sdl --with-sdl-config-path=$CONTRIBS/bin \
     --enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
     --with-ffmpeg-zlib --enable-faad --enable-flac --enable-theora \
     --with-wx-config-path=$CONTRIBS/bin \
     --with-freetype-config-path=$CONTRIBS/bin \
     --with-fribidi-config-path=$CONTRIBS/bin \
     --enable-live555 --with-live555-tree=$CONTRIBS/live.com \
     --enable-caca --with-caca-config-path=$CONTRIBS/bin \
     --with-xml2-config-path=$CONTRIBS/bin \
     --with-dvdnav-config-path=$CONTRIBS/bin \
     --disable-cddax --disable-vcdx --enable-goom \
     --enable-twolame --enable-dvdread \
     --enable-debug

If you want to use the emulation layer, then just omit CFLAGS and CXXFLAGS. You're on your own, though.

If you are compiling with MSYS/MINGW, then you can use something along those lines: 

 ./bootstrap && \
 export PKG_CONFIG_PATH=$CONTRIBS/lib/pkgconfig \
 CPPFLAGS="-I$CONTRIBS/include -I$CONTRIBS/include/ebml" CXXCPP=$CPPFLAGS \
 LDFLAGS=-L$CONTRIBS/lib \
 ./configure \
     --disable-gtk \
     --enable-nls --enable-sdl --with-sdl-config-path=$CONTRIBS/bin \
     --enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
     --with-ffmpeg-zlib --enable-faad --enable-flac --enable-theora \
     --with-wx-config-path=$CONTRIBS/bin \
     --with-freetype-config-path=$CONTRIBS/bin \
     --with-fribidi-config-path=$CONTRIBS/bin \
     --enable-caca --with-caca-config-path=$CONTRIBS/bin \
     --with-xml2-config-path=$CONTRIBS/bin \
     --with-dvdnav-config-path=$CONTRIBS/bin \
     --disable-cddax --disable-vcdx --enable-goom \
     --enable-twolame --enable-dvdread \
     --disable-Mkv \
     --enable-debug

If you have used the "extras/contrib" way, you don't need to specify CFLAGS, LDFLAGS and --with-foo-config-path=. 

./bootstrap && \
 ./configure \
     --disable-gtk \
     --enable-nls --enable-sdl \
     --enable-ffmpeg --enable-faad --enable-flac --enable-theora \
     --disable-cddax --disable-vcdx --enable-goom \
     --enable-twolame --enable-dvdread \
     --enable-mkv --enable-caca --enable-live555\
     --enable-debug

See './configure --help' for more information.

Building VLC

Once configured, to build VLC, just run 'make'.

Once the compilation is done, you can either run VLC directly from the source tree or you can build self-contained VLC packages with the following make rules:

Command Description
make package-win32-base Creates a subdirectory named vlc-x.x.x with all the binaries 'stripped' (that is, smallest size, unusable with a debugger)
make package-win32-zip Same as above but will package the directory in a zip file.
make package-win32 Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.

Well done—you're ready to use VLC!

Retrieved from "https://wiki.videolan.org/index.php?title=Win32Compile&oldid=16290"