1OGGTRANSCODE(1)                  User Manuals                  OGGTRANSCODE(1)
2
3
4

NAME

6       oggTranscode - transcodes ogg files in multiple ways
7

SYNOPSIS

9       oggTranscode [options] inputfile.ogv outputfile.ogv
10

DESCRIPTION

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
17       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
21       oggTranscode was previously called oggResize.
22
23

OPTIONS

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
29              Example: -s 320x240
30
31
32       -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
37              Example: -d 1024000
38
39
40       -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
44              Example: -D 64000
45
46
47       -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
52              Example: -f 25:2
53
54
55       -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
59              Example: -F 32000
60
61
62       -c
63
64              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 seperator.
69
70              Example: -c 'AUTHOR=yorn;DATE=03.07.09'
71
72
73       -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 seperator.
78
79              Example: -C 'AUTHOR=yorn;DATE=03.07.09'
80
81
82       -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
86              Example: -q1
87
88
89       -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
98              Example: -p 24
99
100
101       -a     Adds  a  picture  to  the video frame before it is resized.  The
102              expression for the picture appearances:
103
104              <picture1.png>[,<startTime>[,<endTime>[,s]]]
105
106              startTime in seconds - value can be a floating  point.   Default
107              startTime is 0
108
109              endTime  in  seconds  -  value can be a floating point.  default
110              endTime is -1, which is the end of the stream duration
111
112              default s ist not set. If  s  is  set,  the  picture  slides  in
113              smoothly.
114
115              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
120              Example: -a etwas.png,2,7,s:etwasneues.png,5,10
121
122
123       -A     Adds a picture to the video frame after it is resized.
124
125              The syntax follows the same expression as with option -a.
126
127

EXAMPLE

129       oggTranscode -s320x240 -d512000 orig.ogv new.ogv
130
131       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
135       oggTranscode -D64000 -F16000 -N1 orig.ogv new.ogv
136
137       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
141       oggTranscode  -s300x200  -D32000  -d1024000  -A  etwas.png,2,7,s:etwas‐
142       neues.png,5,10 orig.ogv new.ogv
143
144       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
150

AUTHOR

152       Joern Seger <yorn at gmx dot net>
153

SEE ALSO

155       oggCut(1),  oggCat(1), oggJoin(1), oggSplit(1), oggSlideshow(1), oggTh‐
156       umb(1), oggSilence(1)
157
158
159
160Linux                              JAN 2010                    OGGTRANSCODE(1)
Impressum