1. Overview[edit | 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 | edit source]
gst-play accepts the following options:
gst-play-1.0 --help
Usage:
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
--instant-uri Enable instantaneous uri changes (only with playbin3)
--shuffle Shuffle playlist
--no-interactive Disable interactive control via the keyboard
--volume Volume
-s, --start-position Start position in seconds.
-a, --accurate-seeks Enable accurate seeking
--playlist Playlist file containing input media files
-i, --instant-rate-changes Use the experimental instant-rate-change flag when changing rate
-q, --quiet Do not print any output (apart from errors)
--use-playbin3 Use playbin3 pipeline (default varies depending on 'USE_PLAYBIN' env variable)
--wait-on-eos Keep showing the last frame on EOS until quit or playlist change command (gapless is ignored)
--no-position Do not print current position of pipeline
The user can control the playback through the host terminal keyboard. Press k to list the available keyboard shortcuts once the content is playing:
gst-play-1.0 /usr/local/demo/media/* # then press k while playing to enter into Interactive mode
Interactive mode - keyboard controls:
space : pause/unpause
q or ESC : quit
> or n : play next
< or b : play previous
? : seek forward
? : seek backward
? : volume up
? : volume down
m : toggle audio mute on/off
+ : increase playback rate
- : decrease playback rate
d : change playback direction
t : enable/disable trick modes
A/a : change to previous/next audio track
V/v : change to previous/next video track
S/s : change to previous/next subtitle track
0 : seek to beginning
k : show keyboard shortcuts
Please read gst-play Ubuntu manual for more details.
3. Examples[edit | edit source]
 Information
|
| Don't have /usr/local/demo/media/ST2297_visionv3.webm ? Follow instructions in this article. |
| Information
|
| To hear audio track, depending on the considered board, an audio headset must be plugged on |
3.1. Basic audio/video playback[edit | edit source]
gst-play-1.0 /usr/local/demo/media/ST2297_visionv3.webm
3.2. Video only playback[edit | 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 | 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 | 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 | 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 | 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 | edit source]
| Information
|
| An internet connection is required, for example by plugging an Ethernet cable on |
gst-play-1.0 https://github.com/STMicroelectronics/meta-st-openstlinux/blob/thud/recipes-samples/demo/demo-launcher/media/ST2297_visionv3.webm?raw=true
3.8. Audio/video playback on HDMI TV[edit | edit source]
| 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 | 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
or
fg <CTRL+C>