Gst-discoverer

Template:ArticleMainWriter Template:ArticleApprovedVersion


1 Overview

gst-discoverer (gst-discoverer-1.0) is a GStreamer command line utility.

This utility can be used to get information on multimedia content such as images, audio/video files.

2 Usage

gst-discoverer accepts the following options:

 gst-discoverer-1.0 --help
gst-discoverer-1.0 --help
Usage:
  gst-discoverer-1.0 [OPTION?] - discover files synchronously with GstDiscoverer

Help Options:
  -h, --help                        Show help options
  --help-all                        Show all help options
  --help-gst                        Show GStreamer Options

Application Options:
  -a, --async                       Run asynchronously
  -t, --timeout=T                   Specify timeout (in seconds, default 10)
  -c, --toc                         Output TOC (chapters and editions)
  -v, --verbose                     Verbose properties

By default a short level of information is given including the container format, the audio and the video codecs:

 gst-discoverer-1.0 big_buck_bunny_480p_VP8_VORBIS_25fps_1900K_short.WebM
Analyzing file:///home/root/big_buck_bunny_480p_VP8_VORBIS_25fps_1900K_short.WebM
Done discovering file:///home/root/big_buck_bunny_480p_VP8_VORBIS_25fps_1900K_short.WebM

Topology:
  container: WebM
    audio: Vorbis
    video: VP8

Properties:
  Duration: 0:00:04.000000000
  Seekable: yes
  Tags: 
      title: big_buck_bunny_480p_surround-fix.avi_041.AVI
      container format: Matroska
      language code: und
      application name: SUPER(C)   
      encoder: Xiph.Org libVorbis I 20070622
      encoder version: 0
      audio codec: Vorbis
      nominal bitrate: 80000
      bitrate: 80000
      video codec: On2 VP8


The -v option gives more details such as the number of audio channels, the audio sample rate, the video width and height or even the pixel aspect ratio:

 gst-discoverer-1.0 -v big_buck_bunny_480p_VP8_VORBIS_25fps_1900K_short.WebM
Analyzing file:///home/root/big_buck_bunny_480p_VP8_VORBIS_25fps_1900K_short.WebM
Done discovering file:///home/root/big_buck_bunny_480p_VP8_VORBIS_25fps_1900K_short.WebM

Topology:
  container: video/webm
    audio: audio/x-vorbis, channels=(int)2, rate=(int)44100, streamheader=(buffer)<>
      Tags:
        title: big_buck_bunny_480p_surround-fix.avi_041.AVI
        container format: Matroska
        language code: und
        application name: SUPER(C)   
        encoder: Xiph.Org libVorbis I 20070622
        encoder version: 0
        audio codec: Vorbis
        nominal bitrate: 80000
        bitrate: 80000
      
      Codec:
        audio/x-vorbis, channels=(int)2, rate=(int)44100, streamheader=(buffer)<>
      Additional info:
        None
      Stream ID: b2ab3c289a804933c863327b88bbe3eac46bb36c16a173328c94e4928c7222ae/002:002
      Language: und
      Channels: 2
      Sample rate: 44100
      Depth: 32
      Bitrate: 80000
      Max bitrate: 0
    video: video/x-vp8, width=(int)854, height=(int)480, pixel-aspect-ratio=(fraction)1/1, framerate=(fraction)0/1
      Tags:
        title: big_buck_bunny_480p_surround-fix.avi_041.AVI
        container format: Matroska
        video codec: On2 VP8
        language code: und
      
      Codec:
        video/x-vp8, width=(int)854, height=(int)480, pixel-aspect-ratio=(fraction)1/1, framerate=(fraction)0/1
      Additional info:
        None
      Stream ID: b2ab3c289a804933c863327b88bbe3eac46bb36c16a173328c94e4928c7222ae/001:001
      Width: 854
      Height: 480
      Depth: 24
      Frame rate: 0/1
      Pixel aspect ratio: 1/1
      Interlaced: false
      Bitrate: 0
      Max bitrate: 0

Properties:
  Duration: 0:00:04.000000000
  Seekable: yes
  Tags: 
      title: big_buck_bunny_480p_surround-fix.avi_041.AVI
      container format: Matroska
      language code: und
      application name: SUPER(C)   
      encoder: Xiph.Org libVorbis I 20070622
      encoder version: 0
      audio codec: Vorbis
      nominal bitrate: 80000
      bitrate: 80000
      video codec: On2 VP8