NAME¶
ogminfo - Print information about streams in OGG/OGM files
SYNOPSIS¶
ogminfo [
options]
inname
DESCRIPTION¶
This program lists all streams contained in an OGM including information about
the codecs used.
- inname
- Use 'inname' as the source.
- -v, --verbose
- Be verbose and show each OGG packet. See the section
'VERBOSITY LEVELS' for details.
- -s, --summary
- Will print a short summary for each stream including the
total size in bytes, the bitrate, the number of packets/frames and the
length in seconds. This requires the parsing of the complete file.
- -h, --help
- Show usage information.
- -V, --version
- Show version information.
VERBOSITY LEVELS¶
The
-v option can be used to increase
ogminfo's verbosity level
and print more information about the current file.
- level 0
- will print only the streams it finds and their types.
- level 1
- will also print each stream's header and comment packets'
contents. These two modes will not process the whole file (as opposed to
all other modes) if the comment packets are placed correctly.
- level 2
- will print a line for each OGG packet it encounters
containing the stream the packet belongs to, the payload size, the
packet's granulepos, the packet's number, its start time, its end time and
several flags. The flags may include 'sync_ok' or 'OUT_OF_SYNC' which
indicates whether the packet's placement in the file is correct according
to its granulepos. Other flags are 'IS_SYNCPOINT' or 'EOS'.
level 2 and above automatically imply --summary.
- level 3
- also prints a line whenever a new OGG page was read
completely along with the page's exact position in the file it was read
from.
- level 4
- will dump the complete stream_header structure found in the
header packet for any non-Vorbis stream.
The levels 3 and 4 are intended for debugging purposes only.
NOTES¶
What works:
- *
- OGM with Vorbis audio, 'normal' video (like DivX etc.),
audio streams (PCM, MP3 etc.), text streams (subtitles).
What not works:
- *
- Headers created by older OggDS (DirectShow) filter versions
are not supported (and probably never will be).
AUTHOR¶
ogminfo was written by Moritz Bunkus <moritz@bunkus.org>.
SEE ALSO¶
ogmmerge(1),
ogmsplit(1),
ogmdemux(1),
ogmcat(1),
dvdxchap(1)
WWW¶
The newest version can always be found at
<http://www.bunkus.org/videotools/ogmtools/>