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
- ffmpeg-trunk by running ./get_ffmpeg_svn.sh
(this script downloads current ffmpeg trunk, runs an appropriate
configure and builds ffmpeg)
- for subtitles support, 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.