oggz-rip(1) [debian man page]

oggz-rip(1)						      General Commands Manual						       oggz-rip(1)

NAME

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

SYNOPSIS

       oggz-rip [-o filename  | --output filename ] filename

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

Description
       oggz-rip extracts one or more tracks from an Ogg file.  In Ogg terminology, oggz-rip extracts one or more logical bitstreams.

       For example, to extract just the Vorbis audio track from any Ogg file:

       oggz-rip -c vorbis input.ogx > output.ogg

       This  will removed any other tracks: Skeleton, Theora, image, etc.  The output will be a valid Ogg Vorbis I file, suitable for use on hard-
       ware players that do not support multiplexed (ie. multi-track) Ogg files. If the input file contains multiple Vorbis, the desired once  can
       be specified by serialno with the -s option.  Use oggz-info to view the serialno of each track in a file.

Options
       oggz-rip accepts the following options:

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

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

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

   Filter options
       These options can be used multiple times. Pages matching ANY of the filter options will be included into the output.

       -s serialno, --serialno serialno
		 Output streams with given serialno.

       -i index, --stream-index index
		 Filter by stream index. These are assigned to streams in the order of their BOS pages, starting at 0.

       -c content-type --content-type content-type
		 Filter by content-type.  Run oggz-known-codecs(1) for a full list of codecs known by the installed version of oggz.

EXAMPLES

       Extract all bitstreams from file.ogg:

	      oggz rip -o output.ogg file.ogg

       Extract only the Theora bitstream from file.ogv:

	      oggz rip -c theora -o output.ogv file.ogv

AUTHOR

       David Kuehling	     January  1, 2005;

COPYRIGHT

       Copyright (C) 2005 CSIRO Australia

SEE ALSO

       oggz-merge(1), oggz-chop(1), oggz-dump(1), oggz-diff(1)	     hogg(1)

																       oggz-rip(1)

oggz-dump(1)						      General Commands Manual						      oggz-dump(1)

NAME

       oggz-dump -- Hexdump packets of an Ogg file, or revert an Ogg file from such a hexdump

SYNOPSIS

       oggz-dump  [-b	|  --binary ]  [-x  | --hexadecimal ]  [-n  | --new ]  [-o filename  | --output filename ]  [-c content-type  | --content-
       type content-type ]  [-s serialno  | --serialno serialno ]  [-O	| --hide-offset ]  [-S	| --hide-serialno ]  [-G   |  --hide-granulepos  ]
       [-P  | --hide-packetno ] filename

       oggz-dump [-r  | --revert ]  [-o filename  | --output filename ] filename

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

Description
       oggz-dump generates a hexadecimal or binary dump of packets in an Ogg file, or creates an Ogg file from a hexadecimal oggz-dump file.

Options
       oggz-dump accepts the following options:

   Dump format options
       -b, --binary
		 Generate a binary dump of each packet

       -x, --hexadecimal
		 Generate a hexadecimal dump of each packet

   Filtering options
       -n, --new Only dump the first packet of each new logical bitstream found; for correctly formed Ogg files, this dumps only the beginning-of-
		 stream packets.

       -c content-type, --content-type content-type
		 Dump only the logical bitstreams for a specific content-type.	Run oggz-known-codecs(1) for a full list of codecs  known  by  the
		 installed version of oggz.

       -s serialno, --serialno serialno
		 Dump only the logical bitstream with specified serialno.

       -O, --hide-offset
		 Hide  the  byte  offset field of the preamble for each packet dumped. This is particularly useful in conjunction with oggzdiff(1)
		 when comparing Ogg bitstreams that differ only in page structure.

       -S, --hide-serialno
		 Hide the serialno field of the preamble for each packet dumped. This is particularly useful in conjunction with oggzdiff(1)  when
		 comparing Ogg bitstreams that differ only in serialno assignment.

       -G, --hide-granulepos
		 Hide the granulepos field of the preamble for each packet dumped.

       -P, --hide-packetno
		 Hide the packetno field of the preamble for each packet dumped.

   Mode options
       -r, --revert
		 Revert an oggz-dump. Generates an Ogg bitstream as prescribed in the input oggz-dump.

		 The  serialno,  granulepos  and  packetno  fields  of the packet preambles in the oggz-dump, as well as any bos or eos markers if
		 present, are used to structure the packets into logical bitstreams. Hence it is advised that the original input oggz-dump not	be
		 generated with any hiding filters.

		 Only the hexadecimal data columns of the input oggz-dump are parsed when generating Ogg packet data; the printable character rep-
		 resentation is ignored.

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

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

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

EXAMPLES

       Dump all bitstreams in file.ogg:

	      oggz dump file.ogg

       Dump only the Theora bitstream in file.ogv:

	      oggz dump -c theora file.ogv

AUTHOR

       Conrad Parker	    November 17, 2003;

COPYRIGHT

       Copyright (C) 2003 CSIRO Australia

SEE ALSO

       oggz-diff(1), hogg(1)	   xxd(1), hexdump(1)

																      oggz-dump(1)