Gst-discoverer

Applicable for STM32MP13x lines, STM32MP15x lines

1 Overview[edit]

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[edit]

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 /usr/local/demo/media/ST2297_visionv3.webm
Analyzing file:///usr/local/demo/media/ST2297_visionv3.webm
Done discovering file:///usr/local/demo/media/ST2297_visionv3.webm
 
Topology:
  container: WebM
    audio: Vorbis
    video: VP8

Properties:
  Duration: 0:04:02.413000000
  Seekable: yes
  Live: no
  Tags: 
      container format: Matroska
      language code: en
      application name: Lavc56.60.100
      encoder: Xiph.Org libVorbis I 20150105 (????)
      encoder version: 0
      audio codec: Vorbis
      nominal bitrate: 112000
      bitrate: 112000
      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 /usr/local/demo/media/ST2297_visionv3.webm
Analyzing file:///usr/local/demo/media/ST2297_visionv3.webm
Done discovering file:///usr/local/demo/media/ST2297_visionv3.webm

Topology:
  container: video/webm
    audio: audio/x-vorbis, channels=(int)2, rate=(int)48000, streamheader=(buffer)< 01766f7262697[...]
      Tags:
        container format: Matroska
        language code: en
        application name: Lavc56.60.100
        encoder: Xiph.Org libVorbis I 20150105 (????)
        encoder version: 0
        audio codec: Vorbis
        nominal bitrate: 112000
        bitrate: 112000
     
      Codec:
        audio/x-vorbis, channels=(int)2, rate=(int)48000, streamheader=(buffer)< 01766f72 [...]
    Additional info:
        None
      Stream ID: 18eb4f2d90d91d79f9bf3f9b9e41e785ee2cc1396d37b5ad127838437f6a3847/002:002
      Language: en
      Channels: 2 (front-left, front-right)
      Sample rate: 48000
      Depth: 32
      Bitrate: 112000
      Max bitrate: 0
    video: video/x-vp8, width=(int)640, height=(int)360, pixel-aspect-ratio=(fraction)1/1, framerate=(fraction)25/1
      Tags:
        container format: Matroska
        video codec: On2 VP8
        language code: en
     
      Codec:
        video/x-vp8, width=(int)640, height=(int)360, pixel-aspect-ratio=(fraction)1/1, framerate=(fraction)25/1
      Additional info:
        None
      Stream ID: 18eb4f2d90d91d79f9bf3f9b9e41e785ee2cc1396d37b5ad127838437f6a3847/001:001
      Width: 640
      Height: 360
      Depth: 24
      Frame rate: 25/1
      Pixel aspect ratio: 1/1
      Interlaced: false
      Bitrate: 0
      Max bitrate: 0

Properties:
  Duration: 0:04:02.413000000
  Seekable: yes
  Live: no
  Tags: 
      container format: Matroska
      video codec: On2 VP8
      language code: en
      application name: Lavc56.60.100
      encoder: Xiph.Org libVorbis I 20150105 (????)
      encoder version: 0
      audio codec: Vorbis
      nominal bitrate: 112000
      bitrate: 112000
Warning white.png Warning
If Weston is configured with a "weston" user instead of a "root" user, please use the following commands:
 su -l "weston" -c "your_weston_command"
 su -l "weston" -c "gst-discoverer-1.0 ..."