VideoLAN Wiki - User contributions [en]

Configure

2008-10-09T15:11:29Z

Bardnet: Undo revision 12542 by Yanzifei (Talk)

'''configure''' (also known as '''./configure''') is a [[wikipedia:bash|BASH script]] used to gather information about your computer and select options on what to link to and how. Before running [[make]] (which compiles vlc), you should run configure.

If you are compiling source from [[Git]], then you should run ./bootstrap before running configure.

You can run configure like this:
./configure --options

== Options ==
Below are some common options for configure:
{|
! option !! meaning
|-
| --prefix=''/home/user/vlc/'' || Sets the location of where to install vlc
|-
| --enable-flac || Turns on support for [[FLAC]] audio files
|-
| --enable-ffmpeg || Links with [[ffmpeg]]
|-
| --with-ffmpeg-tree=''/home/user/ffmpeg'' || Location of ffmpeg source code
|}

See `./configure --help' for more information.
== Examples ==

=== Linux ===
./configure --enable-x11 --enable-xvideo --disable-gtk \
--enable-sdl --enable-ffmpeg --with-ffmpeg-mp3lame \
--enable-mad --enable-libdvbpsi --enable-a52 --enable-dts \
--enable-libmpeg2 --enable-dvdnav --enable-faad \
--enable-vorbis --enable-ogg --enable-theora --enable-faac\
--enable-mkv --enable-freetype --enable-fribidi \
--enable-speex --enable-flac --enable-livedotcom \
--with-livedotcom-tree=/usr/lib/live --enable-caca \
--enable-skins --enable-skins2 --enable-alsa --disable-kde\
--disable-qt --enable-wxwindows --enable-ncurses \
--enable-release

=== Linux GIT ===
./configure --enable-x11 --enable-xvideo --disable-gtk \
--enable-sdl --enable-ffmpeg --with-ffmpeg-mp3lame \
--enable-mad --enable-libdvbpsi --enable-a52 --enable-dca \
--enable-libmpeg2 --enable-dvdnav --enable-faad \
--enable-vorbis --enable-ogg --enable-theora --enable-faac\
--enable-mkv --enable-freetype --enable-fribidi \
--enable-speex --enable-flac --enable-livedotcom \
--with-livedotcom-tree=/usr/lib/live --enable-caca \
--enable-skins --enable-skins2 --enable-alsa --disable-kde\
--disable-qt --enable-wxwindows --enable-ncurses \
--enable-asa --enable-release

=== Windows ===
''From http://developers.videolan.org/vlc/vlc/INSTALL.win32''

If you are cross-compiling from Debian, you can use something along those lines:

./bootstrap && \
PKG_CONFIG_LIBDIR=/usr/win32/lib/pkgconfig \
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-[[gtk]] \
--enable-[[nls]] --enable-[[sdl]] --with-sdl-config-path=/usr/win32/bin \
--enable-[[ffmpeg]] --with-ffmpeg-mp3lame --with-ffmpeg-[[faac]] \
--with-ffmpeg-[[zlib]] --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-[[live555]] --with-live555-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-[[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 about a year or so. So to build without the emulation layer, use something like this:

./bootstrap && \
PKG_CONFIG_PATH=/usr/win32/lib/pkgconfig \
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-gtk \
--enable-nls --enable-sdl --with-sdl-config-path=/usr/win32/bin \
--enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
--with-ffmpeg-zlib --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-live555 --with-live555-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-goom \
--enable-twolame --enable-dvdread \
--enable-debug

If you want to use the emulation layer, then just omit the CC="gcc -mno-cygwin" CXX="g++ -mno-cygwin" line. You're on your own though.

If you are compiling with MSYS/MINGW, then you can use something along those lines:
./bootstrap && \
PKG_CONFIG_PATH=/usr/win32/lib/pkgconfig \
CPPFLAGS="-I/usr/win32/include -I/usr/win32/include/ebml" \
LDFLAGS=-L/usr/win32/lib \
./configure \
--disable-gtk \
--enable-nls --enable-sdl --with-sdl-config-path=/usr/win32/bin \
--enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
--with-ffmpeg-zlib --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-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-goom \
--enable-twolame --enable-dvdread \
--disable-[[mkv]] \
--enable-debug

If you have used the "extras/contrib" way, you don't need to precise the 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

[[Category:Building]]

VLC HowTo/Use with Dreambox

2008-10-09T15:11:09Z

Bardnet: Undo revision 12541 by Yanzifei (Talk)

{{howto|Set up Video on Demand on a Dreambox}}
{{stub}}
I have spent some time now to figure out how to get Video on Demand to work on my dreambox. I have a DreamBox DM500S running the Gemini Image (Gemini Project), and this howto is based on that, however I believe the procedure will be similar on other DB's running the Gemini image as well...

Sources I have used:
http://digsat.net/wbb2/thread.php?threadid=36965&hilight=vlc
http://forum.videolan.org

First we need to get a plugin called VLC FrontEnd installed on the dreambox, it might already be there; check under blue panel - plugins. If it is not there, install it by doing the following. 

'''How to install VLCf (VLC Frontend)''' 
- Press Blue button 
- Choose Addons(2) 
- Confirm option Gemini-server 
- Search for Plugins 
- Install VLCF (currently is VLC-Final RC15 23.09.2k7) 

Now, the front end is installed and almost ready to use. We still have nothing that can feed the frontend, so first we must create an xml file for the frontend to use:

<pre>
<?xml version="1.0" encoding="iso-8859-1"?>
<?xml-stylesheet type="text/xsl" href="/XSLMPSettings.xsl"?>
<vlc>
<server ip="192.168.1.10" webif-port="8080" stream-port="9090" user="admin" pass="admin" />
<config startdir="c:/movies" cddrive="d:" />
<codec mpeg1="mpgv" mpeg2="mp2v" audio="mpga" />
<setup name="SVCD" ext="NONE" Videorate="1000" fps="25" Videotranscode="0" Videocodec="mpeg2" Videosize="352x576" Audiorate="192" Audiotranscode="0" />
<setup name="VCD" ext="NONE" Videorate="1000" fps="25" Videotranscode="0" Videocodec="mpeg1" Videosize="352x576" Audiorate="192" Audiotranscode="0" />
<setup name="DVD" ext="NONE" Videorate="1000" fps="25" Videotranscode="0" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" />
<setup name="File" ext="MPG" Videorate="1000" fps="25" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" />
<setup name="File" ext="MPEG" Videorate="1000" fps="25" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" />
<setup name="File" ext="M2P" Videorate="1000" fps="25" Videotranscode="0" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="0" />
<setup name="File" ext="MPV" Videorate="1000" fps="25" Videotranscode="0" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="0" />
<setup name="File" ext="DAT" Videorate="1000" fps="25" Videotranscode="0" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="0" />
<setup name="File" ext="AVI" Videorate="2048" fps="25" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" />
<setup name="File" ext="ASF" Videorate="1000" fps="25" Videotranscode="1" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="1" />
<setup name="File" ext="TS" Videorate="1000" fps="25" Videotranscode="0" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="0" />
</vlc>
</pre>

Use a unix compatible editor, like UltraEdit, edit lines 4 and 5. The server ip to fit the IP-address of the backend PC. Startdir and cddrive to fit correspondingly the movie folder and the cddrive on the backend pc.
Save it to a file called movieplayer_My_Server.xml to your dreambox's /var/etc folder. (save the file locally and FTP it to your dreambox, log in to your dreambox with default username root and password dreambox, or set up UltraEdit to save directly using FTP; your choice).

'''Update for latest version of VLC Frontend VLCF-Final''' 
This new VLC Frontend works slightly different. It is downloaded and installed in the same way as the earlier versions, but configuring it is a bit more easy. 
There is now a file called '''''vlcf_original.xml''''' in '''''/var/tuxbox/config/'''''. It opens the possibility to configure more than one streaming server (up to 4) using only this one config file as opposed to changing config-files on earlier versions of VLCF. 
Now, open the file through a Unix compatible editor like UltraEdit or similar editor(Notepad is no good). I modified the following lines: 
'''Line 4:''' Inserting the correct IP of my streaming server. 
'''Line 8:''' Setting the correct Startdir and cddrive. 
 
Once editing has been done, save the file to your dreambox' /var/tuxbox/config as vlcf.xml.
 
 
As you can see, the config file is put together by 4 config sets. set1, set2, set3 and set4. These will be reflected in the VLCF application on the dreambox as you can configure the frontend to use either of these 4 sets.

<pre>
<?xml version="1.0" encoding="iso-8859-1" ?>
<?xml-stylesheet type="text/xsl" href="/XSLMPSettings.xsl"?>
<vlc>
<server name="set1" ip="192.168.1.10" webif-port="8080" stream-port="9090" user="admin" pass="admin" /> 
<server name="set2" ip="192.168.178.93" webif-port="8080" stream-port="9090" user="admin" pass="admin" />
<server name="set3" ip="192.168.178.94" webif-port="8080" stream-port="9090" user="admin" pass="admin" />
<server name="set4" ip="192.168.178.25" webif-port="8080" stream-port="9090" user="admin" pass="admin" />
<config name="set1" startdir="c:\movies" cddrive="g:" /> 
<config name="set2" startdir="/home/mordillo/video" cddrive="/media/cdrom0" />
<config name="set3" startdir="d:/" cddrive="g:" />
<config name="set4" startdir="c:/" cddrive="g:" />
<codec mpeg1="mpgv" mpeg2="mp2v" audio="mpga" />
<setup name="SVCD" pic="mp4.png" ext="NONE" Videorate="1000" Videotranscode="0" Videocodec="mpeg2" Videosize="352x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="VCD" pic="mp4.png" ext="NONE" Videorate="1000" Videotranscode="0" Videocodec="mpeg1" Videosize="352x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="DVD" pic="default.png" ext="NONE" Videorate="1000" Videotranscode="0" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="mpg.png" ext="MPG" Videorate="1000" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="mpg.png" ext="MPEG" Videorate="1000" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="mpg.png" ext="M2P" Videorate="1000" Videotranscode="0" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="mpg.png" ext="MPV" Videorate="1000" Videotranscode="0" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="mpg.png" ext="DAT" Videorate="1000" Videotranscode="0" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="divx.png" ext="AVI" Videorate="2048" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="divx.png" ext="MOV" Videorate="2048" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="wmv.png" ext="WMV" Videorate="2048" Videotranscode="1" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="h264.png" ext="H264" Videorate="2048" Videotranscode="1" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="mp4.png" ext="MP4" Videorate="2048" Videotranscode="1" Videocodec="mpgv" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="divx.png" ext="DIVX" Videorate="2048" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="default.png" ext="ASF" Videorate="1000" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="default.png" ext="TS" Videorate="1000" Videotranscode="0" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="dvd.png" ext="VOB" Videorate="1000" Videotranscode="0" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="dvd.png" ext="ISO" Videorate="1000" Videotranscode="0" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="dvd.png" ext="BIN" Videorate="1000" Videotranscode="0" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="0" fps="25" soutadd="soverlay,senc" />
<setup name="File" pic="mp3.png" ext="MP3" Videorate="2048" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="" />
<setup name="File" pic="mp3.png" ext="WMA" Videorate="2048" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="" />
<setup name="File" pic="mp3.png" ext="WAV" Videorate="2048" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="" />
<setup name="File" pic="mp3.png" ext="OGG" Videorate="2048" Videotranscode="1" Videocodec="mp2v" Videosize="704x576" Audiorate="192" Audiotranscode="1" fps="25" soutadd="" />


</vlc>
</pre>

Now that the xml file has been made and transferred to the dreambox it is time to set up the backend VLC to feed the frontend.

'''VLC for Windows:''' 
Start VLC on the PC. 
Select File - Open Network Stream (Ctrl-N) 
Click Advanced Options 
- check Stream/Save and click Settings 
- check HTTP 
- check Video codec and select mp2v from the dropdown list. 
- check Audio codec and select mpga from the dropdown list. 
- click Ok 
- click Ok 
 
Now, activate the WebInterface (WEBIF) by selecting Settings - Add Interface - Web Interface from the VLC menu.

'''VLC for Linux (ubuntu):''' 
First, install vlc by running this command:
<pre>apt-get install vlc</pre>
This will in general install a ****load of stuff, codecs and other things needed. As I learnt, it is also required to install something called the avahi-daemon. This is done by running this command:
<pre>apt-get install avahi-daemon</pre>
If you are having trouble finding these packages, you might want to run:
<pre>apt-get update</pre>
Now that all this has been installed, you need to launch VLC using the following command-line:
<pre>vlc -d -I http --sout="#transcode{vcodec=mp2v,vb=1024,scale=1,acodec=mpga,ab=192,channels=2}:duplicate{dst=std{access=http,mux=ts,dst=:9090}}"</pre>
This specifies that the web interface is to be used, together with some transcoding stuff ;-)

At the time of writing this, I am still trying to tune the vlc backend a bit. It is currently using 50%+ cpu when streaming...

Now it is time to start the VLC frontend on the dreambox and set it up to use the correct xml file.
Start VLC frontend plugin by starting blue panel (blue button on the remote) and selecting Plugins. VLC Frontend will show up as a plugin, select it and press Ok.

VLC frontend is now started, select settings (blue button). 
In the dropdown list, select the xml file you created earlier, movieplayer_My_Server.xml. 
Then select Switch. 
You will now be told to restart VLC Frontend; do this by using the exit button until you are back at the plugins page. 
Now start VLC Frontend again. 
Use the red button (File). 
You will now be able to see the movie files that is in the folder specified as startdir in the xml file. 
Select the file you'd like to watch and press Ok. 
Then wait for the buffering to complete, sit back and enjoy the movie...

Subversion

2008-10-09T15:09:54Z

Bardnet: Undo revision 12538 by Yanzifei (Talk)

'''<big>This page is partially outdated. VLC and x264 have switched to [[Git]].</big>'''

The VideoLAN's repository is using [http://subversion.tigris.org/ Subversion], which is ever so slightly trendier than CVS but provides a pretty similar interface so should not be too disruptive. It also provides a better control over the repository.

Note that there is also a git mirror of the Subversion tree. You can read more about VideoLAN's git repository in our [[Git|Git wiki page]].

Currently the Subversion repository is hosted on one of the [[VideoLAN Servers]].

To use it, you have to download the [http://subversion.tigris.org/ official command line Subversion client]. You can also use alternative clients, such as the graphical [http://tortoisesvn.tigris.org/ TortoiseSVN] for Windows. When using [[Cygwin]] as compilation environment it is recommended to use the SVN package that comes with it (using the Cygwin setup). Using an "external" SVN application might otherwise cause problems with so called DOS versus UNIX "line endings" when creating files.

Subversion's command-line interface is generally pretty similar to CVS. This is a '''basic''' and partial guide of the most useful commands. For a complete guide, use the book [http://svnbook.red-bean.com/en/1.2/index.html Version Control with Subversion]. If you have a write access to the server, it's very recommended that you read it and know about the advanced features of Subversion, because you might use them sooner or later.

== Anonymous use ==
If you don't have a write access to the repository, you have to access it anonymously, via regular SVN. However, most of the techniques shown here may be useful also for developer use, so please read it even if you don't have to access the server anonymously.

=== Check out ===
First, you have to check out the code of libdvbpsi. Use the following syntax:
{{%}} <nowiki>svn checkout svn://svn.videolan.org/libdvbpsi/trunk libdvbpsi-trunk</nowiki>

You can browse the code structure using the [http://trac.videolan.org/libdvbpsi/browser VideoLAN Trac's web interface] ([http://trac.edgewall.org Trac]).
Use the three folders there for different purposes:
* [http://trac.videolan.org/vlc/browser/trunk Trunk] is the main development branch.
* The [http://trac.videolan.org/vlc/browser/branches branches] are used for stable versions and for the development of complex features.
* The [http://trac.videolan.org/vlc/browser/tags tags] are used to track the released versions.

The URL structure is:

; transport : svn://svn.videolan.org
; project repository : /vlc
; branch/tag : /trunk, or /branches/0.8.6, or /tags/0.8.5
; files : /README

You can also checkout a portion of the SVN using the URL.

'''Don't leave off the "trunk" or branch part!''' If you leave that off you check out every revision of every file in the repo, which is pretty silly.

=== Projects on VideoLAN's SVN ===

* '''svn://svn.videolan.org/vls''': VideoLAN Server (deprecated and unmaintained : {{VLC}} can now do the same);
* '''svn://svn.videolan.org/libdvdcss''': library for decrypting DVDs, used by {{VLC}} and VLS;
* '''svn://svn.videolan.org/libdvdplay''': library for DVD navigation, used by {{VLC}};
* '''svn://svn.videolan.org/libdvbpsi''': library for parsing Program Specific Information from MPEG and DVB streams, used by VLC and VLS;
* '''svn://svn.videolan.org/videolan/www.videolan.org''': the website (no trunk or branches);
* '''svn://svn.videolan.org/videolan/developers.videolan.org''': the developers website (no trunk or branches);
* '''svn://svn.videolan.org/libmpeg2''': MPEG2 library.
* '''svn://svn.videolan.org/liba52''': A52/AC3 decoder library.
* '''svn://svn.videolan.org/libdvbcsa''': DVB Common Scrambling Algorithm library

=== Updating the working copy ===
To update your working copy and get the latest files, use the following command:

{{%}} svn update

Note that SVN, unlike CVS, doesn't need to be told to prune removed files or create new directories. This is automagic.

=== Making a diff ===
Diffs, or patches, are text files which include all the changes done in the working copy.
If you suggest a new feature or like to suggest a change, send a patch to the mailing-list with [PATCH] in the subject.

To create a diff from the current repository, use the following command:

{{%}} svn diff

Normally, unlike CVS, you don't have to tell SVN which files you changed; however, you may like to diff only a part of the repository. To do that, specify the files to diff:

{{%}} svn diff modules/gui/qt4/qt4.hpp

Note that SVN defaults to the "unified" diff format, so the "-u" option doesn't have to be passed.

=== Applying a diff ===
Subversion does not contain a built in command to apply diffs to the current working copy (for example, to review or commit diffs published in Bugzilla); instead, you can use the regular [[:en:Patch (Unix)|patch]] unix utility:
{{%}} patch -p0 < patch

TortoiseSVN has a built-in support for applying a diff.

=== .cvsignore / Ignoring files ===
You can ignore some files, using metadata:
{{%}} svn propedit svn:ignore mydirectory

=== Changing file structure ===

==== Add a file ====
You can add files or folders to the working copy, to be included in the next diff or commit, using the command:
{{%}} svn add file.name

If file.name is a text-based document, you should do
{{%}} svn propset svn:eol-style native file.name

If you add a folder, it will add all the files included in the folder, except for files in the ignored list.

==== Delete a file ====
You can delete files or folders from the working copy, to be deleted in the next commit or marked as such in the next diff, using the command (which will automatically '''delete''' the files from the working copy, but won't delete folders in such way):
{{%}} svn delete file.name

Make sure the file or folder do not have local modifications, else they won't be deleted unless you force the deletion.

==== Move a file ====
You no longer create new files from scratch when moving files!
{{%}} svn mv file1 file2

You can also do it with entire folders.

=== Reverting your changes ===
If your changes in the working copy are not useful in your opinion, you can revert them using the following command:
{{%}} svn revert

You must use parameters for this command. To revert all your changes in the working copy, use:
{{%}} svn revert -R .

To revert the changes in a specific file, use:
{{%}} svn revert file.name

Reverting can also remove added files (they won't be deleted, just removed and considered "unknown files", just like you didn't use <code>svn add</code> at first), and restore deleted files (both deleted by hand and deleted by <code>svn delete</code>).

=== Checking the status of the working copy ===
You can check the status of your working copy using the following command:
{{%}} svn status

These are several important letters in the first column of the item, which show the status:
* M = the item was modified by you
* A = the item was added by you (using <code>svn add</code>)
* D = the item was deleted by you (using <code>svn delete</code>)
* ? = the item is not under the version control, but exist
* ! = the item is missing (under the version control, but not exist - probably deleted without using <code>svn delete</code>) or incomplete

=== Checking out specific revision number ===
You can check specific repository revision using following command :
{{%}} svn checkout -r 12345 svn://svn.videolan.org/vlc/trunk vlc-trunk

== Developer use ==
If you have a write access for the server, you can use an SSH access instead of HTTP access. This might change later.

=== Commits ===
Commits, or check ins, are the action of applying your changes from the working copy to the web repository. Use the following command to do that:
{{%}} svn commit

Using the command without the parameters will fail, unless you've configured an editor, because you have to enter a comment for the file logs. You can use one of the following forms:
{{%}} svn commit --message="This is the log comment."
{{%}} svn commit --file=file_with_log_comment

=== Other commands ===

{{%}} svn export
{{%}} svn propedit

Are documented in the [http://svnbook.red-bean.com/en/1.2/index.html SVN Book] that you should definitively read.

== External links ==
* [http://trac.videolan.org/vlc/browser/trunk Subversion Web access]
* [http://svnbook.red-bean.com/en/1.2/index.html Version Control with Subversion] book (SVN version 1.2)

[[Category:Building]] [[Category:Coding]]

OldFAQ

2008-10-09T15:09:03Z

Bardnet: Undo revision 12537 by Yanzifei (Talk)

{{stub}}
Answers to some common problems people encounter with VLC. More help is available in the
* [http://www.videolan.org/doc/ Documentation]
* [http://www.videolan.org/doc/faq/en/videolan-faq-en.html FAQ]
* [[Forum]]

== Installing VLC ==

=== On Mac OS 9 ===

{{faqlink|239006}}
* Sorry, VLC will not work on OS 9, and probably never will. However, Mac OS X is supported - [[Unsupported|Find out Why]]

=== Compiling VLC ===

==== How do I compile VLC? ====

* Look at [http://developers.videolan.org/vlc/ how to compile VLC]. There are pre-compiled (binary / executable) versions [http://www.videolan.org/vlc/ here].

==== Mozilla Firefox Plugin ====

* ''Debian:'' All you need is to download the vlc plugin package - mozilla-plugin-vlc ([http://packages.debian.org/stable/graphics/mozilla-plugin-vlc stable release])
* ''All Linux:'' To make the firefox plugin with the vlc player, you will first need the Firefox Development package (from: [http://packages.ubuntu.com/breezy/devel/firefox-dev ubuntu] ...). Then, when you compile, run ./configure with --enable-mozilla, and if needed with --with-mozilla-sdk-path=''/path_to_firefox_sdk''

==== "Missing header file ffmpeg/avcodec.h" and "Missing header file postproc/postprocess.h" Errors ====

* Make sure that you have all the libraries you need.
** '''on ubuntu''': "apt-get install libavcodec-dev libpostproc-dev" will install the needed files (worked on edgy).
* When you run ./configure for [[ffmpeg]], make sure that at least the following flags are set (descriptions of these avaliable from ./configure --help )
./configure --enable-shared --enable-shared-pp --enable-pp --enable-gpl
* The path of ffmpeg is not set. Check if you can locate the file '''libavcodec.pc''' on your computer, and export PKG_CONFIG_PATH to where you found it before running ./configure. For example
export PKG_CONFIG_PATH=/home/you/ffmpeg/

With vlc-086f, FFmpeg SVN-r13060, on Slamd64 12.0.0, some other changes must be made. These are most likely due to changes in libpostproc.

The ./configure flags for ffmpeg become
./configure --enable-postproc --enable-shared --enable-gpl

Then you must set a symbolic link for postproc. This took me a long time to spot.

root @ svr (/usr/src/vlc-0.8.6f)locate postprocess.h
/usr/local/include/libpostproc/postprocess.h
root @ svr (/usr/src/vlc-0.8.6f)cd /usr/local/include/
root @ svr (/usr/local/include)ln -s libpostproc postproc

==== "cc1: error: invalid option `tune=opteron'" Error on 64-bit systems ====

* One user writes: "From what I can see, the -mtune flag is not available for this type of processor in man gcc. I had to change the configure options comment out all the lines where they set mcpu or mtune flags.) I don't know if this is the correct way to proceed but was the only way for me to get results fast."

* This is not true on all versions of gcc. Try to compile on your platform before making the above changes.

root @ p01 (/usr/src/vlc-0.8.6f)gcc --version
gcc (GCC) 4.1.2

root @ p01 (/usr/src/vlc-0.8.6f)uname -a
Linux p01 2.6.24.3 #2 SMP Tue Apr 8 12:01:03 EDT 2008 x86_64 x86_64 x86_64 GNU/Linux

root @ p01 (/usr/src/vlc-0.8.6f)grep tune= config.log
configure:37114: checking whether gcc accepts -mtune=athlon64
configure:37125: gcc -c -Wsign-compare -Wall -pipe -mtune=athlon64 -DSYS_LINUX conftest.c >&5

root @ p01 (/usr/src/vlc-0.8.6f)grep cpu= config.log
build_cpu='x86_64'
host_cpu='x86_64'
target_cpu='x86_64'

==== "/usr/bin/ld: cannot find -lX11" Error on 64-bit systems ====

* In configure, there is an x_libraries variable there that is set to "/usr/X11R6/lib" (around line 16371). Because it is a 64 bit system, this variable needs to be /usr/X11R6/lib64. After changing that, it should continue compiling.

==== "syntax error before "pthread_spinlock_t"" on debian-Etch or CentOS ====

* If you have errors about ''pthread_spin*'' in the file ''vlc_threads_funcs.h'', try this fix :
su
sed -e 's/define\s*_POSIX_SPIN_LOCKS\s*/define _POSIX_SPIN_LOCKS -1 \/\/ wrong: /g' -i /usr/include/bits/posix_opt.h
exit
source : [http://forum.videolan.org/viewtopic.php?f=13&t=43930#p139570 this post] from Rémi Denis-Courmont.

=== Installing Skins ===

* Although all information is given on the [http://www.videolan.org/vlc/skins.php VLC Download skin site], you may miss the note to change preferences to ''skinnable interface''. There is an [http://forum.videolan.org/viewtopic.php?p=85603#p85603 article on the forum] which describes the how-to. In short: there is a drop-down option (interface module) in the settings dialog (Interface → General) which defaults to ''Standard''. Change this and restart.

== Problems Starting VLC ==

=== VLC does not launch on my Mac anymore. What to do? ===

* Please have a look at the [[FAQ_on_MacOSX_only_issues|specific FAQ]], which covers multiple solutions to this issue.

== Error Messages ==

Error messages can be viewed by selecting Messages from the View menu.

=== main private error: no sout mux module matched "ts" ===

* This can be an error if '''libdvbpsi''' was not installed when vlc was compiled. To fix this error, install libdvbpsi; then re-compile vlc. [http://developers.videolan.org/libdvbpsi/ libdvbpsi]

=== main dialogs provider error: no dialogs provider module matched "any" ===

* The solution is found in [http://forum.videolan.org/viewtopic.php?t=14733 the forum]

== Problems playing types of files ==

=== WMV files ===

* Starting with VLC media player 0.8.6, the playback of WMV3-encoded videos is available on all platforms. Please note, that encrypted / DRM-protected video-clips still cannot be played. That is due to the nature of DRM and is not about to change, so please do not ask.

=== Real Media files ===

* Realmedia files (.rm, .rpm, etc) are proprietary (ie, copyrighted) file formats, created by RealNetworks. Because of this, VLC can't support them at present.

=== QuickTime Files (.mov) ===

* Mov file doesn't play, but plays ok in QuickTime
** open the url in QuickTime player
** let it decide which datarate is best for your connection
** let it play for a few seconds, then pause it
** open the stream info, copy the url
** open & save that one in VLC

=== Flash Video Files (.flv) ===

* Flash Video support has recently been added (provided through ffmpeg) - to view .flv files you will need version 0.8.4a. Download and install the latest version [http://www.videolan.org/vlc/ here].
* VLC still has problems with a few .flv files. If you have problems playing a file in VLC you might be able to change it to an avi using [[ffmpeg]]. See [[Fixing .flv to .avi with Ffmpeg]].
* VLC 0.8.6 provided enhanced Flash Video support on all platforms, so it is probably worth to update if you experience problems with prior releases.

=== Other Files ===

{{faqlink|238663}}
* Make sure that VLC supports that file - look at the [http://www.videolan.org/vlc/features.html list of supposted formats]

* Make sure that the file isn't corrupted

== VLC and Other Programs ==

=== AMR ===

* To use [http://en.wikipedia.org/wiki/Adaptive_Multi-Rate AMR], you'll need to compile vlc and ffmpeg with amr support yourself. This is because the amr license is not compatible with the vlc license.

=== ratDVD ===

* VLC does not support [http://en.wikipedia.org/wiki/RatDVD ratDVD] and is not going to be, both for political and technical reasons.

== Problems Playing DVDs ==

===Unable to play any DVDs===

{{faqlink|239006}}
* ''Linux:'' To play DVDs with VLC in linux, you need to install the libdvdcss package
* ''Linux:'' Make sure you have access rigths to your DVD player. In linux, you can use chmod to edit access rights to your DVD block device:
** <nowiki>#</nowiki> chmod 666 /dev/dvd
** The videolan FAQ seems to suggest you need write access to this device - is this true? If you know, please edit this entry.
* ''Linux:'' Make sure VLC knows where your DVD drive is located (/dev/dvd usually). Go to Settings | Preferences | Input/Codecs | General and under "Default devices" make sure your dvd drive path is entered in the "Default DVD" box. When you go to open a DVD, you should see something like "dvd:///dev/dvd" as the [[media resource locator]] in the "Open:" box near the top of the Open dialog.

=== Playing DVDs from other Region Codes ===

{{faqlink|239426}}
* The ability to play DVDs from all regions depends mostly on your DVD drive, and testing it is usually the quickest way to find out if your DVD drive can do it. Most newer DVD drives are RPC2 drives, which don't allow raw access to the drive untill the drive firmware has done a regioncheck. VLC uses libdvdcss and it needs raw access to the DVD drive to crack the encryption key. So with these drives it is impossible to circumvent the region protection. (This goes for all software. You will need to flash your drives firmware, but sometimes there is no alternate firmware available for your drive). On other RPC2 drives that DO allow raw access, it might take VLC a long time to crack the key. So just pop the disc in your drive and try it out, while you get a coffee. RPC1 drives should 'always' work regardless of the regioncode.

== Poor Quality Video and Audio ==

=== The video runs but the picture is distorted ===

{{faqlink|238431}}
* ''Linux:'' There is probably a problem with the output layer. There are several ways of troubleshooting it.
** First, try with another output plugin, for instance:
**: % vlc -V sdl
**: % vlc -V x11
** Second, change your screen depth and/or definition. It quite often helps.
** Lastly, if running Unix, have a look at your XFree86 video driver.

=== Video is choppy ===

{{faqlink|238474}}
* Your system may be too slow to decode all pictures. Sometimes, your CPU (computer) really isn't fast enough, but often the situation can be improved by changing your system configuration to be a bit kinder to VLC.
** Quit other programs running in the background
** Turn on DMA on your DVD device:
*** ''Linux:''
***: <nowiki>#</nowiki> hdparm -d1 /dev/dvd
*** ''Windows:'' go to the System section of the control panel, and go to the Hardware manager (it is sometimes in a separate tab, and sometimes, you have to go to the Advanced tab. Then, right-click on your DVD player, and check the DMA checkbox.
** Upgrade to the latest driver for your video board.
** ''Linux:'' you can additionally upgrade your drivers to the latest XFree86 version. If supported, check that the xvideo plug-in is effectively used with:
**: % vlc -vvvv

=== Audio and video are out of sync ===

{{faqlink|238571}}
* If you are [[transcoding]] a file, use the [[audio-sync]] option.
* You can manually set the audio offset while playing (so you can put the audio back in sync). The default keys to increase/decrease the offset are Ctrl+K and Ctrl+L in Windows, and f and g in Mac.
* ''Linux/Unix:'' Try using another audio output plugin and, under Unix, kill esd or artsd if they are running. If the problem is due to the input file, have a look at the "Audio desynchronization compensation" option.

== Problems with Streaming ==

==="main input error: no suitable access module for `rtsp://...'"===

vlc needs livemedia from '''live555.com''' to read rtsp stream this way.

You can check you have it by :

vlc -l | grep live

It should read

livedotcom live.com (RTSP/RTP/SDP) demuxer
livedotcom RTSP/RTP access and demux

If not, you have to install '''livemedia''' and point your compilation to this lib directory :

./configure '''--enable-livedotcom --with-livedotcom-tree=/usr/local/lib/live/'''

===Streaming playlist continuously between files (sout-keep not working)===

you should add gather-module sout-chain, example
vlc *mpeg --sout-keep --sout '#gather:transcode{plapla}:rtp{plapla}'

===Streaming 1 playlist item continuously and change input without stream break===

you can use this kinda vlm.conf file and --sout-keep option
new output1 broadcast enabled loop
setup output1 input "inputfile1.mpeg"
setup output1 input "inputfile2.mpeg"
setup output1 input "/path/to/inputfile3.mpeg"
setup output1 option sout-keep
setup output1 option input-repeat=-1
setup output1 output #gather:transcode{etc...}:std{plapal}

control output1 play 2

you then chan telnet into vlm and just command
control output1 play <playlistnumber>
to change streamed input.

===Streaming to Windows Media Player===

See [[Windows Media Player]] for details.

== Problems converting between file formats (transcoding) ==

=== Missing Audio and/or Video ===

* Certain containers (aka muxers) can only hold certain types of video and audio - look at [http://www.videolan.org/streaming/features.html Streaming features]

== Streaming/Transcoding Wizard ==

=== Transcode / Save to file ===

* Partial Extract "From" "To" does not work, allone "To" don´t too.
: I've tested it too with the 0.8.6c version, already specifying the time data in seconds, and this parameter has no effect.

== VLC Crashes ==

=== General ===

{{faqlink|238592}}
* If VLC crashes, the following steps will help determine the cause.
** Increase the verbosity level (either in the preferences or with a -vvvv command line option) and look at the debug messages (in the terminal or in the Messages window).
* If you are convinced that it is a bug in VLC, have a look at the [http://www.videolan.org/support/bug-reporting.html bug reporting page].

=== When using DirectShow (eg Webcam) ===

{{forum|12394}}
* There was a bug a while back when you tried to stream using a directshow/webcam it would reboot the computer. The fix was to specify the resolution on the command line or in the "Advanced" section when opening the directshow.

== Other Problems ==

=== I only want one VLC player! ===

* To use the same VLC player for all the media files, go to Settings, Preferences, Advanced. The following options should give behavior similar to WMP: minimize # of threads, allow only one running instance, VLC is started from file association, allow only "on" running instance when started from file (typo in v0.8.5).

=== Licensing, legal issues and logo use ===

* Information on this is avaliable on the main videolan website, [http://videolan.org videolan.org]. Also read the [http://www.videolan.org/doc/faq/en/index.html#id238663 Legal concerns] section of the [http://www.videolan.org/doc/faq/en/index.html FAQ].
* This is a wiki site: it is editable by all, so it is best to check to official website.

=== Fixing Strange Behaviour ===

{{faqlink|238992}}
* The first thing to do is to reset the VLC preferences in the preferences dialog of the application and restart VLC. If VLC doesn't even start anymore, delete VLC's configuration file ([[#Configuration File|where is it?]]). Then restart VLC. If it does not get any better, read the rest of this page or FAQ page, or ask for help at the [[forum]].

=== Subtitles Problem ===

* In the File | Open File dialog, select "Use a subtitles file", and enter both the video's filename and the video's subtitle filename.
* If you are having displaying the subtitles, the problem might be an encoding problem. Choose the right encoding for your language and it should fix your problem. You'll find the ISOs here: [http://alis.isoc.org/codage/iso8859/jeuxiso.en.htm]. Once you find a text encoding method that works well for you enter it in Preferences, Input / Codecs, Other codecs, Subtitles then press Save and restart VLC. If you have a specialized language like Hebrew, Arabic, Chinese or Japanese changing the font to a Unicode font will be helpful. For Polish subtitles choose CP 1250 ISO code.

=== No Sound on DirectShow Capture ===

* As odd as it sounds, try setting the sound device to 'none'. See also [http://forum.videolan.org/viewtopic.php?t=2859].

=== VLC hangs when opening Matroska (mkv) files ===

* This might occur when using VLC to view an mkv file in a directory that has a large number of mkv files. (eg. in an Azureus download directory)
VLC will attempt to preload all the mkv files in the directory and will hang, especially if some mkv files are not fully downloaded yet (thus seem to be broken).
* The solution is to set the mkv option: --mkv-preload-local-dir to false
Preferences -> Input / Codecs -> Demuxers -> Matroska -> Preload Directory (uncheck the checkbox)
(See also http://wiki.videolan.org/Matroska)

Win32CompileMSYSOld

2008-10-09T15:08:31Z

Bardnet: Undo revision 12539 by Yanzifei (Talk)

MSYS/MinGW environment for Windows from http://developers.videolan.org/vlc/msys-compile.txt

TODO: GPAC, NSIS, PKG-Config, more than just setting up the environment...

THIS ARTICLE IS UNDER CONSTRUCTION!!!

=Introduction=

=MSYS/MinGW environment=

Setting up a working MSYS/MinGW environment requires the following:

* MSYS installation
* Updating MSYS
* MSYS DTK (Developer Tool Kit)
* Updating bash (shell)
* MinGW installation
* Configuration of fstab
* Creation of home folder

Note that the following generic resource locations were used to download the appropriate packages (and more recent versions might be obtained from here):

[http://prdownloads.sourceforge.net/mingw MSYS/MinGW related]

[http://prdownloads.sourceforge.net/nasm nasm]

[http://www.libsdl.org SDL]

[http://www.info-zip.org zip]

[http://pkgconfig.freedesktop.org/releases pkg-config]

[ftp://ftp.gnu.org/pub/gnu/sed sed]

==Minimal SYStem (MSYS) installation==

http://prdownloads.sourceforge.net/mingw/MSYS-1.0.11-2004.04.30-1.exe

Perform a basic installation into C:\msys

Do not continue with the post install (this will be done later).

==Update MSYS==

Update MSYS to a more recent version

http://prdownloads.sourceforge.net/mingw/MSYS-1.0.11-20060807.tar.bz2

Extract the .tar.bz2 file, it contains the following files:

mount.exe
msys-1.0.dll
ps.exe

Copy the files to:

C:\msys\bin

This will overwrite/update the version(s) used in MSYS.

==MSYS DTK (Developer Tool Kit)==

http://prdownloads.sourceforge.net/mingw/msysDTK-1.0.1.exe

Perform a basic installation into C:\msys

==Updating BASH==

http://prdownloads.sourceforge.net/mingw/bash-3.1-MSYS-1.0.11-snapshot.tar.bz2

Extract the .tar.bz2 file, in the bin subfolder it contains the following files:

bash.exe
sh.exe

Copy the files to:

C:\msys\bin

This will overwrite/update the sh.exe version used in MSYS

==MinGW==

http://prdownloads.sourceforge.net/mingw/MinGW-5.0.3.exe

Select the download option.

Do not install with "Current" MinGW packages but select "Candidate".

Select the following components to install:

MinGW base tools (autoselected)
g++ compiler

Then installation will finish downloading automatically.

Run MinGW-5.0.3.exe again and select the download and install option to restart the installation.

Selet "Candidate" still and select the same components to install.

Perform the installation into the default destination:

C:\msys\mingw

The following versions (or possibly newer) of the candidate packages will be
downloaded and installed:

mingw-runtime-3.10.tar.gz
w32api-3.7.tar.gz
binutils-2.16.91-20060119-1.tar.gz
gcc-core-3.4.5-20060117-1.tar.gz
gcc-g++-3.4.5-20060117-1.tar.gz

(It is also possible to get these packages seperately and extract them to C:\msys\mingw)

==Configuring fstab==

The folder C:\msys\etc contains the following file:

fstab.sample

Copy the file to:

fstab

Open the file with a text editor and change the path value for the mingw mount point from:

c:/mingw to c:/msys/mingw

Save the file.

==Starting MSYS==

The first time MSYS is started, a "home" folder is created, for example:

C:\msys\home\Administrator

=Installing additional packages=

The following packages are required for building VLC

* Wget
* Iconv
* Gettext
* MinGW utils
* Libtool
* Autoconf
* Automake
* Zip
* Coreutils

==WGet==

Wget is required for building from the "extras/contrib" or mingwPORT packages.

http://prdownloads.sourceforge.net/mingw/wget-1.9.1-mingwPORT.tar.bz2

Although this is a mingwPORT package it already has a precompiled wget on board.

Extract the .tar.bz2 file. It contains the following file in the bin subfolder:

wget.exe

Copy the file to:

C:\msys\mingw\bin

==Iconv (GNU libiconv)==

http://prdownloads.sourceforge.net/mingw/libiconv-1.8.0-2003.02.01-1.exe

Perform a basic installation into the default destination Folder

C:\msys\mingw

===Updating Iconv===

http://prdownloads.sourceforge.net/mingw/libiconv-1.10-mingwPORT.tar.bz2

Extract the .tar.bz2 file. Copy the contents into your home folder in MSYS

C:\msys\home\Administrator (example)

Start the MSYS shell and do the following commands:

cd libiconv-1.10-mingwPORT/libiconv-1.10/mingwPORT

mkdir -p /usr/src/libiconv-1.10

./mingwPORT.sh

Follow the default installation.

If all went well all the appropriate libraries should be installed/built and placed into c:/msys/mingw/lib.

NOTE: For some unknown reason usage of Iconv fails when 1.10 is installed directly without having installed 1.8.0.

==Gettext==

This approach breaks libiconv.. under investigation..

http://downloads.sourceforge.net/mingw/gettext-0.16.1-1-bin.tar.bz2

Untar this packet and copy the files in the subdirectories under gettext-0.16.1-1-bin/usr/local to the corresponding subdirectories under C:\msys\mingw.
For example:
copy gettext-0.16.1-1-bin/usr/local/lib/*.* to C:\msys\mingw\lib\
......................................................
Note:
The latest VLC from svn requires gettext-0.16.xx to build.

==MinGW Utils==

The unix2dos tool from this package is required during the "make package" process of VLC for some conversion of txt files.

http://prdownloads.sourceforge.net/mingw/mingw-utils-0.3.tar.gz

Extract the .tar.gz file. it contains the following file in the bin subfolder:

unix2dos.exe

Copy the file to:

C:\msys\mingw\bin

==Libtool==

http://prdownloads.sourceforge.net/mingw/libtool-1.5.22-mingwPORT.tar.bz2

Extract the .tar.bz2 file. Copy the contents into your home folder in MSYS

C:\msys\home\Administrator (example)

Start the MSYS shell and do the following commands:

cd libtool-1.5.22-mingwPORT/libtool-1.5.22/mingwPORT

mkdir -p /usr/src/libtool-1.5.22

./mingwPORT.sh

Follow the default installation.

If all went well all the appropriate libraries should be installed/built and placed into c:/msys/mingw/lib.

==Autoconf==

http://prdownloads.sourceforge.net/mingw/autoconf-2.59-mingwPORT.tar.bz2

Extract the .tar.bz2 file. Copy the contents into your home folder in MSYS

C:\msys\home\Administrator (example)

Start the MSYS shell and do the following commands:

cd autoconf-2.59-mingwPORT/autoconf-2.59/mingwPORT

mkdir -p /usr/src/autoconf-2.59

./mingwPORT.sh

Follow the default installation.

If all went well all the appropriate libraries should be installed/built and placed into c:/msys/mingw/lib.

==Updating autoconf from contrib==

VLC 0.8.6 and later (including 0.9.0 svn/development) require an autoconf version
of 2.60 or greater.

If during the configure process the following msg appears it's time to update:

"Hey, your autoconf is quite old. Update it".

Open your MSYS shell:

cd vlc-trunk/extras/contrib

./bootstrap

cd src

make .autoconf

==Automake==

http://prdownloads.sourceforge.net/mingw/automake-1.9.5-mingwPORT.tar.bz2

Extract the .tar.bz2 file. Copy the contents into your home folder in MSYS

C:\msys\home\Administrator (example)

Start the MSYS shell and do the following commands:

cd automake-1.9.5-mingwPORT/automake-1.9.5/mingwPORT

mkdir -p /usr/src/automake-1.9.5

./mingwPORT.sh

Follow the default installation.

If all went well all the appropriate libraries should be installed/built and placed into c:/msys/mingw/lib.

==Zip==

Zip is required for making .zip packages...

http://www.info-zip.org/

ftp://ftp.info-zip.org/pub/infozip/WIN32/zip232xN.zip

Extract the .zip. It contains the following file in the bin subfolder:

zip.exe

Copy the file to:

C:\msys\bin

==Coreutils==

The whoami tool from this package is required for "svn builds".

http://prdownloads.sourceforge.net/mingw/coreutils-5.97-MSYS-1.0.11-snapshot.tar.bz2

Extract the .tar.bz2 file. it contains the following file in the bin subfolder:

whoami.exe

Copy the file to:

C:\msys\mingw\bin

=Optional packages=

==GDB (optional)==

GDB is used for debugging purposes.

http://prdownloads.sourceforge.net/mingw/gdb-6.3-2.exe

Perform an installation into the folder

C:\msys\mingw

==ZLib (optional)==

Zlib is a required package in combination with the Gpac package for .avs and
.mp4 output support when building the x264 library.

http://prdownloads.sourceforge.net/mingw/zlib-1.2.3-mingwPORT-1.tar.bz2

Extract the .tar.bz2 file. Copy the contents into your home folder in MSYS

C:\msys\home\Administrator (example)

Start the MSYS shell and do the following commands:

cd zlib-1.2.3-mingwPORT/zlib-1.2.3/mingwPORT

mkdir -p /usr/src/zlib-1.2.3

./mingwPORT.sh

Follow the default installation.

If all went well all the appropriate libraries should be installed/built and placed into c:/msys/mingw.

==Updating SDL from mingwPORT (optional)==

SDL support is required when building ffplay from the FFmpeg package.

http://prdownloads.sourceforge.net/mingw/SDL-1.2.8-mingwPORT.tar.bz2

Extract the .tar.bz2 file. Copy the contents into your home folder in MSYS

C:\msys\home\SDL-1.2.8-mingwPORT (example)

Start the MSYS shell and do the following commands:

cd SDL-1.2.8-minwPORT/SDL-1.2.8/mingwPORT

mkdir -p /usr/src/SDL-1.2.8

./mingwPORT.sh

Follow the default installation.

If all went well all the appropriate libraries should be installed/built and placed into /usr/local/lib.

===Updating SDL (optional)===

http://www.libsdl.org/release/SDL-1.2.11.tar.gz

Extract the .tar.gz file. Copy the contents into your home folder in MSYS

C:\msys\home\SDL-1.2.11 (example)

Start the MSYS shell and do the following commands:

cd SDL-1.2.11

./configure

make

make install

If all went well all the appropriate libraries should be installed/built and placed into /usr/local/lib.

==Nasm (optional)==

The Netwide assembler (nasm) is required for building the x264 library.

http://sourceforge.net/project/showfiles.php?group_id=6208

Download the latest win32 binaries:

http://prdownloads.sourceforge.net/nasm/nasm-0.98.39-win32.zip?download

Extract the .zip. It contains the following file in the bin subfolder:

nasmw.exe

Rename the file to nasm.exe and copy it to the following location:

C:\msys\mingw\bin

==GPAC (optional)==

GPAC is required for building the x264 library with mp4 output support.

Start the MSYS shell and do the following commands:

cvs -z3 -d:pserver:anonymous@gpac.cvs.sourceforge.net:/cvsroot/gpac co -P gpac

This will download the latest GPAC version from CVS.

cd gpac

./configure

make install-lib

TODO: copy GPAC files to appropriate folder automagically.

==x264 (optional)==

Start the MSYS shell and do the following commands:

svn co svn://svn.videolan.org/x264/trunk x264-trunk

cd x264-trunk

For generic purposes:

./configure

make

For VLC:

./configure --prefix=/usr/win32

make

make install

This will copy the appropriate libs and .h to the prefix folder which will also be used by VLC for building the contrib

For compiling "stand-alone with mp4 output support" (this requires GPAC):

./configure --enable-mp4-output

make

If you wish to compile FFmpeg stand-alone with x264 support then also do this

make install

This will copy the appropriate libs and .h files to the default /usr/lib and /usr/include

==FFmpeg (optional)==

Start the MSYS shell and do the following commands:

svn co svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg-trunk

cd ffmpeg-trunk

For generic purposes:

./configure --enable-mingw32 --enable-memalign-hack \
--enable-gpl --enable-pp

make

For compiling with x264 support:

(This assumes you did a "make install" for x264 which will have copied the appropriate lib and .h files into lib/include).

./configure --enable-mingw32 --enable-memalign-hack \
--extra-cflags=-I/usr/local/include \
--extra-ldflags=-L/usr/local/lib \
--enable-gpl --enable-pp --enable-x264

make

For compiling into VLC:

(This does not need x264 lib in FFmpeg since VLC uses that directly, also prefix and extra flags are used to point to the "contrib" folder):

./configure --enable-mingw32 --enable-memalign-hack \
--extra-cflags=-I/usr/win32/include \
--extra-ldflags=-L/usr/win32/lib \
--prefix=/usr/win32 \
--enable-faac --enable-mp3lame --enable-gpl --enable-pp

make

make install-libs install-headers

This will copy all the appropriate libs and .h files into usr/win32/include and lib so they can be used by VLC compilation.

=FAQ=

Various troubleshooting issues..

==Make .qt4 from extras/contrib==

Fails on:

checking for libmpeg2.a in /home/Administrator/vlc-trunk/./extras/contrib/src/mpeg2dec... no
configure: error: cannot cd to /home/Administrator/vlc-trunk/./extras/contrib/src/mpeg2dec

Workaround: configure with

--without-contrib

==Make package-win32-zip==

Fails on:

sed -i 's%share/osdmenu%osdmenu%g' ./vlc-0.9.0-svn/osdmenu/*.cfg
sed: invalid option -- i

Workaround: compile sed 4.09 (any newer versions fail to compile on missing alloca)

ftp://ftp.gnu.org/pub/gnu/sed/sed-4.0.9.tar.gz

use the newer sed version in c:\msys\mingw\bin and rename the old one to sed3.exe or something

ONLY use the 4.09 sed to do a make package-win32-zip, it will fail to compile VLC source
(so after it finishes, you have to copy the old version back again).

So in conclusion:

make package-win32-zip fails with sed 3.02 on -i
make autoconf fails with sed 4.09 on -E
sed 4.10+ requires glib
glib requires pkgconfig but pkgconfig requires glib?!

==Warnings during configure==

Using contrib from 20061015 still a lot of warnings during configure:

checking dynamic linker characteristics... ./configure: line 14697: f77: command not found
./configure: line 14825: f77: command not found

configure: WARNING: libshout library not found
configure: WARNING: MusicBrainz library not found
configure: WARNING: CD Reading and information library not found
configure: WARNING: VCD information library not found
configure: WARNING: new enough libcddb not found. CDDB access disabled

checking for mpcdec/mpcdec.h... yes
configure: WARNING: only static linking is available, you must provide a gme-tree

./configure: line 54814: --exists: command not found

configure: WARNING: Probe disc disabled because ok libcdio library not found
configure: WARNING: VCD information on Probe disc disabled because ok
libvcdinfo not found
configure: WARNING: QT4 library not found
configure: WARNING: DAAP library not found
configure: WARNING: avahi-client library not found

==Can not write to output file with unix2dos==

unix2dos: converting file ./vlc-0.9.0-svn/AUTHORS.txt to DOS format ...
unix2dos: can not write to output file
unix2dos: problems converting file ./vlc-0.9.0-svn/AUTHORS.txt
unix2dos: converting file ./vlc-0.9.0-svn/MAINTAINERS.txt to DOS format ...
unix2dos: converting file ./vlc-0.9.0-svn/THANKS.txt to DOS format ...
unix2dos: can not write to output file

Workaround:
Load file in emacs and do
M-x set-buffer-file-coding-system RET undecided-dos
or
C-x RET f undecided-dos
and then save the file (C-x C-s)

=Version=

20060926 Initial version

20060928 Reworked layout

20061011 Added troubleshooting section

20061119 Added FFmpeg and x264. Removed unicode warning from troubleshooting

20070113 WIKI version

[[Category:Building]]
[[Category:Coding]]

Talk:Win32CompileMSYSOld

2008-10-09T15:05:32Z

Bardnet: postproc

Would it be possible to bootstrap and make vlc-trunk/extras/contrib instead of downloading and making all the mingwPORTs? Additionally I wanted to mention that the FFMPEG section is outdated, the mentioned configure flags do not work. --[[User:Altglass|Altglass]] 12:39, 5 October 2007 (CEST)

== FFMpeg ==

Hi, --enable-pp is outdated, it's --enable-postproc and ist's --enable-libx264. --[[User:Bardnet|Bardnet]] 12:02, 9 October 2008 (CEST)

Talk:Win32CompileMSYSOld

2008-10-09T10:02:16Z

Bardnet: New section: FFMpeg

Would it be possible to bootstrap and make vlc-trunk/extras/contrib instead of downloading and making all the mingwPORTs? Additionally I wanted to mention that the FFMPEG section is outdated, the mentioned configure flags do not work. --[[User:Altglass|Altglass]] 12:39, 5 October 2007 (CEST)

== FFMpeg ==

Hi, --enable-pp is outdated, it's --enable-postprocess and ist's --enable-libx264. --[[User:Bardnet|Bardnet]] 12:02, 9 October 2008 (CEST)