build/README

   1 This repository contains scripts to help build MPlayer together with
   2 some dependencies that many platforms will not have a new enough
   3 version of.
   4
   5 If you have a multicore machine read about FFmpeg-mt below.
   6
   7
   8
   9 Initializing the repo
  10
  11 First you need to download the actual sources, using either:
  12
  13 ./init
  14 or
  15 ./init --shallow
  16
  17 The latter form creates only partial git repositories which do not
  18 have full history data. This reduces the amount of data you need to
  19 download but reduces the development-related functionality of the
  20 repositories. If you only want to simply build MPlayer it should
  21 usually be enough.
  22
  23
  24
  25 Building
  26
  27 You can build MPlayer with just 'make'. There is no separate
  28 configure step because the MPlayer configure depends on included
  29 library sources being configured _and_ built first. If you want to
  30 give configuration options see the section below.
  31
  32
  33
  34 Enabling FFmpeg-mt
  35
  36 FFmpeg-mt is version of FFmpeg with improved threading support, useful
  37 for things like high-bitrate H264. It allows significantly faster
  38 decoding on multicore machines but is sometimes less stable (it's
  39 quite usable in most cases though). You can enable compilation with
  40 FFmpeg-mt decoders using "./enable-mt" and disable it with
  41 "./disable-mt". To actually use the threading support in your
  42 mt-enabled MPlayer you need to it a "-lavdopts threads=N" option,
  43 where N is the number of threads you want to use (a value equal to
  44 your number of cores is normally good). So if you have a quadcore
  45 machine you can do for example:
  46 ./enable-mt
  47 ./init --shallow
  48 make -j 6
  49 mplayer/mplayer -lavdopts threads=4 some_high_bitrate_h264_stuff.mkv
  50 (or alternatively install first instead of running mplayer from the
  51 build location on the last line)
  52
  53
  54
  55 Giving configure options to MPlayer and FFmpeg
  56
  57 You can specify extra options that will be passed to MPlayer's
  58 configure script by placing them in a file called "mplayer_options" in
  59 this directory. There's a corresponding file called "ffmpeg_options"
  60 for FFmpeg. Options in file "common_options" will be passed to both
  61 MPlayer and FFmpeg; this mainly makes sense for generic options like
  62 "-cc=gcc-4.4'. Place each option on its own line without any quoting.
  63
  64
  65
  66 Helper scripts included in this repo:
  67
  68 ./init
  69 Prepare the repository by downloading actual sources. You need to run
  70 this at least once before you can build anything. With the --shallow
  71 argument creates shallow git repositories that require less bandwidth
  72 to download.
  73
  74 ./update
  75 Download the latest version of the sources.
  76
  77 ./clean
  78 Remove all generated or extra files from build directories and
  79 restore them to their original state. Running this between builds is
  80 probably a good idea.
  81
  82 ./enable-mt
  83 ./disable-mt
  84 Enabled or disable building with FFmpeg-mt support. Can be run before
  85 first ./init or later to switch support on and off. The file
  86 'ffmpeg-mt-enabled' is created or deleted to indicate whether -mt
  87 support is currently active. Note that if you build MPlayer and then
  88 switch -mt support on or off, a rebuild is likely to fail unless you
  89 remember to run ./clean before the new build.