oggz-chop (1)
NAME
oggz-chop --- Extract the part of an Ogg file between given start and/or end times.SYNOPSIS
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 ]
Description
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.
Options
oggz-chop accepts the following options:
Output options
- -o filename, --output filename
-
Write output to the specified
filename instead of printing it to
standard output.
- -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.
EXAMPLES
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.
AUTHOR
Conrad Parker February 25, 2008;
COPYRIGHT
Copyright © 2008 Annodex Association
SEE ALSO
oggz-validate(1), oggz-merge(1), oggz-dump(1), hogg(1)