git.sesse.net Git - vlc/blob - 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.