Compiling from SVN
------------------
If you donwloaded ffmpeg2theora from svn you have
need automake 1.6 or later to build the configure script.
To do this run ./autogen.sh
Then build as you would from a tarball.

Compiling from tarball:
-----------------------
you need
- the latest version of libtheora <http://downloads.xiph.org/releases/theora/>
- ffmpeg-trunk <http://ffmpeg.sf.net> by running ./get_ffmpeg_svn.sh
  (this script downloads current ffmpeg trunk, runs an appropriate
  configure and builds ffmpeg)
- for subtitles support, libkate <http://code.google.com/p/libkate/>,
  or by running ./get_libkate.sh (this script downloads libkate, and
  builds libkate)

if you did not install ffmpeg but want to staticly link it
(recomended by ffmpeg developers) update PKG_CONFIG_PATH to
point to your ffmpeg source:

 export PKG_CONFIG_PATH=/path/to/ffmpeg_src:$PKG_CONFIG_PATH

now you can build ffmpeg2theora:
./configure
make

Installation
------------

make install

Unless you specify a different --prefix option to ./configure, you will
need root privileges for this, ie.:

sudo make install

Compiling on windows using mingw32:
---------------------------------
you have to compile libvorbis, libogg, libtheora
configure ffmpeg like this:
./configure --disable-encoder --enable-libogg --enable-vorbis --enable-theora \
 --enable-pp --enable-a52  --enable-gpl


vhook suppport
--------------

right now vhooks only work if you install ffmpeg and use 
the installed shared libs. otherwise one gets errors like this:
 undefined symbol: av_read_frame
this is a known limitation of vhooks in ffmpeg.


subtitles suppport
------------------

Subtitles for multiple languages can be encoded from one or more utf-8
SubRip format files (.srt) if you have libkate installed. Subtitles will
be merged into the output Ogg stream as multiplexed Kate streams.

For example, to encode a video with both German and Italian subtitles:

./ffmpeg2theora -o ouput.ogv --subtitles german.srt --subtitles-language de_DE \
                             --subtitles italian.srt --subtitles-language it \
                   input.avi

See subtitles.txt for more information on how to add subtitles to your
videos.