1OGMINFO(1)                       User Commands                      OGMINFO(1)
2
3
4

NAME

6       ogminfo - Print information about streams in OGG/OGM files
7

SYNOPSIS

9       ogminfo [options] inname
10

DESCRIPTION

12       This  program  lists all streams contained in an OGM including informa‐
13       tion about the codecs used.
14
15       inname Use 'inname' as the source.
16
17       -v, --verbose
18              Be verbose and show each OGG packet. See the section  'VERBOSITY
19              LEVELS' for details.
20
21       -s, --summary
22              Will  print  a short summary for each stream including the total
23              size in bytes, the bitrate, the number of packets/frames and the
24              length  in  seconds.  This  requires the parsing of the complete
25              file.
26
27       -h, --help
28              Show usage information.
29
30       -V, --version
31              Show version information.
32

VERBOSITY LEVELS

34       The -v option can be used to increase  ogminfo's  verbosity  level  and
35       print more information about the current file.
36
37       level 0
38              will print only the streams it finds and their types.
39
40       level 1
41              will  also  print each stream's header and comment packets' con‐
42              tents.  These two modes will not  process  the  whole  file  (as
43              opposed  to  all  other modes) if the comment packets are placed
44              correctly.
45
46       level 2
47              will print a line for each OGG packet it  encounters  containing
48              the stream the packet belongs to, the payload size, the packet's
49              granulepos, the packet's number, its start time,  its  end  time
50              and   several   flags.   The  flags  may  include  'sync_ok'  or
51              'OUT_OF_SYNC' which indicates whether the packet's placement  in
52              the  file  is  correct according to its granulepos.  Other flags
53              are 'IS_SYNCPOINT' or 'EOS'.
54              level 2 and above automatically imply --summary.
55
56       level 3
57              also prints a line whenever a new OGG page was  read  completely
58              along  with  the  page's  exact position in the file it was read
59              from.
60
61       level 4
62              will dump the complete  stream_header  structure  found  in  the
63              header packet for any non-Vorbis stream.
64
65       The levels 3 and 4 are intended for debugging purposes only.
66

NOTES

68       What works:
69
70       *      OGM  with  Vorbis  audio, 'normal' video (like DivX etc.), audio
71              streams (PCM, MP3 etc.), text streams (subtitles).
72
73       What not works:
74
75       *      Headers created by older OggDS (DirectShow) filter versions  are
76              not supported (and probably never will be).
77

AUTHOR

79       ogminfo was written by Moritz Bunkus <moritz@bunkus.org>.
80

SEE ALSO

82       ogmmerge(1), ogmsplit(1), ogmdemux(1), ogmcat(1), dvdxchap(1)
83

WWW

85       The      newest      version     can     always     be     found     at
86       <http://www.bunkus.org/videotools/ogmtools/>
87       ⟨http://www.bunkus.org/videotools/ogmtools/⟩
88
89
90
91ogminfo v1.5                     November 2004                      OGMINFO(1)
Impressum