mirror of https://code.videolan.org/videolan/vlc
148 lines
5.6 KiB
Plaintext
148 lines
5.6 KiB
Plaintext
INSTALL file for the Windows9x/2k/XP version of vlc, the VideoLAN Client
|
|
|
|
Running VideoLAN Client
|
|
=======================
|
|
|
|
If you have already built vlc (see below) or are using a binary release,
|
|
just run 'vlc.exe'.
|
|
|
|
You can also run vlc from a dos command box, 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'.
|
|
To store a debug log of the current vlc session, you can use
|
|
'vlc -vvvvv --intf=logger nameofyourvideofile', but this will unfortunatly
|
|
disable the GUI. You will end-up with a vlc.log 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 in the 'Device name'
|
|
box (eg. 'D' if this is the letter for your dvdrom drive).
|
|
( !WARNING: you have to be in administrator mode (for now) on Win2k/XP or the
|
|
DVD won't play. )
|
|
|
|
Building VideoLAN Client from the source code
|
|
=============================================
|
|
|
|
If you want to do the tricky job of building vlc from sources, you can do it
|
|
in two ways:
|
|
|
|
- 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...)
|
|
|
|
- or on Linux, using the mingw32 cross-compiler
|
|
|
|
Getting the right tools
|
|
=======================
|
|
|
|
- cross-compiling with mingw32:
|
|
All the necessary tools you need can be found on the videolan web site:
|
|
http://www.videolan.org/vlc/windows.html
|
|
|
|
You first need to download a linux cross-compiler version of mingw32.
|
|
(for Debian GNU/Linux users, there is a mingw32 package)
|
|
|
|
You must also not forget to install the extra development packages if you want
|
|
to build the DirectX, GTK and SDL plugins.
|
|
|
|
- compiling natively on Windoze:
|
|
You will need to download and install the latest MSYS (version 1.0.7 as
|
|
of now) and MINGW.
|
|
The installation is really easy. Begin with the MSYS auto-installer and once
|
|
this is done, extract MINGW into c:\msys\1.0\mingw. You also have to remember
|
|
to remove the make utility included with MINGW as it conflicts with the one
|
|
from MSYS (just rename or remove c:\msys\1.0\mingw\bin\make.exe).
|
|
|
|
http://www.mingw.org/download.shtml
|
|
http://prdownloads.sourceforge.net/mingw/MSYS-1.0.7-i686-2.exe
|
|
http://prdownloads.sourceforge.net/mingw/MinGW-1.1.tar.gz
|
|
|
|
You must also not forget to install the extra development packages if you want
|
|
to build the DirectX, GTK and SDL plugins.
|
|
(http://www.videolan.org/vlc/windows.html)
|
|
|
|
|
|
NOTE: by default, the GTK package is configured to be installed in
|
|
/usr/local/gtk-win32, if you want to change this path, then you need to edit
|
|
the gtk-win32/bin/gtk-config file and change "gtk_dir=" accordingly.
|
|
The same is true for the SDL package, it is installed in
|
|
/usr/local/SDL-1.2.3-win32 by default and you need to change "prefix=" in
|
|
SDL-1.2.3-win32/i386-mingw32msvc/bin/sdl-config if you plan to extract the
|
|
archive in a different directory.
|
|
|
|
Configuring the build
|
|
=====================
|
|
|
|
The best way to configure the build process of vlc is to use the
|
|
`./configure' script.
|
|
|
|
See `./configure --help' for more information.
|
|
|
|
If you are cross-compiling from Debian, you can use something
|
|
along those lines:
|
|
|
|
make distclean ; \
|
|
CC=i586-mingw32msvc-gcc \
|
|
./configure --host=i586-mingw32msvc --build=i386-linux \
|
|
--with-gtk-config-path=/usr/local/gtk-win32/bin \
|
|
--with-sdl-config-path=/usr/local/SDL-1.2.3-win32/i386-mingw32msvc/bin \
|
|
--with-directx=/usr/local/dxheaders \
|
|
--with-dvdcss-tree=../libdvdcss-win
|
|
|
|
If you are cross-compiling using the mingw32 package provided by
|
|
www.videolan.org, you have to use something along those lines:
|
|
|
|
CC=i586-mingw32msvc-gcc \
|
|
PATH=/usr/local/cross-tools/bin:$PATH \
|
|
./configure --host=i586-mingw32msvc --build=i386-linux \
|
|
--with-gtk-config-path=/usr/local/gtk-win32/bin \
|
|
--with-sdl-config-path=/usr/local/SDL-1.2.3-win32/i386-mingw32msvc/bin \
|
|
--with-directx=/usr/local/dxheaders \
|
|
--with-dvdcss-tree=../libdvdcss-win
|
|
|
|
If you are compiling natively on Windoze, then you can use something
|
|
along those lines:
|
|
./configure \
|
|
--with-gtk-config-path=/c/dev/gtk-win32/bin \
|
|
--with-sdl-config-path=/c/dev/SDL-1.2.3-win32/i386-mingw32msvc/bin \
|
|
--with-directx=/c/dev/dxheaders \
|
|
--with-dvdcss-tree=../libdvdcss-win
|
|
|
|
Note: when using the --with-dvdcss-tree you need to compile the tree
|
|
beforehand.
|
|
|
|
Building VideoLAN Client
|
|
========================
|
|
|
|
Have a look at the generated Makefile.opts file, you may want to choose
|
|
which modules will be compiled as plugins, and which ones will remain in
|
|
the core application. The configure script tries to guess for you.
|
|
|
|
Once configured, to build vlc you have to:
|
|
|
|
If you are cross-compiling from Debian or compiling natively on Windoze,
|
|
then just run `make'.
|
|
|
|
If you are cross-compiling using the mingw32 package provided by
|
|
www.videolan.org, run `PATH=/usr/local/cross-tools/bin:$PATH make'.
|
|
|
|
Building Win32 interface with bcc32 (Borland's compiler)
|
|
========================================================
|
|
(This stage is only necessary if you want to use the Win32 native interface.
|
|
If you are happy with the GTK interface, then you can skip this section)
|
|
|
|
1) Compile vlc as usual.
|
|
|
|
2) From the plugin\win32 directory, use Borland C++ command-line tools
|
|
as follows:
|
|
bpr2mak intfwin.bpr -s \
|
|
| sed 's#^LIBPATH = .*#&;$$(RELEASELIBPATH)# ; s#^USERDEFINES = .*#& -DWIN32 -D__PLUGIN__ -DMODULE_NAME_IS_intfwin -DMODULE_NAME=intfwin#' \
|
|
> intfwin.mak // Create a makefile from intfwin.bpr
|
|
make -fintfwin // It's Borland's make utility !
|
|
|
|
3) This should create a intfwin.so
|
|
You can remove any other generated file.
|
|
|
|
|
|
Well done, now you're ready to use vlc!
|
|
=======================================
|