Add missing function to unbreak --disable-sout
[vlc.git] / INSTALL.maemo
1 INSTALL file for the Maemo version of the VLC media player
2
3
4 Building VLC from the source code
5 =================================
6
7 If you want to build the maemo version of VLC from the source, you have to install the
8 Maemo Software Development Kit as indicated in the Maemo Diablo Reference Manual for
9 Maemo 4.1 that you can find on this page : http://maemo.org/development/documentation/tutorials/
10
11 You have to use the ARMEL target (arm) of the Maemo SDK. The X86 target isn't tested.
12
13
14 Installing the correct tools in the scratchbox
15 ==============================================
16
17 When you have a working scratchbox with the Maemo SDK installed, before compiling VLC, you
18 must install additional tools and libraries.
19
20 To compile, VLC needs the lastest version of automake avaible in the SDK : automake-1.9. To
21 use it, you must set the environment variable SBOX_DEFAULT_AUTOMAKE to 1.9 :
22     export SBOX_DEFAULT_AUTOMAKE=1.9
23 You can put it in the .bashrc file inside the scratchbox.
24
25 You also need autoconf-2.61 which is *not* avaible in the Maemo SDK. You have to build it and
26 install it yourself.
27
28 Additional libraries
29 ====================
30
31 You have to install libgcrypt under the scratchbox to build VLC.
32
33 You can also install fribidi, libvorbixidev, libmad and other VLC dependancies that you can find
34 in the extra repositories of Maemo :
35     deb http://repository.maemo.org/extras/ diablo free
36     deb-src http://repository.maemo.org/extras/ diablo free
37
38 Installing correct headers
39 ==========================
40
41 For VLC to compile under the Maemo SDK, you must copy the linux/videodev2.h from your Linux
42 distribution into the scratchbox.
43
44 To build the omap frame buffer video output module, you also need an up-to-date
45 asm/arch-omap/omapfb.h (you can find it on google by searching omapfb.h).
46
47 FFmpeg (not necessary)
48 ======
49
50 You can also build ffmpeg. For this, you can use Debian source package.
51
52 You have to get the ffmpeg-free_0.svn20080206.orig.tar.gz and the Debian diff file
53 ffmpeg-free_0.svn20080206-8.diff.gz for example. Decompress them and apply the patch.
54
55 You have to modify the debian/rules and debian/control files to remove the dependancies
56 which aren't available in the maemo or maemo extra repositories.
57
58 You might have to change the line 3550 of ffmpeg/libavcodec/dsputil.c from
59     DECLARE_ALIGNED_8 (uint64_t, aligned_bak[stride]);
60 to
61     uint64_t *aligned_bak[stride];
62 to build ffmpeg into the scratchbox.
63
64 Configuring
65 ===========
66
67 You can do :
68 ./bootstrap && ./configure --disable-qt4 --disable-skins2 --disable-glx --disable-a52 \
69                            --enable-tremor --enable-maemo --enable-omapfb --enable-flac \
70                            --enable-debug
71 for example.
72
73 Building VLC
74 ============
75
76 Just do :
77     make
78
79 Run VLC
80 =======
81
82 VLC doesn't run inside the scratchbox, you must test it directly on a N800/N810 devices.