Martin.leese: /* Reporting */ Added codecs

2009-09-15T21:32:43Z

Reporting: Added codecs

← Older revision		Revision as of 21:32, 15 September 2009
Line 17:		Line 17:
	=== Reporting ===		=== Reporting ===

			codecs Display the list of codecs found in one or more files and
			their bitstreams.
	diff Hexdump the packets of two Ogg files and output differences.		diff Hexdump the packets of two Ogg files and output differences.
	dump Hexdump packets of an Ogg file, or revert an Ogg file from		dump Hexdump packets of an Ogg file, or revert an Ogg file from

Martin.leese: Created page

2009-06-29T22:57:40Z

Created page

New page

'''Oggz''' comprises ''liboggz'' and the tool ''oggz'', which provides commands to inspect, edit and validate [[Ogg]] files. The ''oggz-chop'' tool can also be used to serve time ranges of Ogg media over HTTP by any web server that supports CGI.

''liboggz'' is a C library for reading and writing [[Ogg]] files and streams. It offers various improvements over the reference ''libogg'', including support for seeking, validation and timestamp interpretation.

== oggz tool ==

<pre>
Usage: oggz [options] filename ...
</pre>

oggz is a commandline tool for manipulating Ogg files. It supports multiplexed files conformant with RFC3533. Oggz can parse headers for [[CELT]], [[CMML]], [[FLAC]], [[Kate]], [[PCM]], [[Speex]], [[Theora]] and [[Vorbis]], and can read and write [[Ogg Skeleton]] logical bitstreams.

=== Commands ===

help Display help for a specific subcommand (eg. "oggz help chop")

=== Reporting ===

diff Hexdump the packets of two Ogg files and output differences.
dump Hexdump packets of an Ogg file, or revert an Ogg file from
such a hexdump.
info Display information about one or more Ogg files and their
bitstreams.
scan Scan an Ogg file and output characteristic landmarks.
validate Validate the Ogg framing of one or more files.

=== Extraction ===

rip Extract one or more logical bitstreams from an Ogg file.

=== Editing ===

chop Extract the part of an Ogg file between given start and/or
end times.
comment List or edit comments in an Ogg file.
merge Merge Ogg files together, interleaving pages in order of
presentation time.
sort Sort the pages of an Ogg file in order of presentation time.

=== Miscellaneous ===

known-codecs List codecs known by this version of oggz

== oggz-chop ==

oggz-chop extracts the part of an Ogg file between given start and/or end times. 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.

An Apache server can be configured to use oggz-chop to handle all Ogg files (or, all Ogg files in a particular directory). An example Apache configuration is in the liboggz source tree, along with a script for installing it on a Debian server.

== External links ==

* http://www.xiph.org/oggz/

Oggz - Revision history

Martin.leese: /* Reporting */ Added codecs

Martin.leese: Created page