oggz-chop(1)

✨ oggz-chop ✨

okay bestie, welcome to oggz-chop(1) — this is the General Commands Manual entry, and it's literally the tool that lets you cut a lil slice out of an Ogg file. no cap. 💖

---

🌸 NAME 🌸

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

like, you give it a start time and/or an end time and it hands you back just that chunk. periodt. ✂️

---

🎀 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 🦋

okay so oggz-chop chops a section of an Ogg file. it correctly interprets the granulepos timestamps of Ogg CELT, CMML, Dirac, FLAC, Kate, Opus, PCM, Speex, Theora, Vorbis and VP8 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. (yes bestie, it grabs the keyframe before your start point, because otherwise the video would just be vibes and no actual pixels 💀)

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. so polite, so efficient, main character energy fr fr. 💖

---

👑 AUTHOR 👑

Conrad Parker February 25, 2008;

---

💜 COPYRIGHT 💜

Copyright © 2008 Annodex Association

---

🧚 SEE ALSO 🧚

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

---

okay that's the whole page bestie, mwah 😭💖 this was oggz-chop(1) from the General Commands Manual, dated February 25, 2008 — go forth and chop, you absolute icon 🎀✨