Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
OGMINFO(1)			  User Commands 		      OGMINFO(1)

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 LEV-
	    ELS' 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  gran-
	    ulepos,  the  packet's number, its start time, its end time and sev-
	    eral flags. The flags may include 'sync_ok' or  'OUT_OF_SYNC'  which
	    indicates  whether the packet's placement in the file is correct ac-
	    cording 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/>

ogminfo v1.5			  November 2004 		      OGMINFO(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ogminfo&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help