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

NAME

6       oggCut - extracts parts of an ogg file (.ogv, .ogg and .oga)
7

SYNOPSIS

9       oggCut [options] inputfile outputfile
10

DESCRIPTION

12       oggCut  creates  a  new  ogg  file named outputfile as a subpart of the
13       original file named inputfile
14
15       oggCut is able to cut video (theora) only files,  audio  (vorbis)  only
16       files or files with both video and audio streams.
17
18       The  start  and end time for the cut area must be given in milliseconds
19       with the options -s and -e.
20
21       As a video stream consists of I‐frames (which are full pictures) and P‐
22       frames  (which  are  delta  pictures to the leading I‐frame) the oggCut
23       algorithm searches for the first I‐frame. If a video file  would  start
24       with  a  p‐frame,  the player is not able to interpret this picture, as
25       the leading I‐frame (on where it is based) is  not  available.   oggCut
26       starts  the I‐frame search at the start time given by the -s option. So
27       expect a shorter video time than the calculated  seconds  for  the  new
28       file.
29
30       oggCut does not do any reencoding, therefore the output quality is com‐
31       pletely the same as from the input file.
32
33       For those involved into the ogg container format: The file  is  cut  on
34       packet basis, not on page basis.
35
36       There  is another tool called oggCut out in the internet with a differ‐
37       ent synopis. This one has not been written by the author of  this  tool
38       you are actually using.
39
40

OPTIONS

42       -s     Cut start position in ms. If the input file is a video file, the
43              cut area starts with the next keyframe found. Default: 0
44
45              Example: -s 5000
46
47
48       -l     Length of the cut area in ms. If -e is also given, the length is
49              ignored.
50
51              Example: -l 10000
52
53
54       -e     Cut  end position in ms. If -l is also used, the end position is
55              preferred. If the end position is set to  -1,  the  end  of  the
56              stream is assumed.
57
58              Default: -1
59
60              Example: -e 20000
61
62
63       -i
64
65
66       -o     Input  file and output file set (alternative).  These parameters
67              can be used alternatively. They are overwritten by the arguments
68              after the options. If there is one argument given, it is used as
69              the input file (and overwrites a file given with -i).  If  there
70              are two arguments, the input and output files from the -i and -o
71              option values are overwritten.
72
73

EXAMPLE

75       oggCut -s 1000 -e 21000 myVideo.ogv myOutput.ogv
76
77       Creates a new video called  myOutput.ogv  from  the  video  myVideo.ogv
78       starting after 1 second ending after 21 seconds
79
80

AUTHOR

82       Joern Seger <yorn at gmx dot net>
83
84

SEE ALSO

86       oggCat(1),  oggJoin(1),  oggSplit(1), oggTranscode(1), oggSlideshow(1),
87       oggThumb(1), oggSilence(1)
88
89
90
91Linux                              JAN 2010                          OGGCUT(1)
Impressum