INSTALL.maemo 2.87 KB
Newer Older
Antoine Lejeune's avatar
Antoine Lejeune committed
1 2 3
INSTALL file for the Maemo version of the VLC media player


4 5
Building VLC from source code
=============================
Antoine Lejeune's avatar
Antoine Lejeune committed
6

7 8 9 10
If you want to build the Maemo version of VLC from the source, you have to
install the Maemo Software Development Kit as indicated in the Maemo Diablo
Reference Manual for Maemo 4.1. You can find it from this page:
http://maemo.org/development/documentation/tutorials/
Antoine Lejeune's avatar
Antoine Lejeune committed
11

12 13
You have to use the ARMEL target (arm) of the Maemo SDK. The x86 target was
not tested.
Antoine Lejeune's avatar
Antoine Lejeune committed
14 15


16 17
Installing autotools
====================
Antoine Lejeune's avatar
Antoine Lejeune committed
18

19 20
Once you have a working scratchbox with the Maemo SDK installed and before
compiling VLC, you must install some additional tools and libraries.
Antoine Lejeune's avatar
Antoine Lejeune committed
21

22 23 24 25 26
VLC requires automake 1.9 and autoconf 2.61 (or more recent). As of the Diablo
release, they are not easy to install within the Maemo SDK for Scratchbox.
The easiest solution is to use those from your Linux distribution _outside_
Scratchbox (in your native desktop environment). You will also need the
gettext and libgcrypt development files.
Antoine Lejeune's avatar
Antoine Lejeune committed
27

28 29 30 31 32 33 34 35 36 37 38 39 40 41
Go to the VLC source code directory, e.g.:
    cd /scratchbox/users/$(whoami)/home/$(whoami)/vlc
and run:
    ./bootstrap


Installing correct headers
==========================

For VLC to compile under the Maemo SDK, you must copy the linux/videodev2.h
from your Linux distribution into the Scratchbox.

To build the OMAP Frame Buffer video output module, you also need an up-to-date
asm/arch-omap/omapfb.h (you can find it on google by searching for "omapfb.h").
Antoine Lejeune's avatar
Antoine Lejeune committed
42 43


44 45
Installing additional libraries
===============================
Antoine Lejeune's avatar
Antoine Lejeune committed
46

47 48 49
Login to Scratchbox. You can also install fribidi, libvorbixidev, libmad and
other VLC dependencies which you can find in the Maemo extra repositories.
Add these lines to /etc/apt/sources.list (if not alerady done):
Antoine Lejeune's avatar
Antoine Lejeune committed
50 51 52
    deb http://repository.maemo.org/extras/ diablo free
    deb-src http://repository.maemo.org/extras/ diablo free

53 54
Then run:
    apt-get update
Antoine Lejeune's avatar
Antoine Lejeune committed
55 56 57


FFmpeg (not necessary)
58
======================
Antoine Lejeune's avatar
Antoine Lejeune committed
59

60 61 62 63
You should also build FFMPEG. To that end, you can use Debian source package
as is. Get the ffmpeg-free_0.svn20080206.orig.tar.gz and the Debian diff file
ffmpeg-free_0.svn20080206-8.diff.gz for example. Decompress them and apply the
patch.
Antoine Lejeune's avatar
Antoine Lejeune committed
64

65 66
You will need to alter the debian/rules and debian/control files to remove a
few dependencies not available in Maemo.
Antoine Lejeune's avatar
Antoine Lejeune committed
67 68 69 70 71

You might have to change the line 3550 of ffmpeg/libavcodec/dsputil.c from
    DECLARE_ALIGNED_8 (uint64_t, aligned_bak[stride]);
to
    uint64_t *aligned_bak[stride];
72 73
to build FFMPEG within Scratchbox.

Antoine Lejeune's avatar
Antoine Lejeune committed
74 75 76 77

Configuring
===========

78 79 80 81 82
You can run, for example:
    ./configure --disable-qt4 --disable-skins2 --disable-glx --disable-a52 \
                --enable-tremor --enable-maemo --enable-omapfb --enable-flac \
                --enable-debug

Antoine Lejeune's avatar
Antoine Lejeune committed
83 84 85 86 87 88 89 90

Building VLC
============

Just do :
    make


91 92 93 94 95
Running VLC
===========

VLC will not properly run inside the Scratchbox, you must test it directly on
the target device.