1OGGTRANSCODE(1) User Manuals OGGTRANSCODE(1)
2
6 oggTranscode - transcodes ogg files in multiple ways
7
9 oggTranscode [options] inputfile.ogv outputfile.ogv
10
12 oggTranscode can resize an ogg file (ogg, oga or ogv) in multiple ways:
13 It can change the video frame size, change datarate for the video
14 and/or audio streams contained in the ogg file and it can also change
15 the video frame rate or audio sample rate.
16 Additionally, since version 0.8 oggTranscode can add any ogg comment
18 and png‐pictures with an alpha channel can be rendered into the video
19 at any time period before and after the resizing process.
20 oggTranscode was previously called oggResize.
22
25 -s Sets the size of the video frame. The size is given as
26 <width>x<height>. At default, the video frame size keeps the
27 same.
28 Example: -s 320x240
30 -d Sets the datarate in byte per seconds for the video encoder
33 (theora). This meant to be a upper threshold. So the file may be
34 smaller than assumed. If not set, the datarate of the original
35 stream is used.
36 Example: -d 1024000
38 -D Sets the datarate in byte per seconds for the audio encoder
41 (vorbis). If not set, the datarate of the original stream is
42 used.
43 Example: -D 64000
45 -f Sets the frame rate of the video with numinator and demoninator
48 and is the pictures per second. If only one number is given, the
49 denominator is set to 1. If not set, the framerate of the origi‐
50 nal video is used.
51 Example: -f 25:2
53 -F Sets the sample frequency (sample rate) of the audio data in
56 Hertz. If the sample frequency does not match the one with the
57 original file, resamling is invoked.
58 Example: -F 32000
60 -c
63 Adds comments to the video (theora) stream. Comments are given
65 by a pair of type and value in the form 'type=value'. More than
66 one comment can be concatenated with a semicolon. It is recom‐
67 mended to use apostrophes as the command line may use the semi‐
68 colon as a separator.
69 Example: -c 'AUTHOR=yorn;DATE=03.07.09'
71 -C Adds comments to the audio (vorbis) stream. Comments are given
74 by a pair of type and value in the form 'type=value'. More than
75 one comment can be concatenated with a semicolon. It is recom‐
76 mended to use apostrophes as the command line may use the semi‐
77 colon as a separator.
78 Example: -C 'AUTHOR=yorn;DATE=03.07.09'
80 -q Specifies the quality for the resizing process. Values can be
83 chosen between 1 (best quality, with slight bluring) and 6
84 (worst quality). The default value is 2.
85 Example: -q1
87 -p This option is meant to help creating a preview of a film. The
90 number given with this option defines the number of frames, that
91 are omitted. E.g. if a film has 24 frames per second and -p24
92 is given, the newly created video shows the video 24 times
93 faster as only every 24th frame is used. This option can be
94 combined with the option -f to control the framerate. With both
95 options nice video previews can be created. If -p is used, the
96 audio stream is ignored.
97 Example: -p 24
99 -a Adds a picture to the video frame before it is resized. The
102 expression for the picture appearances:
103 <picture1.png>[,<startTime>[,<endTime>[,s]]]
105 startTime in seconds - value can be a floating point. Default
107 startTime is 0
108 endTime in seconds - value can be a floating point. default
110 endTime is -1, which is the end of the stream duration
111 default s ist not set. If s is set, the picture slides in
113 smoothly.
114 More than one picture can be included. To concatenate the
116 expressions use the colon. If the appearance time overlap, the
117 pictures are placed on one another, so the last picture is the
118 uppest layer.
119 Example: -a etwas.png,2,7,s:etwasneues.png,5,10
121 -A Adds a picture to the video frame after it is resized.
124 The syntax follows the same expression as with option -a.
126
129 oggTranscode -s320x240 -d512000 orig.ogv new.ogv
130 Converts a the video orig.ogv to the video new.ogv with the new frame
132 size 320x240. If there was an audio stream within the orig.ogv file, it
133 is copied into the new file.
134 oggTranscode -D64000 -F16000 -N1 orig.ogv new.ogv
136 Converts only the audio stream of file orig.ogv to a sample rate of
138 16kHz, a datarate of 64 kBit/s and a mono channel. The video stream is
139 copied as is.
140 oggTranscode -s300x200 -D32000 -d1024000 -A etwas.png,2,7,s:etwas‐
142 neues.png,5,10 orig.ogv new.ogv
143 Converts the audio and video stream and adds the alpha channel picture
145 etwas.png to the video from second 2 to second 7 with a smooth fade in
146 and fade out. Additionally the alpha channel picture etwasneues.png is
147 placed on top of the video frame from second 5 to second 10 without any
148 fading.
149
152 Joern Seger <yorn at gmx dot net>
153
155 oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggSlideshow(1), oggTh‐
156 umb(1), oggSilence(1)
157Linux JAN 2010 OGGTRANSCODE(1)