1OGGCAT(1) User Manuals OGGCAT(1)
2
6 oggCat - concatenates two or more ogg files
7
9 oggCat [options] outfile.ogv file1.ogv file2.ogv [ file3.ogv [...] ]
10
12 oggCat concatenates two or more ogg files (.ogv, .ogg or oga), that
13 contain theora and/or vorbis streams.
14 The parameters of the resulting ogg file is defined by the first file
16 in the concatenation list. The parameters can be changed by the
17 options, explained below.
18 All subsequent files that does not match these file parameters are
20 automatically transcoded.
21 A concatenation will fail in case that there are not enought streams
23 available. This could happen e.g. if the first file consists of one
24 audio and one video stream and the second file only carries a video
25 stream.
26 If there is more than one video or audio stream within the file, the
28 first stream is used.
29
32 -s Sets the size of the video frame. The size is given as
33 <width>x<height>. At default, the video frame size is the size
34 of the first video stream.
35 Example: -s 320x240
37 -d Sets the datarate in byte per seconds for the video encoder
40 (theora). This meant to be a upper threshold. So the file may be
41 smaller than assumed. If not set, the datarate of the first file
42 is used.
43 Example: -d 1024000
45 -D Sets the datarate in byte per seconds for the audio encoder
48 (vorbis). If not set, the datarate of the first file is used.
49 Example: -D 64000
51 -f Sets the frame rate of the video with numinator and demoninator
54 and is the pictures per second. If only one number is given, the
55 denominator is set to 1. If not set, the framerate of the first
56 file is used.
57 Example: -f 25:2
59 -F Sets the sample frequency (sample rate) of the audio data in
62 Hertz. If the sample frequency does not match the one with the
63 original file, resamling is invoked.
64 Example: -F 32000
66 -c Adds comments to the video (theora) stream. Comments are given
69 by a pair of type and value in the form 'type=value'. More than
70 one comment can be concatenated with a semicolon. It is recom‐
71 mended to use apostrophes as the command line may use the semi‐
72 colon as a separator.
73 Example: -c 'AUTHOR=yorn;DATE=03.07.09'
75 -C Adds comments to the audio (vorbis) stream. Comments are given
78 by a pair of type and value in the form 'type=value'. More than
79 one comment can be concatenated with a semicolon. It is recom‐
80 mended to use apostrophes as the command line may use the semi‐
81 colon as a separator.
82 Example: -C 'AUTHOR=yorn;DATE=03.07.09'
84 -q Specifies the video quality for the newly created stream. Valid
87 values can be chosen between 0 and 63 (best).
88 Example: -q 63
90 -rv Force to re-encode the video stream. This is sometimes neces‐
93 sary, if the video stream match in video parameters, but not in
94 the theora version. In that case, reencoding the video stream
95 helps creating good results.
96 -x Force to overwrite the output file, even if it exists. This is
99 mainly helpful if the oggCat is server controlled.
100
103 oggCat concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv
104 or
106 oggCat -o concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv
108 This command creates a cancatenated file concatFile.ogv that consists
110 of the three files myfile1.ogv, myfile2.ogv and myfile3.ogv
111 oggCat -s320x240 -q63 concatFile.ogv myfile1.ogv myfile2.ogv
113 myfile3.ogv
114 This command connects the three files myfile[1-3].ogv to a file named
116 concatFile.ogv with the video frame size of 320x240 and the best qual‐
117 ity available.
118
121 Joern Seger <yorn at gmx dot net>
122
125 oggCut(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggSlideshow(1),
126 oggThumb(1), oggSilence(1)
127Linux JAN 2010 OGGCAT(1)