Last edited 2 years ago


Applicable for STM32MP13x lines, STM32MP15x lines

1. Overview[edit source]

gst-play (gst-play-1.0) is a GStreamer command line utility available with GStreamer-1.X.

This utility plays multimedia content using the Playbin element as a basic player. It takes as an input either individual files, URLs or a whole directories (in this case it will recurse into sub-directories as well).

2. Usage[edit source]

gst-play accepts the following options:

 gst-play-1.0 --help
  gst-play-1.0 [OPTION?] FILE1|URI1 [FILE2|URI2] [FILE3|URI3] ...

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

Application Options:
  -v, --verbose                     Output status information and property notifications
  --flags                           Control playback behaviour setting playbin 'flags' property
  --version                         Print version information and exit
  --videosink                       Video sink to use (default is autovideosink)
  --audiosink                       Audio sink to use (default is autoaudiosink)
  --gapless                         Enable gapless playback
  --shuffle                         Shuffle playlist
  --no-interactive                  Disable interactive control via the keyboard
  --volume                          Volume
  --playlist                        Playlist file containing input media files
  -q, --quiet                       Do not print any output (apart from errors)

The user can control the playback through the host terminal keyboard. Press k to list the available keyboard shortcuts once the content is playing:

       <space>   Pause/Resume playback

       <up/down arrows>
               Volume up/down

       <left/right arrows>
               Seek back/forward

       +/-     Increase/decrease playback rate

       d       Reverse playback direction

       t       Cycle through trick modes

       a       Switch audio track

       s       Switch subtitle track

       v       Switch video track

       >       Skip to next item in playlist

       <       Go back to previous item in playlist

       q, ESC  Quit

Information provided by gst-play Ubuntu manual

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-play-1.0 ..."
 su -l "weston" -c "pacmd ..."

3. Examples[edit source]

Info white.png Information
Don't have /usr/local/demo/media/ST2297_visionv3.webm ? Follow instructions in this article.
Info white.png Information
To hear audio track, depending on the considered board, an audio headset must be plugged on

3.1. Basic audio/video playback[edit source]

 gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm

3.2. Video only playback[edit source]

 gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm --audiosink=fakesink

Audio rendering is disabled, but audio decoding continues.

3.3. Playlist playback[edit source]

 gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm /usr/local/demo/media/ST2297_visionv3.webm /usr/local/demo/media/ST2297_visionv3.webm /usr/local/demo/media/ST2297_visionv3.webm

Press ">" key to play the next file, "<" key to play the previous one.

3.4. Loop or repeat the same video[edit source]

This option is not currently available within gst-play but here are some alternatives:

  • Playlist with the same video over and over. In the example below, the same video file is played 3 times. The video file can be added as many times as needed:
 gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm /usr/local/demo/media/ST2297_visionv3.webm  /usr/local/demo/media/ST2297_visionv3.webm
  • For loop (here 1000 times):
 for i in `seq 1 1000`;do gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm; done

3.5. Seek while playing[edit source]

 gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm /usr/local/demo/media/ST2297_visionv3.webm /usr/local/demo/media/ST2297_visionv3.webm /usr/local/demo/media/ST2297_visionv3.webm

Press "right arrow key" to seek forward, "left arrow key" to seek backward.

3.6. Change playback speed[edit source]

 gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm

Press "+" key to increase rate and "-" key to decreased it.

3.7. HTTP streaming[edit source]

Info white.png Information
An internet connection is required, for example by plugging an Ethernet cable on


3.8. Audio/video playback on HDMI TV[edit source]

Info white.png Information
Plug first HDMI TV cable as described in How to display on HDMI article

Switch audio output on HDMI:

 pacmd set-card-profile 0 output:hdmi-stereo

Than play the video:

 gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm

3.9. Audio/video playback in background[edit source]

Option --no-interactive must be set in order to be able to play in background:

 gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm --no-interactive &
[1] 14998
root@stm32mp1:~# Now playing /av_h264_main_640x480_30fps_1000kbps_aac-lc_192kbps.mp4

Then to stop playback:

 killall gst-play-1.0