oggz-chop(1)

1oggz-chop(1)                General Commands Manual               oggz-chop(1)
2
3
4

NAME

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

SYNOPSIS

11       oggz-chop [-o filename   |  --output  filename  ]   [-s  start_time   |
12       --start  start_time  ]   [-e end_time  | --end end_time ]  [-k  | --no-
13       skeleton ] filename
14
15       oggz-chop [-h  | --help ]  [-v  | --version ]
16

Description

18       oggz-chop chops a section of an Ogg file.  It correctly interprets  the
19       granulepos timestamps of Ogg CELT, CMML, Dirac, FLAC, Kate, PCM, Speex,
20       Theora and Vorbis bitstreams.  Run oggz-known-codecs(1) for a full list
21       of codecs known by the installed version of oggz.
22
23
24       The  output  file contains copies of the headers of the input file, and
25       all the codec data required to correctly decode the content between the
26       start  and end times specified on the commandline. For codecs with data
27       dependencies like video keyframes, the keyframe prior to  the  starting
28       time will be included in the output.
29
30
31       Note  that oggz-chop operates by copying pages of Ogg data; it does not
32       strip partial packets from the first or last data page included in  the
33       output.  It  does  however  ensure to set the end of stream flag on the
34       last page of each logical bitstream.
35
36
37       Skeleton handling: By default, the output will contain a Skeleton track
38       specifying the start of the chop as presentation time.
39
40

Options

42       oggz-chop accepts the following options:
43
44
45   Output options
46       -o filename, --output filename
47                 Write output to the specified filename instead of printing it
48                 to standard output.
49
50
51       -s start_time, --start start_time
52                 Specify the start time of the chopped section to output.
53
54
55       -e end_time, --end end_time
56                 Specify the end time of the chopped section to output.
57
58
59       -k , --no-skeleton
60                 Do NOT include a Skeleton bitstream in the output.
61
62
63       -h, --help
64                 Display usage information and exit.
65
66       -v, --version
67                 Output version information and exit.
68
69

EXAMPLES

71       Extract the first minute of file.ogx:
72
73              oggz chop -e 1:00 file.ogx
74
75       Extract from the second to the fifth minute of file.ogx:
76
77              oggz chop -s 2:00 -e 5:00 -o output.ogx file.ogx
78
79       Extract, specifying SMPTE-25 frame offsets:
80
81              oggz chop -s smpte-25:00:02:03::12 -e  smpte-25:00:05:02::04  -o
82              output.ogv file.ogv
83
84
85

Server configuration

87       The  following configuration for Apache httpd will enable oggz-chop. As
88       with most Apache directives, this may of course be restricted  to  par‐
89       ticular Directories or Locations:
90
91       ScriptAlias /oggz-chop /usr/bin/oggz-chop
92
93
94       Action application/ogg /oggz-chop
95
96
97   HTTP/1.1 Cacheability
98       oggz-chop  generates Last-Modified HTTP headers, and responds correctly
99       to If-Modified-Since conditional GET requests.
100
101

AUTHOR

103       Conrad Parker        February 25, 2008;
104

COPYRIGHT

106       Copyright © 2008 Annodex Association
107
108