VideoLAN Wiki - User contributions [en]

Git

2012-03-21T11:10:01Z

John F: /* Submitting patches to the vlc-devel or x264-devel */ adding address

[http://git-scm.com/ Git] is a free and open source [[wikipedia:Revision_control|version control system]]. It is used by programmers to keep track of the different versions of the files composing a software.

= Basic Git usage =

If you are using '''Windows''', please read the [[Git_Windows]] page.

== Getting VLC or x264 source code via Git ==

$ git clone git://git.videolan.org/vlc.git
Voilà! The full VLC history should be on your hard disk in vlc/.

$ git clone git://git.videolan.org/x264.git
Voilà! The full x264 history should be on your hard disk in x264/.

If you want only the last 3 VLC revisions:
$ git clone git://git.videolan.org/vlc.git --depth 3

Clones without the full revision set (--depth) can't be used for backporting (or to make sure that you're including at least commits up to the common fork point).

You can also clone using http via our repo.or.cz mirror.
$ git clone http://repo.or.cz/r/vlc.git

See http://repo.or.cz/w/vlc.git (it's a mirror)

=== After cloning ===

$ git log
to see the full log of the trunk.
$ gitk
to see the log graphically.

You can also browse the sources via [http://git.videolan.org/ gitweb].

== Configure your global git config ==
May need to use
$ git repo-config {various options}
1.4.4.2 Requires the repo-config command rather than just config

=== Personal Information ===
Tell git your name. (use mostly by git-commit)
$ git config --global user.name "Your Name"
$ git config --global user.email "me@example.com"

=== Mail Information ===
To send patches you'll need a working mail / sendmail configuration. You can use [http://msmtp.sourceforge.net/ msmtp] to achieve this. Install it with tls and ssl activated and place the following config file (.msmtprc) in your home directory
# msmtp configuration file

# Set default values for all following accounts.
defaults
tls on
tls_starttls on
tls_trust_file /certificates/EquifaxSecureCertificateAuthority.crt
logfile /log/.msmtp.log

# GMAIL
account gmail
host smtp.gmail.com
port 587
protocol smtp
from user.name@gmail.com
auth on
user user.name@gmail.com

# Set a default account
account default : gmail
Then configure git to use msmtp. The password will be aske for upon sending mail.
$ git config --global sendemail.smtpserver /usr/local/bin/msmtp
The certificate for gmail can be found here: [http://www.geotrust.com/resources/extended-validation-ssl/certs/Equifax%20Secure%20Certificate%20Authority.crt EquifaxSecureCertificateAuthority.crt]

=== Using git with color (Tip) ===
If you want to use git with colored output use:
$ git config --global color.ui true

If you are using an old git version (prior to 1.5.5) and previous command didn't work, use:
$ git config --global color.diff auto
$ git config --global color.status auto
$ git config --global color.branch auto

=== Setting up "git up" (Tip) ===
If you want to be able to just keep in sync using "git up" use:
$ git config --global alias.up "pull --rebase"
And if you like your tree to be messy and don't want git to complain (like in svn) use:
$ git config --global alias.up '!sh -c "git commit -a -m "Before rebase" && git pull --rebase && git reset head^"'

=== Setting up "git wu" (Git What's Up) (Tip) ===
If you want to see what you are about to "git push":
$ git config --global alias.wu "log --stat origin..@{0}"
Now use:
$ git wu
Note that this only works for the master branch.

=== Setting up "git wup" (Git What's Up - with patch) (Tip) ===
If you want to see what you are about to "git push", along with the diff:
$ git config --global alias.wup "log -p origin..@{0}"
Now use:
$ git wup

== General GIT Workflow ==
1. Make your file edits in your local repository.

2. "git commit" the changes in your local repository

3. "git pull --rebase" or "git up" (if you did ''git config --global alias.up "pull --rebase"'') to bring the rest of your local repository up to date

4. "git log origin..master" to check what you are going to commit

4. "git push" to move your changes up to the master

"git stash" if you want to "hide" your changes. Do this if you think there may be other commits against the same things you are working on and want to refresh your local checkout (using a git pull --rebase) from the master. Use "git stash apply" to get your stash back.

"git checkout -f master" if you think your tree is pretty hopeless, need a kill-and-fill to bring the master into your local repository.

== List the local branch ==
You can now list your local branch by doing
$ git branch
which should ouput
$ git branch
* master

== List your local non committed changes ==
$ git status | less

== Commit ==
Now you can start to work on your tree. As soon as you feel you have reached a step in developement where you can commit your work '''locally''', use
$ git commit -a
or
$ git commit <specific files>

If you wish to give credit to someone else's work (e.g. you are applying a third party patch):
$ git commit <specific files> --author "Name Surname <user@domain.com>"

== List your commits ==
$ git log

== Keeping your local working branch in sync ==
$ git pull --rebase

To shorten up that command type
$ git config --global alias.up "pull --rebase"

Now you can just type:
$ git up

== Use a graphical interface ==
$ gitk # Tree Browser
$ qgit # Tree Browser
$ git-gui # Commit/push/... editor

== Submitting patches to the vlc-devel or x264-devel ==

First make sure you have '''read''' our [[Sending Patches]] page. And that you've '''read''' the [[Sending Patches#Check_List| Check List]].

If you have been developing on vlc locally and (still) don't have write access, you can submit all your commits in one shot using:
$ rm -Rf patches
$ git format-patch -o patches origin
$ git send-email --to vlc-devel@videolan.org patches
If you want to create a cover letter for multiple patches use:
$ git format-patch -o patches origin -n --cover-letter
$ git send-email --annotate --cover-letter --to vlc-devel@videolan.org patches
If you have multiple patch consider using:
$ git send-email --compose --no-chain-reply-to --to vlc-devel@videolan.org patches
This will produce the patches for each local commit in the directory "patches" and send them.
Use --no-chain-reply-to make sure it doesn't reply.

For x264, do the same with x264-devel@videolan.org


Don't do:
* [PATCH 0/m]
** [PATCH 1/m]
*** [PATCH 2/m]
**** ...
But do:
* [PATCH 0/m]
** [PATCH 1/m]
** [PATCH 2/m]
** ..

= Advanced usage =
== Creating a secondary local branch ==
If you want to work on a specific project that could require a branch of the trunk, create a local branch of the current branch by doing:
$ git branch mywork
and to actually use it do:
$ git checkout mywork
Which could be summarized by:
$ git checkout -b mywork

Then do some commit on it... And you can go back to your original master branch by doing:
$ git checkout master

== Fetching a remote branch ==
To see the remote branch use:
$ git branch -r
If the remote branch is named 0.8.6-bugfix
$ git branch 0.8.6-bugfix origin/0.8.6-bugfix
Branch 0.8.6-bugfix set up to track remote branch refs/remotes/origin/0.8.6-bugfix.
$ git branch
0.8.6-bugfix
* master
To checkout that branch use:
$ git checkout 0.8.6-bugfix
To stay up-to-date a simple
$ git pull --rebase
Should be enough.

If warnings appear that files still need updating:
$ include/libvlc_internal.h: needs update
include/mediacontrol_internal.h: needs update
include/vlc/libvlc.h: needs update
include/vlc_update.h: needs update
modules/access/mms/mms.c: needs update
...

Then do a checkout -f to revert non committed local changes
$ git checkout -f

To stay up-to-date another
$ git pull --rebase
Should give no more warnings.

To push to the remote branch, use:
$git push origin 0.8.6-bugfix:0.8.6-bugfix

== Creating a remote branch ==
If the new remote branch is named 0.9.0-bugfix, and is based on the local master branch.
First make sure everything go as planned with the --dry-run option:
$ git push --dry-run origin master:refs/heads/0.9.0-stable
To git@git.videolan.org:vlc.git
* [new branch] master -> 0.9.0-stable

Then push it:
$ git push origin master:refs/heads/0.9.0-stable
To git@git.videolan.org:vlc.git
* [new branch] master -> 0.9.0-stable
$ git branch -r
origin/0.9.0-stable
origin/master

To checkout that branch now see ''Fetching a remote branch''

== Backporting commits ==
It is possible to "backport" commit between the master branch and a -bugfix branch. However since VDD'09, the bugfix branches have been splitted to their own git repositories. This leaves us with 2 cases.

=== Normal simple case ===

Go to your -bugfix branch:
$ git checkout 1.0-bugfix

Backport the commit:
$ git cherry-pick -x -s <sha-id of commit>

If git fails to do the backport by itself, you'll be presnted with the usual options in case of a failed merge or patching. Use "git status", your favorite editor or "git mergetool" to resolve the situation. Then use "git add" and "git commit -c <sha-id of backported commit>".
Then push your commit as usual.

=== Case of VLC bugfix branches ===
Due to the number of commits in vlc.git and the amount of divergence between the master and 1.0-bugfix branches, they have been separated into two different git repositories. But that doesn't block you from backporting.

Get the -bugfix git:
$ git clone git://git.videolan.org/vlc/vlc-1.0.git vlc-bugfix
Add vlc.git as an additional remote:
$ git remote add vlc-master git://git.videolan.org/vlc.git
Update the information from vlc-master
$ git fetch vlc-master
Backport as normal
$ git cherry-pick -x -s <sha-id of commit>

== Publishing your own fork ==
Go to [http://repo.or.cz/w/vlc.git http://repo.or.cz/w/vlc.git] and click [http://repo.or.cz/regproj.cgi?fork=vlc.git fork]. You will be able to publish your work there.

Please don't forget to send a mail to the ''vlc-devel'' mailing list as soon as you create your fork.

== Revert your non-committed local changes ==
$ git checkout -f

==Edit or undo not yet pushed commits ==
This will undo the last commit
$ git reset HEAD^
which is the same as
$ git reset master^
(if your checked-out copy of your tree is master)
And also the same as
$ git reset a44a594 # note that there is no need to use the full sha id

If you have a stack of patch that you have not yet committed you can delete one patch from the list using git rebase --interactive
$ git rebase --interactive origin
pick eacf185 test
pick 56322eb VLMA owner is vlma prod.

# Rebase 826757e..56322eb onto 826757e
#
# Commands:
# pick = use commit
# edit = use commit, but stop for amending
# squash = use commit, but meld into previous commit

== Diff-ing ==
* You can diff between two branches using
$ git diff branch1 branch2
* You can diff between the previous 10th commit and current using
$ git diff HEAD~10 HEAD
* You can diff between the previous 10th commit and current of the branch "mywork" using
$ git diff mywork~10 mywork
* Imagine that git log is like
$ git log
commit e0394f269305edd09843257e7c1d1a66aaf48ab3
Author: jb <jb>
Date: Fri Apr 13 07:14:48 2007 +0000
qt4 - Mousewheel (2)
commit e80b339081aa6755f67c9bd8e2aacf93a9a79d95
[..]
commit ff7004b70fd239e4120deb160e2991bd5237b8df
[..]
commit a44a594898f981a145cfcace5f16f8973f9eb46f
[..]
commit 690df705c963cf6bf6f5746d54bc97a85ff91919
[..]
commit 679f8b1c3e0baa469efa970588b95a625c595d64
[..]

$ git diff a44a594898f981a145cfcace5f16f8973f9eb46f~2 e80b339081aa6755f67c9bd8e2aacf93a9a79d95
Will be equivalent to:
$ git diff ff7004b70fd239e4120deb160e2991bd5237b8df e80b339081aa6755f67c9bd8e2aacf93a9a79d95
And to:
$ git diff HEAD~4 HEAD^

* Remember that to produce a patch you should rather use git-format-patch than git-diff most of the time.

== Patch-ing ==
* You can apply patches using
$ git apply <patch>

== Tracking regression ==
git has a great tool called [http://www.kernel.org/pub/software/scm/git/docs/git-bisect.html git-bisect] to help you to track a faulty commit. Imagine you are tracking a bug that is known to appear after 0.8.6 (assuming 0.8.6 is tagged):
$ git bisect start
$ git bisect bad # tell git current version has the bug you are tracking
$ git bisect good 0.8.6 # tell git 0.8.6 didn't have the bug
And then git will checkout a certain revision, and ask you to test it. And you simply say whether this version has the bug.
If it has the bug:
$ git bisect bad
if the bug is not present:
$ git bisect good
And so on by bisection... At the end git will indicate the faulty commit. Most of the time this tool is really efficient to track regression.

If you can provide a script that test the presence of the bug
$ git bisect run <script_name>
will be able to track down the regression by itself. See [http://www.kernel.org/pub/software/scm/git/docs/git-bisect.html git-bisect Documentation].

= Using Git to push to VideoLAN git =
== Initial requirements ==
* You must have credentials to push commits into the repository. For other contributors, please read upper [[Git#Submitting_patches_to_the_vlc-devel_or_x264-devel|Submitting patches to the vlc-devel or x264-devel]] paragraph.
* Make sure you've set your name and email in your commits
$ git config --global user.name "Your Name"
$ git config --global user.email "me@example.com"

== Convert your tree to use your ssh push commit access ==
$ vi vlc/.git/config
And replace
git://git.videolan.org/vlc.git
With
git@git.videolan.org:vlc.git

== Staying up to date ==
$ git pull --rebase

If you don't want to have to type --rebase everytime you pull do:
$ git config branch.master.rebase true

This one creates a merge object which is not how SVN worked, so let's use the first version...
$ git pull

== Pushing your work ==
$ git log origin..master # Check what you are going to push
$ git push



= Documentation about git =
* [http://git.or.cz/ Official Git Website]
* [http://www.kernel.org/pub/software/scm/git/docs/tutorial.html Git Tutorial]
* [http://git.or.cz/course/svn.html Switching from SVN to git using cogito]
* [http://wiki.sourcemage.org/Git_Guide Very good Git guide]

[[Category:Building]]

Win32Compile Under Fedora

2012-03-21T09:31:42Z

John F: /* Configure */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
cd vlc-*
export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries.

First, set an environment variable for your current "host" system for cross-compiling. This is because the contributed libraries are always maintained under the directory <code>i586-mingw32msvc</code>, while Fedora typically is looking for them as <code>i686-pc-mingw32</code>.

<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
export PKG_CONFIG_LIBDIR=../contrib/${FEDORA_HOST}/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
</pre>

Finally, download the "prebuilt" contributions and create a symbolic link.
<pre>
mkdir -p contrib/win32
cd contrib/win32
../bootstrap --host=i586-mingw32msvc
make prebuilt
cd ..
ln -s i586-mingw32msvc ${FEDORA_HOST}
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
sudo yum install qt-devel
sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs. Here's how to see what you've got:
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" ${VLCROOT}/contrib/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
cd ${VLCROOT}/contrib/win32
wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
rm -f ${VLCROOT}/contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add these lines:
<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
export PKG_CONFIG_LIBDIR=../contrib/${FEDORA_HOST}/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
cd $VLCROOT
./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
export MINGWDLLPATH=`${FEDORA_HOST}-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1`
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libgcc_s_sjlj-1.dll $MINGWDLLPATH
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libstdc++-6.dll $MINGWDLLPATH
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
mkdir win32 && cd win32
../extras/package/win32/configure.sh --enable-dvbpsi --host=${FEDORA_HOST}
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
../configure --enable-dvbpsi --host=${FEDORA_HOST} \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-03-21T09:30:56Z

John F: /* Set the environment variables */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
cd vlc-*
export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries.

First, set an environment variable for your current "host" system for cross-compiling. This is because the contributed libraries are always maintained under the directory <code>i586-mingw32msvc</code>, while Fedora typically is looking for them as <code>i686-pc-mingw32</code>.

<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
export PKG_CONFIG_LIBDIR=../contrib/${FEDORA_HOST}/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
</pre>

Finally, download the "prebuilt" contributions and create a symbolic link.
<pre>
mkdir -p contrib/win32
cd contrib/win32
../bootstrap --host=i586-mingw32msvc
make prebuilt
cd ..
ln -s i586-mingw32msvc ${FEDORA_HOST}
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
sudo yum install qt-devel
sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs. Here's how to see what you've got:
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" ${VLCROOT}/contrib/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
cd ${VLCROOT}/contrib/win32
wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
rm -f ${VLCROOT}/contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add these lines:
<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
export PKG_CONFIG_LIBDIR=../contrib/${FEDORA_HOST}/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
cd $VLCROOT
./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
export MINGWDLLPATH=`${FEDORA_HOST}-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1`
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libgcc_s_sjlj-1.dll $MINGWDLLPATH
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libstdc++-6.dll $MINGWDLLPATH
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
mkdir win32 && cd win32
../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-03-21T09:30:13Z

John F: /* Prepare 3rd party libraries */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
cd vlc-*
export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries.

First, set an environment variable for your current "host" system for cross-compiling. This is because the contributed libraries are always maintained under the directory <code>i586-mingw32msvc</code>, while Fedora typically is looking for them as <code>i686-pc-mingw32</code>.

<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
export PKG_CONFIG_LIBDIR=../contrib/${FEDORA_HOST}/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
</pre>

Finally, download the "prebuilt" contributions and create a symbolic link.
<pre>
mkdir -p contrib/win32
cd contrib/win32
../bootstrap --host=i586-mingw32msvc
make prebuilt
cd ..
ln -s i586-mingw32msvc ${FEDORA_HOST}
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
sudo yum install qt-devel
sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs. Here's how to see what you've got:
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" ${VLCROOT}/contrib/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
cd ${VLCROOT}/contrib/win32
wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
rm -f ${VLCROOT}/contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add these lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
cd $VLCROOT
./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
export MINGWDLLPATH=`${FEDORA_HOST}-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1`
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libgcc_s_sjlj-1.dll $MINGWDLLPATH
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libstdc++-6.dll $MINGWDLLPATH
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
mkdir win32 && cd win32
../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-03-21T09:22:52Z

John F: /* Install Qt and correct any version mismatch */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
cd vlc-*
export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries.

First, set an environment variable for your current "host" system for cross-compiling. This is because the contributed libraries are always maintained under the directory <code>i586-mingw32msvc</code>, while Fedora typically is looking for them as <code>i686-pc-mingw32</code>.

<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
</pre>

Finally, download the "prebuilt" contributions and create a symbolic link.
<pre>
mkdir -p contrib/win32
cd contrib/win32
../bootstrap --host=i586-mingw32msvc
make prebuilt
cd ..
ln -s i586-mingw32msvc ${FEDORA_HOST}
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
sudo yum install qt-devel
sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs. Here's how to see what you've got:
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" ${VLCROOT}/contrib/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
cd ${VLCROOT}/contrib/win32
wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
rm -f ${VLCROOT}/contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add these lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
cd $VLCROOT
./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
export MINGWDLLPATH=`${FEDORA_HOST}-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1`
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libgcc_s_sjlj-1.dll $MINGWDLLPATH
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libstdc++-6.dll $MINGWDLLPATH
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
mkdir win32 && cd win32
../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-03-21T09:21:26Z

John F: /* Install Qt and correct any version mismatch */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
cd vlc-*
export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries.

First, set an environment variable for your current "host" system for cross-compiling. This is because the contributed libraries are always maintained under the directory <code>i586-mingw32msvc</code>, while Fedora typically is looking for them as <code>i686-pc-mingw32</code>.

<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
</pre>

Finally, download the "prebuilt" contributions and create a symbolic link.
<pre>
mkdir -p contrib/win32
cd contrib/win32
../bootstrap --host=i586-mingw32msvc
make prebuilt
cd ..
ln -s i586-mingw32msvc ${FEDORA_HOST}
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
sudo yum install qt-devel
sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs. Here's how to see what you've got:
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" ${VLCROOT}/contrib/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
cd ${VLCROOT}/contrib/win32
wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add these lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
cd $VLCROOT
./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
export MINGWDLLPATH=`${FEDORA_HOST}-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1`
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libgcc_s_sjlj-1.dll $MINGWDLLPATH
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libstdc++-6.dll $MINGWDLLPATH
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
mkdir win32 && cd win32
../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-03-21T09:20:14Z

John F: /* Install Qt and correct any version mismatch */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
cd vlc-*
export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries.

First, set an environment variable for your current "host" system for cross-compiling. This is because the contributed libraries are always maintained under the directory <code>i586-mingw32msvc</code>, while Fedora typically is looking for them as <code>i686-pc-mingw32</code>.

<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
</pre>

Finally, download the "prebuilt" contributions and create a symbolic link.
<pre>
mkdir -p contrib/win32
cd contrib/win32
../bootstrap --host=i586-mingw32msvc
make prebuilt
cd ..
ln -s i586-mingw32msvc ${FEDORA_HOST}
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
sudo yum install qt-devel
sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs. Here's how to see what you've got:
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" ${VLCROOT}/contrib/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
cd contrib/win32
wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add these lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
cd $VLCROOT
./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
export MINGWDLLPATH=`${FEDORA_HOST}-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1`
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libgcc_s_sjlj-1.dll $MINGWDLLPATH
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libstdc++-6.dll $MINGWDLLPATH
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
mkdir win32 && cd win32
../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-03-21T08:44:18Z

John F: /* Set the environment variables */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
cd vlc-*
export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries.

First, set an environment variable for your current "host" system for cross-compiling. This is because the contributed libraries are always maintained under the directory <code>i586-mingw32msvc</code>, while Fedora typically is looking for them as <code>i686-pc-mingw32</code>.

<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
</pre>

Finally, download the "prebuilt" contributions and create a symbolic link.
<pre>
mkdir -p contrib/win32
cd contrib/win32
../bootstrap --host=i586-mingw32msvc
make prebuilt
cd ..
ln -s i586-mingw32msvc ${FEDORA_HOST}
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
sudo yum install qt-devel
sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs. Here's how to see what you've got:
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
cd contrib/win32
wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add these lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
cd $VLCROOT
./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
export MINGWDLLPATH=`${FEDORA_HOST}-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1`
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libgcc_s_sjlj-1.dll $MINGWDLLPATH
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libstdc++-6.dll $MINGWDLLPATH
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
mkdir win32 && cd win32
../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-03-21T08:41:04Z

John F: remove $ indicators to make cut/paste easier; add some environment vars

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
cd vlc-*
export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries.

First, set an environment variable for your current "host" system for cross-compiling. This is because the contributed libraries are always maintained under the directory <code>i586-mingw32msvc</code>, while Fedora typically is looking for them as <code>i686-pc-mingw32</code>.

<pre>
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
</pre>

Finally, download the "prebuilt" contributions and create a symbolic link.
<pre>
mkdir -p contrib/win32
cd contrib/win32
../bootstrap --host=i586-mingw32msvc
make prebuilt
cd ..
ln -s i586-mingw32msvc ${FEDORA_HOST}
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
sudo yum install qt-devel
sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs. Here's how to see what you've got:
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
cd contrib/win32
wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
export FEDORA_HOST=`rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3`
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
cd $VLCROOT
./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
export MINGWDLLPATH=`${FEDORA_HOST}-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1`
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libgcc_s_sjlj-1.dll $MINGWDLLPATH
sudo ln -s /usr/${FEDORA_HOST}/sys-root/mingw/bin/libstdc++-6.dll $MINGWDLLPATH
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
mkdir win32 && cd win32
../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

UnixCompile

2012-03-21T08:06:18Z

John F: /* Get the third-party libraries */

== Prepare your environment ==

VLC requires a C compiler, development headers and a toolchain. gcc will do but you could also use LLVM or proprietary C99/C++ compilers such as Intel's.

If you build from the [[Git]] repositories, you will also need the GNU build system, a.k.a. the "autotools" (autoconf, automake, libtool and gettext) to setup the Makefiles. Make sure they are up-to-date and usable for your system.

On Fedora:

% sudo yum install git libtool

On Debian or Ubuntu:

% sudo apt-get install git libtool

== Get the source ==
Start by [[GetTheSource|getting the source]], using FTP for official releases, or using [[Git]] to track VLC development.

If your are using an official release, download source code, extract the archive and go into the resulting VLC directory, e.g.:
% wget ftp://ftp.videolan.org/pub/videolan/vlc/1.1.11/vlc-1.1.11.tar.bz2
% tar xvjf vlc-1.1.11.tar.bz2
% cd vlc-1.1.11

If you are using the [[Git]] development version, start by bootstrapping the source tree:
% cd vlc
% ./bootstrap
Bootstrapping will fail if the autotools are missing or out-of-date.

== Get the third-party libraries ==
Now you could configure the VLC build. But first, you need to make sure that all the required dependencies are in place. Take a look at <tt>./configure --help</tt>. Take a good look at that enormous list of options.

It is very important that you do install and enable all the 3rd party libraries that you need. Yes, there are going to be a lot of them if you want a complete or even mostly functional VLC build. If you fail to install a required library, you will end up with a VLC application that well..... essentially does not do anything useful. See [[Contrib Status|here]] for a complete list.

There are some very important dependencies: gettext (NLS) for international support (required), libdvbpsi for MPEG-TS files and streams support, libmad for MP3 audio decoding, libmpeg2 for MPEG1 and MPEG2 video support, FFmpeg or libav (libavcodec, libavformat, libpostproc, libswscale and optionally libavio) for MPEG4 and most other audio and video codecs, and many file formats, liba52 for Dolby (AC3) sound, dvdread and dvdnav for DVD playback, live555 for RTSP stream playback, etc.

For audio output, you will need probably alsa-lib (on [[Linux]]) and/or libpulse (for [[PulseAudio]]).
For video output, you will normally need XCB/XVideo and/or OpenGL/GLX.
And Qt4 is required to get the GUI support.

'''Note''' that you need to install the development packages (development header files and import libraries) to compile VLC, not just the run-time. On Debian/Ubuntu, the correct package names end with -dev. On RPM distributions, they usually end in -devel.

'''Be careful!''' If the libraries are not provided by your distribution, you may be better off linking VLC with them statically. Otherwise, you may encounter version problems if another multimedia application updates the libraries later. This is especially true of FFmpeg or libav, and live555.

There are a several ways to get those libraries. You should use only one method at a time:

=== The preferred method ===
Use your distribution packaging or portage system, in order to get all the needed libs.
For example on Debian or Ubuntu:
$ sudo apt-get build-dep vlc

openSUSE users might have a look at the source-install (si) command in the zypper manpage:
$ sudo zypper si -d vlc

'''Note:''' To get the libraries, you must first add the VLC repositories to your system repositories.
For example in openSUSE:
$ sudo zypper ar http://download.videolan.org/pub/vlc/SuSE/<openSUSEversion> VLC
You should replace <openSUSEversion> with the version of your system (12.1, 11.4, 11.3, 11.2 or 11.1)

=== The method for badly-behaved distributions ===
If your distribution does not provide the needed libraries,
or you really want to link VLC statically, use the VLC contribs system. It is included in the VLC source.

First, you need to install the GNU autotools (if you have not already done so), CMake, subversion, Git and a recent GNU/tar utility or equivalent. Then you can run:
% cd contrib
% mkdir native
% cd native
% ../bootstrap
% make

'''Note''' the commands above are for VLC 2.0 or later. Details differ slightly for older versions:
% cd extras/contrib
% ./bootstrap
% make

That should download and build a lot of those libraries for you. Unfortunately, given the large number of libraries and the variety of the platforms people build VLC for, it is not unlikely that you will hit an error while contribs are compiling. Thus, this approach is only recommended for experienced Unix compilers.

=== The method for people with too much time to waste ===
Read the [[Contrib Status|list]], download them and build them by hand.

=== Regardless of the method ===
In any case, some basic OS support libraries are not included and must really be installed through the packaging system in any case, notably [[ALSA]], [[PulseAudio]] and [[OpenGL]].

== Configuration ==
<tt>./configure</tt> is used to check whether your system is able to compile VLC. Also you can choose the features in your build. As a reminder, this command will show the various options:
% ./configure --help

'''VLC 2.0 and later''': For most users, <tt>./configure</tt> does not require any command-line options.

By default, features to be compiled are chosen automatically depending on what libraries are detected as available. If the contribs have been compiled first, the resulting VLC will be reasonably functional.

Note that libraries that are not in the default prefix, and not in vlc contribs, must be known to pkg-config in order for <tt>./configure</tt> to find them.

There are some features that are disabled (not compiled) by default. If you want them, they must be forced on by using configure flags. You can find a list of these features by searching for "disabled" in <tt>./configure --help</tt>.

(''Beginner's guide'': enter the command
% ./configure --help | less
and hit enter. Type a slash '/', type "disabled" (without quotes), hit enter. Pressing '''n''' goes to the next match, '''N''' goes to previous match, '''q''' returns to the command line. Use the up/down arrow keys to scroll. All matches except the ''--cache-file'' option (which belongs to <tt>configure</tt> itself) are VLC features that must be forced on if desired.)

'''VLC 1.1 and earlier''': You probably need to tweak the "configure" line.

=== Special libs ===

'''VLC 2.0 and later''': there are no special libraries. If live555 exists in the <tt>contrib/</tt> subdirectory, it is detected automatically. ''Any'' libraries that are not in the default prefix, and not in vlc contribs, must be known to pkg-config in order for <tt>./configure</tt> to find them.

'''VLC 1.1 and earlier''': Use <tt>--with-live555-path=path/to/livemedia/source/tree</tt> in connection with <tt>--enable-live555</tt>. For FFmpeg or libav, pkg-config is the only reliable way for VLC's configure to find the libraries. So you need to set PKG_CONFIG_PATH correctly if your FFmpeg/libav libraries are not installed at the default prefix (meaning /usr) or you want to use static linking.

=== Final configuration ===
If you want to install VLC into another directory, run

% ./configure --prefix=/path/to/install/folder/

This is an example of a typical VLC configure line:

% ./configure --enable-x11 --enable-xvideo --enable-sdl --enable-avcodec --enable-avformat \
--enable-swscale --enable-mad --enable-libdvbpsi --enable-a52 --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-live555 --with-live555-tree=/usr/lib/live \
--enable-caca --enable-skins --enable-skins2 --enable-alsa --enable-qt4 --enable-ncurses

[[User:J-b#VLC_configure_line|Here]] is another.

=== Ubuntu ===

If you get continuous errors while ./configure then consider reinstalling the corresponding libraries. This will set the paths and other information correctly. Check the $PKG_CONFIG_PATH(environment variable) whether it is set to a path where the libraries like libavcodec.pc are available. Otherwise create the environment variable, export it and then update the ldconfig.

== Compilation ==
Compile VLC:
% make

You do not need to install VLC to use it. You can also simply run it from the build directory:
# ./vlc

If you really want to install VLC to the system, run this as root:
# make install

You can uninstall later with this, but you need to keep the build tree untouched until then:
# make uninstall

To remove files created during the compile (optional) type:
% make clean

== Notes ==

=== Cygwin ===

Compiling on [[Win32CompileCygwin|Cygwin]] may be broken from time to time as Cygwin packages change.
We recommend [[Win32Compile|cross-compiling from Linux to Windows]] instead. '''Consider yourself warned.'''

=== Debian/Ubuntu ===
Debian users who want to compile VLC should install the packages below:
*[http://packages.debian.org/unstable/libdevel/libavcodec-dev libavcodec-dev]
*[http://packages.debian.org/unstable/libdevel/libpostproc-dev libpostproc-dev]
*[http://packages.debian.org/unstable/libdevel/libmpeg2-4-dev libmpeg2-4-dev]

If you just want to ''use'' VLC media player then simply install the package vlc (<tt>sudo apt-get install vlc</tt>) - the unstable version is fairly up-to-date most of the time, while the stable is, err, stable and very old ;-)

== Troubleshooting / common problems ==

=== Lua ===
You may need to install Lua if you get "LUA byte compiler missing." message. You namely need to install "luac", the Lua byte compiler.

On Debian/Ubuntu:
% sudo apt-get install lua5.1

On Fedora:
% sudo yum install lua

=== XCB ===

VLC 1.1 and later requires XCB libraries to deal with X11 displays. Do not disable XCB or you will not get any video support!

To install these libraries run the following commands (Debian/Ubuntu):
% sudo apt-get install libxcb-shm0-dev libxcb-xv0-dev libxcb-keysyms1-dev libxcb-randr0-dev libxcb-composite0-dev

Under Fedora:
% sudo yum install libxcb-devel xcb-util-devel

For OpenGL (Debian/Ubuntu only), you will additionally need XLib with XCB:
% sudo apt-get install libx11-xcb-dev

If your distribution provides a version of XLib without XCB, then this later package will not be available. So you will not be able to use OpenGL. Use XVideo instead.

=== Compile fails after git pull ===

It is likely that the sources in the repository have changed significantly since they were last pulled, and a build system cache has gone out of date. Try the troubleshooting methods described in the [[Hacker_Guide/How_To_Write_a_Module#Module_load_troubleshooting|hacker guide for modules]].

[[Category:Building]]

Win32Compile Under Fedora

2012-03-01T09:02:32Z

John F: /* Get the basics */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion \
dos2unix
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-13T11:58:03Z

John F: /* Package VLC */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file. (Needs <code>p7zip</code>.)
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file. (Needs <code>zip</code>.)
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package. (Needs <code>mingw32-nsiswrapper</code> and <code>mingw32-nsis</code>.)
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile

2012-02-07T22:19:53Z

John F: /* Obtaining the toolchain */

How to compile {{VLC}} for [[Windows]].

== Building Methods ==

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

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''Cross-compile with Mingw on Linux'''
| This page
| '''Preferred''' method (uses cross compilation). On Windows, you should do it in a virtual machine.
|-
| '''Native compilation''' with '''[http://www.mingw.org MSYS+MINGW]'''
| [[Win32CompileMSYSNew]]
| '''Native''' compilation method. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows.
|-
| '''Native compilation''' with '''cygwin'''
| [[Win32CompileCygwinNew]]
| Build using cygwin as your compile environment. '''Error''' prone, and '''slow'''.
|}

== Obtaining the toolchain ==

Each build method requires its own toolchain:

* '''Debian/Ubuntu''' users can <code>apt-get install gcc-mingw32 mingw32-binutils</code>. <code></code>
* '''Gentoo''' users can <code>emerge crossdev && crossdev mingw32</code>
* '''ArchLinux''' users can <code>pacman -S mingw32-gcc</code>
* '''Fedora''' users should read [[Win32Compile Under Fedora]]
* Other '''Linux''' systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW
* Native-compile with '''[http://www.mingw.org MSYS+MINGW]''', should read the [[Win32CompileMSYSNew|documentation]]
* Native-compile with '''[http://www.cygwin.com Cygwin]''', should read the [[Win32CompileCygwinNew|documentation]]

=== tools ===
You will also need:
* lua5.1
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* zip [for creating .zip package], p7zip [for .7z package], nsis [for .exe auto-installer].

== Get the source code ==
$ git clone git://git.videolan.org/vlc.git

== Prepare [[Contrib Status|3rd party libraries]] ==

Before compiling VLC, you need lots of other libraries. Here is how to get them:

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt

or, if you want to compile the contribs yourself and are feeling adventurous and have lots of time to burn,

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make fetch
$ make

=== Linux 64-bit ===

If you are on Linux '''64-bit''', you '''MUST''' remove some files:

$ rm -f ../i586-mingw32msvc/bin/moc ../i586-mingw32msvc/bin/uic ../i586-mingw32msvc/bin/rcc

In addition, install the ''qt4-tools'' package.

=== Fix your contrib path ===

If your Mingw prefix is not ''i586-mingw32msvc'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:
$ ln -sf ../i586-mingw32msvc ../i486-mingw32

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i586-mingw32msvc
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i586-mingw32msvc
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages with the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:54:34Z

John F: /* Building Methods */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:51:33Z

John F: /* Building Methods */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine\\
using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:49:53Z

John F: /* Create and attach the disk drives */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine 
using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Change Base Memory Size to 1024MB (for better performance).
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:48:56Z

John F: /* Using a virtual machine */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine 
using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:40:55Z

John F: /* Using a virtual machine */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine 
using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

{{hidden|Title text here|Body text line 1 Body text line 2}}

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:39:13Z

John F:

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine 
using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:33:32Z

John F:

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine 
using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

{{hidden|== Using a virtual machine ==|Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.
}}

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:32:31Z

John F: /* Using a virtual machine */

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine 
using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

{{hidden|== Using a virtual machine ==
|Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.
}}

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:28:21Z

John F:

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine 
using 32-bit Ubuntu.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:23:45Z

John F: /* Building Methods */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable" border="1" cellpadding="3"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:23:02Z

John F: /* Bootstrap */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
$ sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:22:38Z

John F: /* Set the environment variables */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
$ exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:21:42Z

John F: /* Package VLC */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable" cellpadding="8"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:19:51Z

John F: /* Package VLC */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
|style=white-space:nowrap| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:11:41Z

John F: /* Install Qt and correct any version mismatch */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

Finally, you need to delete the executables supplied by the contribs.
<pre>
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:08:57Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

You'll also need several other packages for the build process.
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:04:36Z

John F: /* Package VLC */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
$ sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>$ make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>$ make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>$ make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>$ make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>$ make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>$ make package-win32</code>
| Creates all of the above.
|-
| <code>$ make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:02:45Z

John F: /* Package VLC */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Creates all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T21:01:51Z

John F: /* Package VLC */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

Depending on what type of package you want, you may also need the ''zip'', ''7zip'', or ''nsis'' tools. All three sets are needed for the <code>make package-win</code> target.
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Create all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T20:58:44Z

John F: /* Package VLC */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>make package-win32-xpi</code>
| Creates the web plugin.
|-
| <code>make package-win32</code>
| Create all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T20:54:08Z

John F: /* Package VLC */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win32-7zip</code>
| Same as <code>common</code> but will also package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as <code>common</code> but will also package the directory in a zip file.
|-
| <code>make package-win32-exe</code>
| Same as <code>common</code> but will also create an auto-installer package.
|-
| <code>make package-win32</code>
| Create all of the above.
|-
| <code>make package-win-debug</code>
| Same as <code>make package-win32</code> but the binaries are usable with a debugger.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T09:03:26Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
zip \
p7zip \
mingw32-nsiswrapper mingw32-nsis
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32-exe</code>
| Same as above but will also create an auto-installer package.
|-
| <code>make package-win32</code>
| Create all of the above.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T01:07:30Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the [http://git.videolan.org/?p=vlc.git;a=forks forks] link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T00:31:25Z

John F: /* Using a virtual machine */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach. Other virtual machines might work as well, but are untested.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T00:29:09Z

John F: /* Bootstrap */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

The build needs two extra DLLs that Fedora keeps in places it doesn't expect. So create symlinks to solve that:
<pre>
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libgcc_s_sjlj-1.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
sudo ln -s /usr/i686-pc-mingw32/sys-root/mingw/bin/libstdc++-6.dll /usr/lib64/gcc/i686-pc-mingw32/4.6.1/
</pre>

You can verify the destination directory with this command:
<pre>
$ i686-pc-mingw32-g++ -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|cut -d: -f1
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T00:22:34Z

John F: /* Configure */

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --enable-dvbpsi --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T00:16:10Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

=== Build VLC ===

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

=== Package VLC ===
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T00:13:37Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

=== Set the environment variables ===
You can add the four environment variables mentioned above to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

== Building VLC ==

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-07T00:10:48Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):

<code>$ sudo yum install </code>package-name1 package-name2 ...

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Remove the virtual CD and reboot ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===
<pre>
sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion
</pre>

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtain the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

You also need to set two environment variables for <code>pkg-config</code>. This is because the current Fedora MinGW <code>pkg-config</code> is broken, and you need to tell the native one where to find the contribs.
<pre>
$ export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
$ export PKG_CONFIG=/usr/bin/pkg-config
</pre>

=== Install 32-bit Lua ===
To get the 32-bit compiled Lua files needed by 32-bit VLC, you need the 32-bit Lua byte compiler. (The 64-bit version produces 64-bit files and does not currently have an option to produce 32-bit files.)

By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, Yum will install the 32-bit binary libraries, but it will NOT install the 32-bit binary executables (<code>lua</code> and <code>luac</code>) over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>

Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Install Qt and correct any version mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

== Configuring the build ==

=== Set the environment variables ===
If you want, you can add the four environment variables to your <code>~/.bash_profile</code> file. This will set them every time you start up a terminal. However, you might not want to override your normal variables. In that case, the following method will work.

* Copy your <code>~/.bash_profile</code> file to one called <code>~/.mingw_profile</code>
* Edit <code>~/.mingw_profile</code> to add four lines:
<pre>
export PKG_CONFIG_LIBDIR=../contrib/i686-pc-mingw32/lib/pkgconfig
export PKG_CONFIG=/usr/bin/pkg-config
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

Now, to set those variables after you start a terminal:
<pre>
exec bash --rcfile ~/.mingw_profile
</pre>

=== Bootstrap ===
Prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap
</pre>

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

== Building VLC ==

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-06T23:46:00Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):
<pre>
$ sudo yum install ''package-name1 package-name2 ...''
</pre>

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Removing the CD and rebooting ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
If you are using Fedora 13, you might want to visit the [[Win32CompileFedora13]] page.

This page has been tested for compiling {{VLC}} for [[Windows]] under 64-bit Fedora 16. There are a few complications, as noted below.

=== Get the basics ===

sudo yum install \
libtool \
automake \
autoconf \
autopoint \
make \
gettext \
pkg-config \
git \
subversion

Next, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at the [http://git.videolan.org VLC Git repository]. Scroll down to the <code>vlc.git</code> line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed <code>vlc-x.x</code> directory. We will refer to this as the <code>$VLCROOT</code> directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtaining the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

=== Installing 32-bit Lua ===
By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, you may install the 32-bit binary libraries, but the 32-bit binary executables (<code>lua</code> and <code>luac</code>) will NOT install over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>
Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Installing Qt and Correcting Version Mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well. You also need to delete the executables supplied by the contribs.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
$ rm -f contrib/i586-mingw32msvc/bin/moc contrib/i586-mingw32msvc/bin/uic contrib/i586-mingw32msvc/bin/rcc
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2
$ tar xjvf moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2 -C ../
</pre>

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
<pre>
$ cd $VLCROOT
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script. You will probably want to add the <code>--enable-dvbpsi</code> option in addition to the standard ones.

<pre>
$ mkdir win32 && cd win32
$ ../extras/package/win32/configure.sh --enable-dvbpsi --host=i686-pc-mingw32
</pre>

Alternatively, you can run configure manually. There are a large number of options. See <code>'../configure --help'</code> for more information.

<pre>
$ ../configure --host=i686-pc-mingw32 \
--enable-update-check \
--enable-lua \
--enable-faad \
--enable-flac \
--enable-theora \
--enable-twolame \
--enable-quicktime \
--enable-avcodec --enable-merge-ffmpeg \
--enable-dca \
--enable-mpc \
--enable-libass \
--enable-x264 \
--enable-schroedinger \
--enable-realrtsp \
--enable-live555 \
--enable-dvdread \
--enable-shout \
--enable-goom \
--enable-caca \
--disable-portaudio \
--disable-sdl \
--enable-qt4 \
--enable-skins2 \
--enable-sse --enable-mmx \
--enable-libcddb \
--enable-zvbi --disable-telx \
--enable-sqlite \
--disable-dirac
</pre>

== Building VLC ==

Once configured, to build VLC, just run:
<pre>
$ make
</pre>

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages.

You may also add the <code>ndis</code> tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-06T23:12:57Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

How to compile {{VLC}} for [[Windows]] under Fedora.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):
<pre>
$ sudo yum install ''package-name1 package-name2 ...''
</pre>

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

=== Create and attach the disk drives ===
Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.

=== Removing the CD and rebooting ===
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

== Using Fedora ==
It is possible to compile the Windows 32-bit version under 64-bit Fedora. There are a few complications, as noted below.

=== Get the source code ===
First, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at http://git.videolan.org. Scroll down to the vlc.git line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed vlc-x.x directory. We will refer to this as the $VLCROOT directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

=== Obtaining the toolchain ===
The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

=== Prepare [[Contrib Status|3rd party libraries]] ===
Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

=== Installing 32-bit Lua ===
By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, you may install the 32-bit binary libraries, but the 32-bit binary executables (<code>lua</code> and <code>luac</code>) will NOT install over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>
Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>
Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

=== Installing Qt and Correcting Version Mismatch ===

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2

=== tools ===
You will also need:
* lua5.1
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* zip [for creating .zip package], p7zip [for .7z package], nsis [for .exe auto-installer].

=== Linux 64-bit ===

If you are on Linux '''64-bit''', you '''MUST''' remove some files:

$ rm -f ../i586-mingw32msvc/bin/moc ../i586-mingw32msvc/bin/uic ../i586-mingw32msvc/bin/rcc

In addition, install the ''qt4-tools'' package.

=== Fix your contrib path ===

If your Mingw prefix is not ''i586-mingw32msvc'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i586-mingw32msvc
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i586-mingw32msvc
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages.

You may also add the ndis tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum --verbose --noplugins install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip \
lua
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-06T23:07:54Z

John F:

THIS PAGE IS UNDER CONSTRUCTION. CHECK BACK LATER THIS WEEK.

How to compile {{VLC}} for [[Windows]] under Fedora.

== Building Methods ==

From a Fedora 64-bit install, you have two basic approaches if you want to build VLC from source.

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method that works "out of the box".
|-
| '''Cross-compile with Mingw''' under Fedora.
| Produces some anomalies and requires some workarounds.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):
<pre>
$ sudo yum install ''package-name1 package-name2 ...''
</pre>

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
$ sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
$ wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main [[Win32Compile]] page.

=== Using Fedora ===
It is possible to compile the Windows 32-bit version under 64-bit Fedora. There are a few complications, as noted below.

== Get the source code ==
First, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
$ git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at http://git.videolan.org. Scroll down to the vlc.git line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed vlc-x.x directory. We will refer to this as the $VLCROOT directory:
<pre>
$ cd vlc-*
$ export VLCROOT=`pwd`
</pre>

== Obtaining the toolchain ==

The mingw32 cross-compile tools are available in the default repository.
<pre>
$ sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

== Prepare [[Contrib Status|3rd party libraries]] ==

Before compiling VLC, you need lots of other libraries. Here is how to get them:
<pre>
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt
$ cd ..
$ ln -s i586-mingw32msvc i686-pc-mingw32
</pre>

Note that <code>i686-pc-mingw32</code> is the current name of the "host" system for cross-compiling. You can verify that by:
<pre>
$ rpm -ql mingw32-filesystem|grep -m1 lib|cut -d/ -f3
</pre>

== Installing 32-bit Lua ==
By default, you will already have 64-bit Lua installed, because the Yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, you may install the 32-bit binary libraries, but the 32-bit binary executables (<code>lua</code> and <code>luac</code>) will NOT install over the 64-bit ones. Here is how to work around that.

<pre>
$ sudo yum install compat-readline5.i686
$ yumdownloader lua.i686
$ sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions.
<pre>
$ sudo yum install cpio
$ rpm2cpio lua*.rpm | cpio -idmv
</pre>
Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why Yum refused to install them in the first place. So manually install them with the names <code>lua32</code> and <code>luac32</code> and get rid of your detritus.
<pre>
$ sudo mv usr/bin/lua /usr/bin/lua32
$ sudo mv usr/bin/luac /usr/bin/luac32
$ rm -rf usr
$ rm -f lua*.rpm
</pre>
Tell the build system where to find the 32-bit versions.
<pre>
$ export LUA=/usr/bin/lua32
$ export LUAC=/usr/bin/luac32
</pre>

== Installing Qt and Correcting Version Mismatch ==

Install the <code>qt-devel</code> package, which gives you <code>moc</code>, <code>uic</code> and <code>rcc</code> for both Qt3 and Qt4. The executables for Qt4 are named <code>moc-qt4</code>, <code>uic-qt4</code> and <code>rcc</code>, so these need fixing as well.
<pre>
$ sudo yum install qt-devel
$ sudo ln -s /usr/bin/moc-qt4 /usr/local/bin/moc
$ sudo ln -s /usr/bin/uic-qt4 /usr/local/bin/uic
</pre>

Your version of <code>moc</code> needs to match the version used in the contribs.
<pre>
$ moc -v
Qt Meta Object Compiler version 63 (Qt 4.8.0)
$ grep "define Q_MOC" contrib/win32/i586-mingw32msvc/include/qt4/src/corelib/kernel/qobjectdefs.h
#define Q_MOC_OUTPUT_REVISION 62
</pre>

In this case, the installed <code>moc</code> has a version of 63 (from Qt 4.8), but the contribs were built with version 62 (from Qt 4.7). To fix this:
<pre>
$ cd contrib/win32
$ wget http://johnfreed.com/vlc/contrib/moc-`moc -v 2>&1|cut -d' ' -f6`.tar.bz2

=== tools ===
You will also need:
* lua5.1
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* zip [for creating .zip package], p7zip [for .7z package], nsis [for .exe auto-installer].

=== Linux 64-bit ===

If you are on Linux '''64-bit''', you '''MUST''' remove some files:

$ rm -f ../i586-mingw32msvc/bin/moc ../i586-mingw32msvc/bin/uic ../i586-mingw32msvc/bin/rcc

In addition, install the ''qt4-tools'' package.

=== Fix your contrib path ===

If your Mingw prefix is not ''i586-mingw32msvc'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i586-mingw32msvc
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i586-mingw32msvc
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages.

You may also add the ndis tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum --verbose --noplugins install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip \
lua
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-06T22:17:41Z

John F: preliminary first edit

How to compile {{VLC}} for [[Windows]].

== Building Methods ==

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

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''Cross-compile with Mingw''' in a virtual machine.
| '''Preferred''' method.
|-
| '''Cross-compile with Mingw''' under Fedora.
|}

Yum is the basic installation tool for Fedora. Install packages (as root):
<pre>
sudo yum install ''package-name1 package-name2 ...''
</pre>

== Using a virtual machine ==
Virtual Box is known to work for this approach.
<pre>
sudo yum install VirtualBox-OSE
</pre>

The basic Win32Compile is optimized for Ubuntu. It is simpler if you install the 32-bit version:

<pre>
wget http://www.ubuntu.com/start-download?distro=desktop&bits=32&release=latest
</pre>

Start the VirtualBox Manager GUI.
* Click on Machine / New... The "New Virtual Machine Wizard" will open.
* Click Next. Enter Ubuntu32 in the Name box.
* Set Base Memory Size to 1024MB. (Recommended.)
* Leave Start-up Disk box checked. Leave Create new hard disk radio button active.
* Choose VDI file type.
* Choose Dynamically allocated
* Choose Location Ubuntu32 and Size 8.00 GB
* Click "Create". This will exit the Wizard.
* Click "Create" again. This will create the virtual machine.
* Click Settings / Storage. The SATA Controller should show that Ubuntu32.vdi (your 8GB disk) is attached. The IDE Controller should show an empty attachment. Click on the Empty line. The Attributes label in the last column should read "CD/DVD Drive:" with a dropdown reading "IDE Secondary". To the right of that is a CD symbol. Click on that.
* Click on "Choose a virtual CD/DVD disk file..."
* Navigate to the Ubuntu server you just downloaded. Click Open. Your CD should now be attached to the IDE Controller. Click OK.
* Click on Start.

At this point, the virtual machine should boot and take you through the Ubuntu installation process. When it is complete, it will ask you to remove the CD and reboot.
* Click on Machine / Close ...
* Choose Power off the machine and click OK.
* Click on Settings / Storage
* Click on the Ubuntu CD attached to the IDE Controller
* Click on the CD symbol at the extreme right of the Attributes section.
* Choose Remove disk from virtual drive. Click OK
* Click on Start.

Now Ubuntu should start. From here you can follow the instructions on the main Win32Compile page.

=== Using Fedora ===
It is possible to compile the Windows 32-bit version under 64-bit Fedora. There are a few complications, as noted below.

== Get the source code ==
First, change to a directory you will use for building. You must have write access to this directory. Then use git to get the source:
<pre>
git clone git://git.videolan.org/vlc.git
</pre>

This will give you the VLC trunk. Alternative branches (technically forks) are listed at http://git.videolan.org. Scroll down to the vlc.git line and click on the "forks" link at the extreme right. This will give you a list of alternatives, which are in the vlc directory. So, for example, to choose the 2.0 fork, the command is:
<pre>
git clone git://git.videolan.org/vlc/vlc-2.0.git
</pre>

Next, change into the newly installed vlc-x.x directory. We will refer to this as the $VLCROOT directory:
<pre>
export VLCROOT=`pwd`
</pre>

== Obtaining the toolchain ==

The mingw32 cross-compile tools are available in the default repository.
<pre>
sudo yum install \
mingw32-gcc-c++ \
mingw32-gcc \
mingw32-pthreads \
mingw32-w32api \
mingw32-binutils \
mingw32-runtime \
mingw32-filesystem \
mingw32-cpp \
mingw32-dlfcn-static
</pre>

== Installing 32-bit Lua ==
By default, you will already have 64-bit Lua installed, because the yum/RPM packaging system depends on it. As a result, you will not be able to remove the 64-bit version. Furthermore, you may install the 32-bit binary libraries, but the 32-bit binary executables (lua and luac) will NOT install over the 64-bit ones. Here is how to work around that.

<pre>
sudo yum install compat-readline5.i686
yumdownloader lua.i686
sudo yum localinstall ./lua*.rpm
</pre>

This installs the 32-bit libraries but not the executables. You have to manually extract and install the 32-bit versions
<pre>
sudo yum install cpio
rpm2cpio lua*.rpm | cpio -idmv
</pre>
Now you will have the files from the RPM package as a tree in your local directory. They have the same names and (relative) locations as the 64-bit versions, which is why yum refused to install them in the first place. So manually install them with the names lua32 and luac32:

<pre>
sudo mv usr/bin/lua /usr/bin/lua32
sudo mv usr/bin/luac /usr/bin/luac32
rm -rf usr
rm -f lua*.rpm
</pre>

Tell the build system where to find the 32-bit versions:
<pre>
export LUA=/usr/bin/lua32
export LUAC=/usr/bin/luac32
</pre>

== Installing Qt and Correcting Version Mismatch ==

Install the qt-devel package, which gives you moc, uic and rcc for both Qt3 and Qt4. The executables for Qt4 are named moc-qt4, uic-qt4 and rcc.
<pre>
sudo yum install qt-devel
</pre>
Your version of moc needs to match the version used in the VLC sources.
<pre>
moc -v

</pre>

Note: pre-built Windows Qt is 4.6.0 but the yum installed version for Linux is actually 4.6.3...
''If it is problematic'' try to downgrade the qt installed versions:

=== tools ===
You will also need:
* lua5.1
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* zip [for creating .zip package], p7zip [for .7z package], nsis [for .exe auto-installer].

== Get the source code ==
$ git clone git://git.videolan.org/vlc.git

== Prepare [[Contrib Status|3rd party libraries]] ==

Before compiling VLC, you need lots of other libraries. Here is how to get them:

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt

or, if you want to compile the contribs yourself and are feeling adventurous and have lots of time to burn,

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make fetch
$ make

=== Linux 64-bit ===

If you are on Linux '''64-bit''', you '''MUST''' remove some files:

$ rm -f ../i586-mingw32msvc/bin/moc ../i586-mingw32msvc/bin/uic ../i586-mingw32msvc/bin/rcc

In addition, install the ''qt4-tools'' package.

=== Fix your contrib path ===

If your Mingw prefix is not ''i586-mingw32msvc'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:
$ ln -sf ../i586-mingw32msvc ../i486-mingw32

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i586-mingw32msvc
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i586-mingw32msvc
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages.

You may also add the ndis tools and everything needed by the <code>make package-win32*</code> targets:
<pre>
sudo yum --verbose --noplugins install \
mingw32-nsiswrapper \
mingw32-nsis \
zip \
p7zip \
lua
</pre>

Use the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile Under Fedora

2012-02-06T21:23:33Z

John F: Creating page based on Win32Compile

How to compile {{VLC}} for [[Windows]].

== Building Methods ==

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

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''Cross-compile with Mingw on Linux'''
| This page
| '''Preferred''' method (uses cross compilation). On Windows, you should do it in a virtual machine.
|-
| '''Native compilation''' with '''[http://www.mingw.org MSYS+MINGW]'''
| [[Win32CompileMSYSNew]]
| '''Native''' compilation method. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows.
|-
| '''Native compilation''' with '''cygwin'''
| [[Win32CompileCygwinNew]]
| Build using cygwin as your compile environment. '''Error''' prone, and '''slow'''.
|}

== Obtaining the toolchain ==

Each build method requires its own toolchain:

* '''Debian/Ubuntu''' users can <code>apt-get install gcc-mingw32 mingw32-binutils</code>. <code></code>
* '''Gentoo''' users can <code>emerge crossdev && crossdev mingw32</code>
* '''ArchLinux''' users can <code>pacman -S mingw32-gcc</code>
* '''Fedora''' users should read [[Win32CompileFedora13]]
* Other '''Linux''' systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW
* Native-compile with '''[http://www.mingw.org MSYS+MINGW]''', should read the [[Win32CompileMSYSNew|documentation]]
* Native-compile with '''[http://www.cygwin.com Cygwin]''', should read the [[Win32CompileCygwinNew|documentation]]

=== tools ===
You will also need:
* lua5.1
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* zip [for creating .zip package], p7zip [for .7z package], nsis [for .exe auto-installer].

== Get the source code ==
$ git clone git://git.videolan.org/vlc.git

== Prepare [[Contrib Status|3rd party libraries]] ==

Before compiling VLC, you need lots of other libraries. Here is how to get them:

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt

or, if you want to compile the contribs yourself and are feeling adventurous and have lots of time to burn,

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make fetch
$ make

=== Linux 64-bit ===

If you are on Linux '''64-bit''', you '''MUST''' remove some files:

$ rm -f ../i586-mingw32msvc/bin/moc ../i586-mingw32msvc/bin/uic ../i586-mingw32msvc/bin/rcc

In addition, install the ''qt4-tools'' package.

=== Fix your contrib path ===

If your Mingw prefix is not ''i586-mingw32msvc'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:
$ ln -sf ../i586-mingw32msvc ../i486-mingw32

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i586-mingw32msvc
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i586-mingw32msvc
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages with the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile

2012-02-05T21:01:37Z

John F: /* tools */

How to compile {{VLC}} for [[Windows]].

== Building Methods ==

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

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''Cross-compile with Mingw on Linux'''
| This page
| '''Preferred''' method (uses cross compilation). On Windows, you should do it in a virtual machine.
|-
| '''Native compilation''' with '''[http://www.mingw.org MSYS+MINGW]'''
| [[Win32CompileMSYSNew]]
| '''Native''' compilation method. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows.
|-
| '''Native compilation''' with '''cygwin'''
| [[Win32CompileCygwinNew]]
| Build using cygwin as your compile environment. '''Error''' prone, and '''slow'''.
|}

== Obtaining the toolchain ==

Each build method requires its own toolchain:

* '''Debian/Ubuntu''' users can <code>apt-get install gcc-mingw32 mingw32-binutils</code>. <code></code>
* '''Gentoo''' users can <code>emerge crossdev && crossdev mingw32</code>
* '''ArchLinux''' users can <code>pacman -S mingw32-gcc</code>
* '''Fedora''' users should read [[Win32CompileFedora13]]
* Other '''Linux''' systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW
* Native-compile with '''[http://www.mingw.org MSYS+MINGW]''', should read the [[Win32CompileMSYSNew|documentation]]
* Native-compile with '''[http://www.cygwin.com Cygwin]''', should read the [[Win32CompileCygwinNew|documentation]]

=== tools ===
You will also need:
* lua5.1
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* zip [for creating .zip package], p7zip [for .7z package], nsis [for .exe auto-installer].

== Get the source code ==
$ git clone git://git.videolan.org/vlc.git

== Prepare [[Contrib Status|3rd party libraries]] ==

Before compiling VLC, you need lots of other libraries. Here is how to get them:

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt

or, if you want to compile the contribs yourself and are feeling adventurous and have lots of time to burn,

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make fetch
$ make

=== Linux 64bits ===

If you are on linux '''64bits''', you '''MUST''' remove some files:

$ rm -f ../i586-mingw32msvc/bin/moc ../i586-mingw32msvc/bin/uic ../i586-mingw32msvc/bin/rcc

And install your ''qt4-tools''.

=== Fix your contrib path ===

If your Mingw prefix is not ''i586-mingw32msvc'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:
$ ln -sf ../i586-mingw32msvc ../i486-mingw32

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i586-mingw32msvc
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i586-mingw32msvc
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages with the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile

2012-02-05T21:00:59Z

John F: /* tools */

How to compile {{VLC}} for [[Windows]].

== Building Methods ==

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

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''Cross-compile with Mingw on Linux'''
| This page
| '''Preferred''' method (uses cross compilation). On Windows, you should do it in a virtual machine.
|-
| '''Native compilation''' with '''[http://www.mingw.org MSYS+MINGW]'''
| [[Win32CompileMSYSNew]]
| '''Native''' compilation method. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows.
|-
| '''Native compilation''' with '''cygwin'''
| [[Win32CompileCygwinNew]]
| Build using cygwin as your compile environment. '''Error''' prone, and '''slow'''.
|}

== Obtaining the toolchain ==

Each build method requires its own toolchain:

* '''Debian/Ubuntu''' users can <code>apt-get install gcc-mingw32 mingw32-binutils</code>. <code></code>
* '''Gentoo''' users can <code>emerge crossdev && crossdev mingw32</code>
* '''ArchLinux''' users can <code>pacman -S mingw32-gcc</code>
* '''Fedora''' users should read [[Win32CompileFedora13]]
* Other '''Linux''' systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW
* Native-compile with '''[http://www.mingw.org MSYS+MINGW]''', should read the [[Win32CompileMSYSNew|documentation]]
* Native-compile with '''[http://www.cygwin.com Cygwin]''', should read the [[Win32CompileCygwinNew|documentation]]

=== tools ===
You will also need:
* lua5.1
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* zip [for creating a .zip package], p7zip [for a .7z package], nsis [for a .exe auto-installer].

== Get the source code ==
$ git clone git://git.videolan.org/vlc.git

== Prepare [[Contrib Status|3rd party libraries]] ==

Before compiling VLC, you need lots of other libraries. Here is how to get them:

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt

or, if you want to compile the contribs yourself and are feeling adventurous and have lots of time to burn,

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make fetch
$ make

=== Linux 64bits ===

If you are on linux '''64bits''', you '''MUST''' remove some files:

$ rm -f ../i586-mingw32msvc/bin/moc ../i586-mingw32msvc/bin/uic ../i586-mingw32msvc/bin/rcc

And install your ''qt4-tools''.

=== Fix your contrib path ===

If your Mingw prefix is not ''i586-mingw32msvc'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:
$ ln -sf ../i586-mingw32msvc ../i486-mingw32

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i586-mingw32msvc
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i586-mingw32msvc
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages with the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Win32Compile

2012-02-05T21:00:19Z

John F: /* tools */

How to compile {{VLC}} for [[Windows]].

== Building Methods ==

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

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''Cross-compile with Mingw on Linux'''
| This page
| '''Preferred''' method (uses cross compilation). On Windows, you should do it in a virtual machine.
|-
| '''Native compilation''' with '''[http://www.mingw.org MSYS+MINGW]'''
| [[Win32CompileMSYSNew]]
| '''Native''' compilation method. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows.
|-
| '''Native compilation''' with '''cygwin'''
| [[Win32CompileCygwinNew]]
| Build using cygwin as your compile environment. '''Error''' prone, and '''slow'''.
|}

== Obtaining the toolchain ==

Each build method requires its own toolchain:

* '''Debian/Ubuntu''' users can <code>apt-get install gcc-mingw32 mingw32-binutils</code>. <code></code>
* '''Gentoo''' users can <code>emerge crossdev && crossdev mingw32</code>
* '''ArchLinux''' users can <code>pacman -S mingw32-gcc</code>
* '''Fedora''' users should read [[Win32CompileFedora13]]
* Other '''Linux''' systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW
* Native-compile with '''[http://www.mingw.org MSYS+MINGW]''', should read the [[Win32CompileMSYSNew|documentation]]
* Native-compile with '''[http://www.cygwin.com Cygwin]''', should read the [[Win32CompileCygwinNew|documentation]]

=== tools ===
You will also need:
* lua5.1
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* zip [for creating a .zip package], p7zip [for a .7z package], nsis [for a .exe installer].

== Get the source code ==
$ git clone git://git.videolan.org/vlc.git

== Prepare [[Contrib Status|3rd party libraries]] ==

Before compiling VLC, you need lots of other libraries. Here is how to get them:

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make prebuilt

or, if you want to compile the contribs yourself and are feeling adventurous and have lots of time to burn,

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i586-mingw32msvc
$ make fetch
$ make

=== Linux 64bits ===

If you are on linux '''64bits''', you '''MUST''' remove some files:

$ rm -f ../i586-mingw32msvc/bin/moc ../i586-mingw32msvc/bin/uic ../i586-mingw32msvc/bin/rcc

And install your ''qt4-tools''.

=== Fix your contrib path ===

If your Mingw prefix is not ''i586-mingw32msvc'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:
$ ln -sf ../i586-mingw32msvc ../i486-mingw32

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i586-mingw32msvc
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i586-mingw32msvc
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages with the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code> (might be package-win32-strip)
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]