Provided by: oggz-tools_1.1.1-6_amd64 bug


       oggz-chop — Extract the part of an Ogg file between given start and/or end times.


       oggz-chop [-o filename  | --output filename ]  [-s start_time  | --start start_time ]  [-e
       end_time  | --end end_time ]  [-k  | --no-skeleton ] filename

       oggz-chop [-h  | --help ]  [-v  | --version ]


       oggz-chop chops a section  of  an  Ogg  file.   It  correctly  interprets  the  granulepos
       timestamps of Ogg CELT, CMML, Dirac, FLAC, Kate, PCM, Speex, Theora and Vorbis bitstreams.
       Run oggz-known-codecs(1) for a full list of codecs known by the installed version of oggz.

       The output file contains copies of the headers of the input file, and all the  codec  data
       required  to correctly decode the content between the start and end times specified on the
       commandline. For codecs with data dependencies like video keyframes, the keyframe prior to
       the starting time will be included in the output.

       Note  that  oggz-chop  operates  by  copying  pages of Ogg data; it does not strip partial
       packets from the first or last data page included in the output. It does however ensure to
       set the end of stream flag on the last page of each logical bitstream.

       Skeleton  handling:  By  default,  the output will contain a Skeleton track specifying the
       start of the chop as presentation time.


       oggz-chop accepts the following options:

   Output options
       -o filename, --output filename
                 Write output to the specified  filename  instead  of  printing  it  to  standard

       -s start_time, --start start_time
                 Specify the start time of the chopped section to output.

       -e end_time, --end end_time
                 Specify the end time of the chopped section to output.

       -k , --no-skeleton
                 Do NOT include a Skeleton bitstream in the output.

       -h, --help
                 Display usage information and exit.

       -v, --version
                 Output version information and exit.


       Extract the first minute of file.ogx:

              oggz chop -e 1:00 file.ogx

       Extract from the second to the fifth minute of file.ogx:

              oggz chop -s 2:00 -e 5:00 -o output.ogx file.ogx

       Extract, specifying SMPTE-25 frame offsets:

              oggz chop -s smpte-25:00:02:03::12 -e smpte-25:00:05:02::04 -o output.ogv file.ogv

Server configuration

       The  following  configuration  for Apache httpd will enable oggz-chop. As with most Apache
       directives, this may of course be restricted to particular Directories or Locations:

       ScriptAlias /oggz-chop /usr/bin/oggz-chop

       Action application/ogg /oggz-chop

   HTTP/1.1 Cacheability
       oggz-chop generates Last-Modified HTTP headers, and  responds  correctly  to  If-Modified-
       Since conditional GET requests.


       Conrad Parker        February 25, 2008;


       Copyright © 2008 Annodex Association


       oggz-validate(1), oggz-merge(1), oggz-dump(1), hogg(1)