Last edited one year ago

Gst-discoverer

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Applicable for STM32MP13x lines, STM32MP15x lines

1 Overview[edit source]

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 source]

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 ..."