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.