Latest revision as of 20:24, 15 February 2019

This page is outdated and information might be incorrect.
Create an account to start editing, and then click here to update this article.

OUTDATED

See Win32CompileMSYS

Introduction

About

MSys is a helper environment for MinGW, the compiler chain for Windows based on GCC. It can build VLC natively on Windows. Note that you should also cross compile VLC from Linux, because it is faster, and feels easier.

VLC is a complex program with many dependencies, so minimal command-line experience is required. Also, don't be in a hurry (4 hours is a minimum for the whole process) and don't despair if it doesn't work first time.

Acknowledgements

This howto was re-created by Jean-Baptiste Kempf and updated in June 2009, September 2009, December 2009 and March 2010.

It was updated in June 2010 by Vicne with the help of J-b, gnosygnu and MichaelMc

It was updated in July 2012 by gnosygnu. Note that there are several new notes in Win32CompileMSYSTroubleShooting. These reflect problems that were encountered on gnosygnu's setup (Windows XP SP3). Refer to this forum thread for more information.

Windows tools needed

Text editor

To edit unix-style text documents you need a suitable editor.

You can look at notepad2. You can set File - Line endings - Default to "Unix (LF)", but it always saves opened files in the ending style they have.

Or you can look at notepad++.

Unzip Utility (7-zip)

Many files to downloaded will have to be uncompressed. As most of them use Linux-originated formats (.tar.gz, .tar.bz2, .tar.lzma), you will need a versatile unzipping utility. A recent version of 7-zip is therefore strongly advised.

Please note that most archives contain directory structures. Unless otherwise stated, you have to merge the contents with the existing dirs

GNU Windows Environment

Before installing, ensure your Windows user name does not contain spaces (VLC will not build in a folder with spaces in it). If it does, please create another user on your system.

In the following text, we'll refer to this user name as "<username>". Replace it appropriately where needed of course.

MinGW

TDM/MinGW Setup

Use the installer found at http://sourceforge.net/projects/tdm-gcc/files/TDM-GCC%20Installer/tdm-gcc-4.7.1-2.exe/download

Go through the wizard:

Select "Create"
Select 32bits
Install to C:\MinGW
Keep default settings

MinGW utils

Install mingw-utils, for unix2dos: http://prdownloads.sourceforge.net/mingw/mingw-utils-0.3.tar.gz

Extract contents to c:\MinGW

MSys

MSys Setup

Use the installer found at http://sourceforge.net/project/downloading.php?group_id=2435&filename=MSYS-1.0.11.exe

Go through the wizard and install to to default C:\Msys\1.0

In the command window that opens, answer questions as follows:

Accept Post Install: [y]
MinGW Installed?     [y]
path to MinGW:       [c:/MinGW]

MSys Developer Toolkit

Use the installer found at http://downloads.sourceforge.net/mingw/msysDTK-1.0.1.exe

Go through the wizard, keeping the default values.

This will install old versions of autotools, perl, ssh, ftp and sftp.

Git

Install Git from http://code.google.com/p/msysgit/downloads/list?can=3

Go through the wizard, keeping the default value, except the one speaking of line endings.

Wget

You will need Wget: http://sourceforge.net/projects/gnuwin32/files/wget/1.11.4-1/wget-1.11.4-1-setup.exe/download

Extract it to c:\MinGW

AutoTools and libcrypt

Update autoconf, automake, libtool as well as libcrypt by downloading the following files and extracting them to C:\Msys\1.0:

Glib and PKG-CONFIG

Similarly, download the following files and extract them to C:\MSys\1.0:

Note* Download the latest version inside this folders (Last tested to be OK is glib 2.28, non-dev version)):

Note: I found that compiling 2.1.0 requires xgettext, msgmerge, msgfmt and so on. These in turn require libiconv. I'm not sure if that suffices as at this point I gave up.

Add pkg config path variable

Add the following line to the *top* of C:\MSys\1.0\msys.bat:

set PKG_CONFIG_PATH=/win32/lib/pkgconfig

Compile LUA tools

VLC uses the LUA scripting language (See lua.org). Unfortunately, no binaries are provided so you need to compile them.

Download the lua tools package from http://www.lua.org/ftp/lua-5.1.4.tar.gz
Uncompress it in your home folder (C:\MSys\1.0\home\<username>)
run MSys
type the following commands:

cd /home/<username>/lua-5.1.4 
make mingw
make install

VLC sources

Git

Clone the git repo

git clone git://git.videolan.org/vlc.git

Get Precompiled contribs

cd vlc/contrib
mkdir win32 && cd win32
../bootstrap --build=i586-mingw32msvc
make prebuilt

Note: it will say tar complains, just ignore them and watch tar die. I had to manually execute the rest of the prebuilt target, which consists of

mv i586-mingw32msvc ..
cd ../i586-mingw32msvc
change_prefix.sh

I also found that change_prefix.sh, which rewrites .pc files to deal with their chosen location, used the -i option which is not supported by MSYS-shipped sed. I rewrote the sed script to write changes $file.new then mv $file.new $file.

Last change : whoami and hostname

Whoami is not available on Windows, and hostname doesn't support the -f option used by the build process. These utilities are used to show the name and computer of the person who compiled VLC in the 'About' box.

Note for the brave : the steps below are file changes so that compile works, but an alternative is to download and install GNU whoami and hostname functionality. This can be achieved by doing the following steps:

download coreutils from http://sourceforge.net/projects/mingw/files/MSYS/BaseSystem/coreutils, selecting any version (latter is normally better) then the file named like coreutils-5.97-2-msys-1.0.11-ext.tar.lzma (note '-ext' in file name) and extracting who.exe, whoami.exe, hostname.exe to C:/MSys/1.0/bin
download libintl dll from http://sourceforge.net/projects/mingw/files/MSYS/BaseSystem/libiconv, selecting any version (latter is normally better) then the file named like libiconv-1.13.1-2-msys-1.0.13-dll-2.tar.lzma (note '-dll' in file name) and extracting dll in C:/MSys/1.0/bin
download libiconv dll from http://sourceforge.net/projects/mingw/files/MSYS/BaseSystem/gettext, selecting any version (latter is normally better) then the file named like libintl-0.17-2-msys-dll-8.tar.lzma (note '-dll' in file name) and extracting dll in C:/MSys/1.0/bin

Whoami

Create a new file containing the single line:

echo '<username>'

and save it as C:\MSys\1.0\bin\whoami (without any extension)

Hostname

Modify configure.ac so that it doesn't call 'hostname -f' as follows:

open C:\MSys\1.0\home\<username>\vlc\configure.ac
goto search button:
change it as follows:

old: AC_DEFINE_UNQUOTED(VLC_COMPILE_HOST, "`hostname -f 2> /dev/null || hostname`", [host which ran configure])
new: AC_DEFINE_UNQUOTED(VLC_COMPILE_HOST, "`hostname`", [host which ran configure])

Build VLC

The build is made exclusively from the command line, so if you closed the prompt at the LUA step, re-execute C:\MSys\1.0\msys.bat, then type the commands as mentioned

Bootstrap

cd vlc
cp -v /usr/share/aclocal/* m4/
bootstrap

Configure

sh extras/package/win32/configure.sh --host=i586-pc-mingw32msvc --disable-nls

If you want any custom options, like "--disable-lua" or anything of that nature, you can append them.

Make (compile)

Note : If your <username> starts with the "u" or "x" character, change C:\MSys\1.0\home\<username>\config.h and double all backslashes in VLC_COMPILED_BY constant.

Type the following command :

PATH=/usr/win32/bin:$PATH make

If this step fails, try the following

Go back to "Precompiled contribs" section, and obtain the latest compiled contrib (under "Note for the brave")
In the configure script section (configure-msys.sh), open that file and add --disable-upnp

Create self-contained packages

Once the compilation is done, build self-contained VLC packages with one of the following "make" commands:

make package-win32-base

(This will create a subdirectory named vlc-x.x.x with all the binaries "stripped" without any debugging symbols).

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 will need to have NSIS installed in its default location for this to work).

make package-win32-base-debug

(This will create a subdirectory named vlc-x.x.x with all the binaries containing debug info usable by gdb).

Note that with the 1.2 branch these names have changed slightly. Run '

grep ':' Makefile | grep package-win32

to see what they are now.

Troubleshooting

See Win32CompileMSYSTroubleShooting.

@@ Line 1: / Line 1: @@
+{{Outdated}}
+= '''OUTDATED''' =
+See [[Win32CompileMSYS]]
 = Introduction  =
 == About ==
-MSys is a helper environment for MinGW, the compiler chain for Windows based on GCC. It can build VLC natively on Windows.  Note that you could also [[Win32Compile|cross compile]] VLC from Linux, if desired (it is faster, and feels easier).
+MSys is a helper environment for MinGW, the compiler chain for Windows based on GCC. It can build VLC natively on Windows.  Note that you should also [[Win32Compile|cross compile]] VLC from Linux, because it is faster, and feels easier.
-VLC is a complex program with many dependencies, so minimal command-line experience is required. Also, don't be in a hurry (2 hours is a minimum for the whole process) and don't despair if it doesn't work first time.
-== On the edge vs Conservative ==
-This update aims at building versions from the 1.1.0 branch natively in the most straightforward way.
-Of course, if you want to live on the edge, feel free to select more recent versions of the proposed tools, contribs or sources, but the build has only been thoroughly validated with the versions indicated in the main text flow.
-:''Such alternative ways are indented, italicized and marked "Note for the brave"&nbsp;:-). Your mileage may vary''
+VLC is a complex program with many dependencies, so minimal command-line experience is required. Also, don't be in a hurry (4 hours is a minimum for the whole process) and don't despair if it doesn't work first time.
 == Acknowledgements ==
@@ Line 19: / Line 15: @@
 This howto was re-created by [[User:J-b|Jean-Baptiste Kempf]] and updated in June 2009, September 2009, December 2009 and March 2010.
 It was updated in June 2010 by Vicne with the help of J-b, gnosygnu and MichaelMc
+It was updated in July 2012 by gnosygnu. Note that there are several new notes in [[Win32CompileMSYSTroubleShooting]]. These reflect problems that were encountered on gnosygnu's setup (Windows XP SP3). Refer to this [http://forum.videolan.org/viewtopic.php?f=32&t=102843&sid=f58967215a83981dda030ff6efa3d493 forum thread] for more information.
 = Windows tools needed  =
 == Text editor  ==
@@ Line 38: / Line 35: @@
 = GNU Windows Environment  =
 Before installing, ensure your Windows user name does not contain spaces (VLC will not build in a folder with spaces in it). If it does, please create another user on your system.
@@ Line 44: / Line 40: @@
 == MinGW  ==
-:''the old version of mingw GCC (3.4.5) worked with VLC, because it uses SjLj exception unwinding.  Any "vanilla" version 4.0+ by default uses dwarf2 exception unwinding, so isn't compatible with the contribs.  So recommend installing TDM, below.''
 === TDM/MinGW Setup  ===
-Use the installer found at http://sourceforge.net/projects/tdm-gcc/files/TDM-GCC%20Installer/tdm-gcc-4.5.2.exe/download
+Use the installer found at http://sourceforge.net/projects/tdm-gcc/files/TDM-GCC%20Installer/tdm-gcc-4.7.1-2.exe/download
 Go through the wizard:
+* Select "Create"
+* Select 32bits
+* Install to C:\MinGW
+* Keep default settings
-*uncheck "Check for updated files..."
+=== MinGW utils  ===
-*Select "Create"
-*install to C:\MinGW
-*keep default settings
-*afterwards check that C:\MinGW\bin is added to windows PATH (http://www.computerhope.com/issues/ch000549.htm)
-=== MinGW utils<br> ===
+Install mingw-utils, for unix2dos: http://prdownloads.sourceforge.net/mingw/mingw-utils-0.3.tar.gz
-Installing mingw-utils is recommended: http://prdownloads.sourceforge.net/mingw/mingw-utils-0.3.tar.gz
 Extract contents to c:\MinGW
 == MSys  ==
 === MSys Setup  ===
@@ Line 77: / Line 66: @@
   Accept Post Install: [y]
-  MinGW Installed?&nbsp;:   [y]
+  MinGW Installed?     [y]
   path to MinGW:       [c:/MinGW]
@@ Line 84: / Line 73: @@
 Use the installer found at http://downloads.sourceforge.net/mingw/msysDTK-1.0.1.exe
-Go through the wizard, keeping default values
+Go through the wizard, keeping the default values.
+This will install old versions of autotools, perl, ssh, ftp and sftp.
+=== Git ===
+Install Git from http://code.google.com/p/msysgit/downloads/list?can=3
+Go through the wizard, keeping the default value, except the one speaking of line endings.
+=== Wget ===
+You will need Wget:
+http://sourceforge.net/projects/gnuwin32/files/wget/1.11.4-1/wget-1.11.4-1-setup.exe/download
+Extract it to c:\MinGW
 === AutoTools and libcrypt  ===
@@ Line 116: / Line 118: @@
   set PKG_CONFIG_PATH=/win32/lib/pkgconfig
-=== Fix libtool search dirs  ===
+== Compile LUA tools  ==
-Open C:\MSys\1.0\bin\libtool and change line 9926 by appending ' /mingw/lib' to the end of 'compiler_lib_search_dirs'. The line should then read&nbsp;:
- compiler_lib_search_dirs="/usr/lib /usr/lib /bin/../lib/gcc-lib/i686-pc-msys/2.95.3-1 /bin/../lib/gcc-lib /usr/lib/gcc-lib/i686-pc-msys/2.95.3-1 /bin/../lib/gcc-lib/i686-pc-msys/2.95.3-1/../../../../i686-pc-msys/lib /usr/lib/gcc-lib/i686-pc-msys/2.95.3-1/../../../../i686-pc-msys/lib /mingw/lib"
-== LUA tools  ==
 VLC uses the LUA scripting language (See [http://www.lua.org lua.org]). Unfortunately, no binaries are provided so you need to compile them.
@@ Line 133: / Line 129: @@
   cd /home/<username>/lua-5.1.4
   make mingw
+ make install
-This should produce lua.exe, luac.exe and lua51.dll in the src directory. Put these in your /bin with the commands:
+= VLC sources  =
+== Git ==
+Clone the git repo
+ git clone git://git.videolan.org/vlc.git
-  cd src
+= Get Precompiled contribs  =
-  cp *.exe *.dll /bin
+  cd vlc/contrib
-  cd ..
+ mkdir win32 && cd win32
+  ../bootstrap --build=i586-mingw32msvc
+  make prebuilt
-Alternatively you could download some "full lua" package, as long as it puts a luac.exe in your path you are good to go, for instance http://code.google.com/p/luaforwindows binaries.
+'''Note''': it will say tar complains, just ignore them and watch tar die.
+I had to manually execute the rest of the prebuilt target, which consists of
-= Precompiled contribs  =
+  mv i586-mingw32msvc ..
+  cd ../i586-mingw32msvc
-== New contrib system ==
+  change_prefix.sh
-'''This is the preferred way, especially if using a source version >= 2.1'''
-* Go into vlc_dir/contrib
-'''Important note here''': i586-mingw32msvc is just an example, the actual name must match your target system triplet, as printed by /vlc/source/root/autotools/config.guess. For example, I needed to name this 'i686-pc-mingw32'. You can also see this test near the top of config.log: if your contrib/ directory is wrongly named, configure will not find any of your prebuilt contrib libraries (the first failure will be Lua, in my case).
-  $ mkdir win32 && cd win32
- $ ../bootstrap --build=i586-mingw32msvc
-  $ make prebuilt
-'''Note''': it used to say "if tar complains, just ignore it" here. For me tar didn't just complain but died, because it was trying to unpack symlinks to non-existent absolute paths. I had to manually execute the rest of the prebuilt target, which consists of
- $ mv i586-pc-something ..
- $ cd ../i586-pc-something
- $ change_prefix.sh
 I also found that change_prefix.sh, which rewrites .pc files to deal with their chosen location, used the -i option which is not supported by MSYS-shipped sed. I rewrote the sed script to write changes $file.new then mv $file.new $file.
-== Old precompiled contribs ==
-:''Note for the brave&nbsp;: Alternatively, you can get the latest contrib from&nbsp;:http://people.videolan.org/~jb/Contribs/''
-*download the file http://people.videolan.org/~jb/Contribs/contrib-20100608-win32-bin-gcc-4.4.4-runtime-3.17-only.tar.bz2
-*extract it to C:\MSys\1.0 '''but without the /usr path'''. For example, one of the resulting files should be:
- C:\MSys\1.0\win32\lib\libdvdnav.a
-Contribs are basically some precompiled 3rd party library (Here's a [[Contrib_Status|list]] of what they all are).
-= VLC sources  =
-:''Note for the brave&nbsp;: This section lists the steps for VLC version 1.1.0rc3. Alternatively, you could get the latest sources from the development tree using GIT. It's not as difficult as it looks to do so. If you want chose that route, please follow instructions on the [[Git Windows]] page (just download the VLC repository--you don't need the x264 one) then skip the next section "Last Change"''
-== Base: VLC version 1.1.0rc3  ==
-*download the file http://download.videolan.org/pub/videolan/testing/vlc-1.1.0-rc3/vlc-1.1.0-rc3.tar.bz2
-*extract it to C:\MSys\1.0\home\&lt;username&gt;
-*rename the vlc-1.1.0rc3 dir to vlc
-== add missing configure-msys (1.1.x only)==
-* Download http://git.videolan.org/?p=vlc.git;a=blob_plain;f=extras/package/win32/configure-msys.sh;hb=HEAD
-* Save it (not using proposed name) as C:\msys\1.0\home\<username>\vlc\extras\package\win32\configure-msys.sh
-== add missing configure-common (1.1.x only) ==
-* Download http://git.videolan.org/?p=vlc.git;a=blob_plain;f=extras/package/win32/configure-common.sh;hb=HEAD
-* Save it (not using proposed name) as C:\msys\1.0\home\<username>\vlc\extras\package\win32\configure-common.sh
 = Last change&nbsp;: whoami and hostname  =
@@ Line 224: / Line 182: @@
 The build is made exclusively from the command line, so if you closed the prompt at the LUA step, re-execute C:\MSys\1.0\msys.bat, then type the commands as mentioned
-'''Note''': Any of these paths that mention '''/usr/win32''' are assuming you're using the OLD contribs method. If you're using the new method, the appropriate path will be more like /path/to/vlc/source/contrib/i686-pc-mingw32/...
 == Bootstrap  ==
   cd vlc
- cp -v /usr/win32/share/aclocal/* m4/
   cp -v /usr/share/aclocal/* m4/
-  PATH=/usr/win32/bin:$PATH ./bootstrap
+  bootstrap
 == Configure  ==
-  sh extras/package/win32/configure-msys.sh
+  sh extras/package/win32/configure.sh --host=i586-pc-mingw32msvc --disable-nls
-'''Note''': for version 2.1.0 at least this file is called configure.sh
+If you want any custom options, like "--disable-lua" or anything of that nature, you can append them.
-If you want any custom options, like "--disable-lua" or anything of that nature, you'll need to edit that file directly instead of passing them in as parameters (at least currently that is required).
 == Make (compile) ==
@@ Line 284: / Line 236: @@
 = See also =
 *[[Win32CompileMSYSOld]] - deprecated documentation
+[[Category:Building]]
+[[Category:Windows]]

Difference between revisions of "Win32CompileMSYSNew"