ffmpeg2theora/INSTALL

   1 Compiling from SVN
   2 ------------------
   3 If you donwloaded ffmpeg2theora from svn you need
   4 automake 1.8 or later to build the configure script.
   5 To do this run ./autogen.sh
   6 Then build as you would from a tarball.
   7
   8 Compiling from tarball:
   9 -----------------------
  10 you need
  11 - the latest version of libtheora <http://downloads.xiph.org/releases/theora/>
  12 - ffmpeg-trunk <http://ffmpeg.sf.net> by running ./get_ffmpeg_svn.sh
  13   (this script downloads current ffmpeg trunk, runs an appropriate
  14   configure and builds ffmpeg)
  15 - for subtitles support, libkate <http://code.google.com/p/libkate/>,
  16   or by running ./get_libkate.sh (this script downloads libkate, and
  17   builds libkate)
  18
  19 if you did not install ffmpeg but want to staticly link it
  20 (recomended by ffmpeg developers) update PKG_CONFIG_PATH to
  21 point to your ffmpeg source:
  22
  23  export PKG_CONFIG_PATH=/path/to/ffmpeg_src:$PKG_CONFIG_PATH
  24
  25 now you can build ffmpeg2theora:
  26 ./configure
  27 make
  28
  29 Installation
  30 ------------
  31
  32 make install
  33
  34 Unless you specify a different --prefix option to ./configure, you will
  35 need root privileges for this, ie.:
  36
  37 sudo make install
  38
  39 vhook suppport
  40 --------------
  41
  42 right now vhooks only work if you install ffmpeg and use
  43 the installed shared libs. otherwise one gets errors like this:
  44  undefined symbol: av_read_frame
  45 this is a known limitation of vhooks in ffmpeg.
  46
  47 subtitles suppport
  48 ------------------
  49
  50 Subtitles for multiple languages can be encoded from one or more utf-8
  51 SubRip format files (.srt) if you have libkate installed. Subtitles will
  52 be merged into the output Ogg stream as multiplexed Kate streams.
  53
  54 For example, to encode a video with both German and Italian subtitles:
  55
  56 ./ffmpeg2theora -o ouput.ogv --subtitles german.srt --subtitles-language de_DE \
  57                              --subtitles italian.srt --subtitles-language it \
  58                    input.avi
  59
  60 See subtitles.txt for more information on how to add subtitles to your
  61 videos.