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

NAME

6       oggCat - concatenates two or more ogg files
7

SYNOPSIS

9       oggCat [options] outfile.ogv file1.ogv file2.ogv [ file3.ogv [...] ]
10

DESCRIPTION

12       oggCat  concatenates  two  or  more ogg files (.ogv, .ogg or oga), that
13       contain theora and/or vorbis streams.
14
15       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
19       All subsequent files that does not  match  these  file  parameters  are
20       automatically transcoded.
21
22       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
27       If there is more than one video or audio stream within  the  file,  the
28       first stream is used.
29
30

OPTIONS

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
36              Example: -s 320x240
37
38
39       -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
44              Example: -d 1024000
45
46
47       -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
50              Example: -D 64000
51
52
53       -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
58              Example: -f 25:2
59
60
61       -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
65              Example: -F 32000
66
67
68       -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
74              Example: -c 'AUTHOR=yorn;DATE=03.07.09'
75
76
77       -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
83              Example: -C 'AUTHOR=yorn;DATE=03.07.09'
84
85
86       -q     Specifies the video quality for the newly created stream.  Valid
87              values can be chosen between 0 and 63 (best).
88
89              Example: -q 63
90
91
92       -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
97
98       -x     Force to overwrite the output file, even if it exists.  This  is
99              mainly helpful if the oggCat is server controlled.
100
101

EXAMPLES

103       oggCat concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv
104
105       or
106
107       oggCat -o concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv
108
109       This  command  creates a cancatenated file concatFile.ogv that consists
110       of the three files myfile1.ogv, myfile2.ogv and myfile3.ogv
111
112       oggCat   -s320x240   -q63   concatFile.ogv   myfile1.ogv    myfile2.ogv
113       myfile3.ogv
114
115       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
119

AUTHOR

121       Joern Seger <yorn at gmx dot net>
122
123

SEE ALSO

125       oggCut(1),  oggJoin(1),  oggSplit(1), oggTranscode(1), oggSlideshow(1),
126       oggThumb(1), oggSilence(1)
127
128
129
130Linux                              JAN 2010                          OGGCAT(1)
Impressum