File: INSTALL

package info (click to toggle)
ffmpeg2theora 0.30-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid, stretch
  • size: 596 kB
  • ctags: 526
  • sloc: ansic: 5,810; python: 1,021; sh: 83; makefile: 21; xml: 1
file content (62 lines) | stat: -rw-r--r-- 1,844 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
Compiling from tarball or subversion:
-----------------------
you need
- scons (http://www.scons.org/)
- the latest version of libtheora <http://downloads.xiph.org/releases/theora/>
- ffmpeg git <http://ffmpeg.org> by running ./get_ffmpeg.sh
  (this script downloads ffmpeg and runs configure and compiles 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:
 scons

to make a static binary
 scons static=1


Installation
------------
install ffmpeg2theora in /usr/local/bin:

 scons install

Unless you specify a different prefix,
you will need root privileges for this, ie.:

 sudo scons install

to install to another prefix:

 scons install prefix=/usr

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.