-$Id: INSTALL.win32,v 1.17 2003/07/06 16:22:15 gbazin Exp $
+$Id: INSTALL.win32,v 1.23 2004/02/29 14:35:10 gbazin Exp $
INSTALL file for the Windows9x/Me/NT4/2k/XP version of the VLC media player
'vlc -vv --extraintf=logger'. You will end-up with a vlc-log.txt file in
your current directory.
-If you want to play a DVD, run VLC and click on the Disc option in the
-interface. You then have to type your drive letter followed by a colon in
-the 'Device name' box (eg. 'D:' if this is the letter for your dvdrom drive).
-
Additional documentation is available at http://www.videolan.org/doc/
- natively on Windows, using cygwin (www.cygwin.com) with or without the
unix emulation layer. This is the prefered way to compile vlc if you want
to do it on Windows.
+ NOTE: This is the PREFERED way of building VLC natively (the others
+ are not as much tested so expect more difficulties with them).
- natively on Windows, using MSYS+MINGW (www.mingw.org)
(MSYS is a minimal build environnement to compile unixish projects under
windoze. It provides all the common unix tools like sh, gmake...)
- Please note that there is currenlty a bug in MSYS which requires you to
- edit the acgeneral.m4 file and replace the value of ac_max_sed_lines to
- something higher, for instance 976.
+ Please note that the gettext utilities are not included in the default
+ MSYS/MINGW packages so you won't be able to build VLC with i18n support.
- natively on Windows, using Microsoft Visual C++. Even though we provide some
msvc project files with vlc, this method is advised only if you just want to
- cross-compiling with mingw32:
You first need to download a linux cross-compiler version of mingw32.
-(for Debian GNU/Linux users, you can use the mingw32, mingw32-binutils and
-mingw32-runtime packages)
+
+For Debian GNU/Linux users, you can use the mingw32, mingw32-binutils and
+mingw32-runtime packages.
+
+Or you can use our mingw32 gcc-3.3.1 cross-compiler package:
+http://www.videolan.org/pub/testing/win32/mingw-gcc3.3.1-linux-crosscompiler.tar.bz2 (requires libc6 >= 2.3.2).
+You will need to extract this package in your root directory (everything will
+be extracted in /usr/local/cross-tools).
- compiling natively on Windoze with cygwin:
You will need to download and run the setup.exe app from cygwin's web site
(www.cygwin.com). You will also need to make sure you install at least the
-gcc-mingw, mingw-runtime and w32api packages.
+gcc-g++, gcc-mingw, mingw-runtime and win32-api packages.
- compiling natively on Windoze with MSYS+MINGW:
You will need to download and install the latest MSYS, MSYS-DTK and MINGW.
from MSYS (just rename or remove c:\msys\1.0\mingw\bin\make.exe).
http://www.mingw.org/download.shtml
-http://prdownloads.sf.net/mingw/MSYS-1.0.9-2003.14.18-1.exe
-http://prdownloads.sf.net/mingw/MinGW-2.0.0-3.exe
+http://prdownloads.sf.net/mingw/MSYS-1.0.9.exe
+http://prdownloads.sf.net/mingw/MinGW-3.0.0-rc3.exe
http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe
Getting the additionnal libraries
external libraries.
They can be found here (source code):
-http://www.videolan.org/pub/testing/contrib/
+http://download.videolan.org/pub/testing/contrib/
-I also provide a package with all the libraries already compiled so it is
+We also provide a package with all the libraries already compiled so it is
actually really easy to compile a full-featured version of vlc (these compiled
libraries will only work with mingw or cygwin):
-http://www.videolan.org/pub/testing/win32/contrib-20030622-win32-bin.tar.bz2
+http://download.videolan.org/pub/testing/win32/contrib-20040229-win32-bin-gcc3.3.1-only.tar.bz2
All you need to do is extract it in your root directory (the include files
and libraries will be put in /usr/win32). You can do this with the following
-command: "tar xjvf contrib-20030622-win32-bin.tar.bz2 -C /"
+command: "tar xjvf contrib-20040229-win32-bin-gcc3.3.1-only.tar.bz2 -C /"
A complete list of the libraries on which we depend can be found here:
http://developers.videolan.org/vlc/
along those lines:
./bootstrap && \
- CPPFLAGS=-I/usr/win32/include LDFLAGS=-L/usr/win32/lib \
+ CPPFLAGS="-I/usr/win32/include -I/usr/win32/include/ebml" \
+ LDFLAGS=-L/usr/win32/lib \
CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++ \
./configure --host=i586-mingw32msvc --build=i386-linux \
--disable-sdl --disable-gtk \
- --with-included-gettext --enable-nls \
- --enable-mad \
- --enable-ffmpeg \
- --enable-dvdread --enable-dvdplay \
+ --enable-nls \
+ --enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
--enable-faad \
--enable-flac \
--enable-theora \
--with-wx-config-path=/usr/win32/bin \
- --with-skins-wx-config-path=/usr/win32/bin \
--with-freetype-config-path=/usr/win32/bin \
+ --with-fribidi-config-path=/usr/win32/bin \
+ --enable-livedotcom --with-livedotcom-tree=/usr/win32/live.com \
+ --enable-caca --with-caca-config-path=/usr/win32/bin \
+ --with-xml2-config-path=/usr/win32/bin \
+ --with-dvdnav-config-path=/usr/win32/bin \
+ --disable-cddax --disable-vcdx \
+ --enable-debug
+
+If you are cross-compiling with our gcc-3.3.1 package, you can use something
+along those lines:
+
+ ./bootstrap && \
+ PATH=/usr/local/mingw/bin:$PATH \
+ CPPFLAGS=-I/usr/win32/include \
+ LDFLAGS=-L/usr/win32/lib \
+ CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++ \
+ ./configure --host=i586-mingw32msvc --build=i386-linux \
+ --disable-sdl --disable-gtk \
+ --enable-nls \
+ --enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
+ --enable-faad \
+ --enable-flac \
+ --enable-theora \
+ --with-wx-config-path=/usr/win32/bin \
+ --with-freetype-config-path=/usr/win32/bin \
+ --with-fribidi-config-path=/usr/win32/bin \
+ --enable-livedotcom --with-livedotcom-tree=/usr/win32/live.com \
+ --enable-caca --with-caca-config-path=/usr/win32/bin \
+ --with-xml2-config-path=/usr/win32/bin \
+ --with-dvdnav-config-path=/usr/win32/bin \
+ --disable-cddax --disable-vcdx \
--enable-debug
If you are using cygwin, you can build VLC with or without the unix emulation
layer (without is usually better). To build without the emulaion layer, use
something like this:
./bootstrap && \
- CPPFLAGS=-I/usr/win32/include LDFLAGS=-L/usr/win32/lib \
+ CPPFLAGS="-I/usr/win32/include -I/usr/win32/include/ebml" \
+ LDFLAGS=-L/usr/win32/lib \
CC="gcc -mno-cygwin" CXX="g++ -mno-cygwin" \
./configure \
--disable-sdl --disable-gtk \
- --with-included-gettext --enable-nls \
- --enable-mad \
- --enable-ffmpeg \
- --enable-dvdread --enable-dvdplay \
+ --enable-nls \
+ --enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
--enable-faad \
--enable-flac \
--enable-theora \
--with-wx-config-path=/usr/win32/bin \
- --with-skins-wx-config-path=/usr/win32/bin \
--with-freetype-config-path=/usr/win32/bin \
+ --with-fribidi-config-path=/usr/win32/bin \
+ --enable-livedotcom --with-livedotcom-tree=/usr/win32/live.com \
+ --enable-caca --with-caca-config-path=/usr/win32/bin \
+ --with-xml2-config-path=/usr/win32/bin \
+ --with-dvdnav-config-path=/usr/win32/bin \
+ --disable-cddax --disable-vcdx \
--enable-debug
If you want to use the emulation layer, then just omit the CC="gcc -mno-cygwin"
If you are compiling with MSYS/MINGW, then you can use something along those
lines:
./bootstrap && \
- CPPFLAGS=-I/usr/win32/include LDFLAGS=-L/usr/win32/lib \
+ CPPFLAGS="-I/usr/win32/include -I/usr/win32/include/ebml" \
+ LDFLAGS=-L/usr/win32/lib \
./configure \
--disable-sdl --disable-gtk \
- --with-included-gettext --enable-nls \
- --enable-mad \
- --enable-ffmpeg \
- --enable-dvdread --enable-dvdplay \
+ --enable-nls \
+ --enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
--enable-faad \
--enable-flac \
--enable-theora \
--with-wx-config-path=/usr/win32/bin \
- --with-skins-wx-config-path=/usr/win32/bin \
--with-freetype-config-path=/usr/win32/bin \
+ --with-fribidi-config-path=/usr/win32/bin \
+ --enable-caca --with-caca-config-path=/usr/win32/bin \
+ --with-xml2-config-path=/usr/win32/bin \
+ --with-dvdnav-config-path=/usr/win32/bin \
+ --disable-cddax --disable-vcdx \
+ --disable-mkv \
--enable-debug
See `./configure --help' for more information.
Once configured, to build VLC, just run `make'.
+( If you are using our gcc-3.3.1 cross-compiler you'll need to use:
+ PATH=/usr/local/mingw/bin:$PATH make )
+
Well done, now you're ready to use VLC!
=======================================