NAME

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

SYNOPSIS

       oggCut [options] inputfile outputfile

DESCRIPTION

       oggCut creates a new ogg file named outputfile as a subpart of the original file named inputfile

       oggCut  is  able to cut video (theora) only files, audio (vorbis) only files or files with both video and
       audio streams.

       The start and end time for the cut area must be given in milliseconds with the options -s and -e.

       As a video stream consists of I‐frames (which are full pictures) and P‐frames (which are  delta  pictures
       to  the leading I‐frame) the oggCut algorithm searches for the first I‐frame. If a video file would start
       with a p‐frame, the player is not able to interpret this picture, as the leading I‐frame (on where it  is
       based)  is  not available.  oggCut starts the I‐frame search at the start time given by the -s option. So
       expect a shorter video time than the calculated seconds for the new file.

       oggCut does not do any reencoding, therefore the output quality is completely the same as from the  input
       file.

       For those involved into the ogg container format: The file is cut on packet basis, not on page basis.

       There  is  another tool called oggCut out in the internet with a different synopis. This one has not been
       written by the author of this tool you are actually using.

OPTIONS

       -s     Cut start position in ms. If the input file is a video file, the cut area  starts  with  the  next
              keyframe found. Default: 0

              Example: -s 5000

       -l     Length of the cut area in ms. If -e is also given, the length is ignored.

              Example: -l 10000

       -e     Cut  end position in ms. If -l is also used, the end position is preferred. If the end position is
              set to -1, the end of the stream is assumed.

              Default: -1

              Example: -e 20000

       -i

       -o     Input file and output file set (alternative).  These parameters can be  used  alternatively.  They
              are  overwritten by the arguments after the options. If there is one argument given, it is used as
              the input file (and overwrites a file given with -i). If there are two arguments,  the  input  and
              output files from the -i and -o option values are overwritten.

EXAMPLE

       oggCut -s 1000 -e 21000 myVideo.ogv myOutput.ogv

       Creates  a  new video called myOutput.ogv from the video myVideo.ogv starting after 1 second ending after
       21 seconds

AUTHOR

       Joern Seger <yorn at gmx dot net>

SEE ALSO

       oggCat(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggSlideshow(1), oggThumb(1), oggSilence(1)