View source for Win32Compile Under Fedora

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><i>package-name1 package-name2 ...</i>

== 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]]