win32text: don't render empty strings
[vlc.git] / INSTALL.maemo
1 INSTALL file for the Maemo version of the VLC media player
2
3
4 Building VLC from source code
5 =============================
6
7 If you want to build the Maemo version of VLC from the source, you have to
8 install the Maemo Software Development Kit as indicated in the Maemo Diablo
9 Reference Manual for Maemo 4.1. You can find it from this page:
10 http://maemo.org/development/documentation/tutorials/
11
12 You have to use the ARMEL target (arm) of the Maemo SDK. The x86 target was
13 not tested.
14
15
16 Installing autotools
17 ====================
18
19 Once you have a working scratchbox with the Maemo SDK installed and before
20 compiling VLC, you must install some additional tools and libraries.
21
22 VLC requires automake 1.9 and autoconf 2.61 (or more recent). As of the Diablo
23 release, they are not easy to install within the Maemo SDK for Scratchbox.
24 The easiest solution is to use those from your Linux distribution _outside_
25 Scratchbox (in your native desktop environment). You will also need the
26 gettext and libgcrypt development files.
27
28 Go to the VLC source code directory, e.g.:
29     cd /scratchbox/users/$(whoami)/home/$(whoami)/vlc
30 and run:
31     ./bootstrap
32
33
34 Installing correct headers
35 ==========================
36
37 For VLC to compile under the Maemo SDK, you must copy the linux/videodev2.h
38 from your Linux distribution into the Scratchbox.
39
40 To build the OMAP Frame Buffer video output module, you also need an up-to-date
41 asm/arch-omap/omapfb.h (you can find it on google by searching for "omapfb.h").
42
43
44 Installing additional libraries
45 ===============================
46
47 Login to Scratchbox. You can also install fribidi, libvorbixidev, libmad and
48 other VLC dependencies which you can find in the Maemo extra repositories.
49 Add these lines to /etc/apt/sources.list (if not alerady done):
50     deb http://repository.maemo.org/extras/ diablo free
51     deb-src http://repository.maemo.org/extras/ diablo free
52
53 Then run:
54     apt-get update
55
56
57 FFmpeg (not necessary)
58 ======================
59
60 You should also build FFMPEG. To that end, you can use Debian source package
61 as is. Get the ffmpeg-free_0.svn20080206.orig.tar.gz and the Debian diff file
62 ffmpeg-free_0.svn20080206-8.diff.gz for example. Decompress them and apply the
63 patch.
64
65 You will need to alter the debian/rules and debian/control files to remove a
66 few dependencies not available in Maemo.
67
68 You might have to change the line 3550 of ffmpeg/libavcodec/dsputil.c from
69     DECLARE_ALIGNED_8 (uint64_t, aligned_bak[stride]);
70 to
71     uint64_t *aligned_bak[stride];
72 to build FFMPEG within Scratchbox.
73
74
75 Configuring
76 ===========
77
78 You can run, for example:
79     ./configure --disable-qt4 --disable-skins2 --disable-glx --disable-a52 \
80                 --enable-tremor --enable-maemo --enable-omapfb --enable-flac \
81                 --enable-debug
82
83
84 Building VLC
85 ============
86
87 Just do :
88     make
89
90
91 Running VLC
92 ===========
93
94 VLC will not properly run inside the Scratchbox, you must test it directly on
95 the target device.