Developer Guide

  • 2022.3
  • 10/25/2022
  • Public Content

GStreamer* Video Pipeline

Run a GStreamer* video pipeline using GStreamer* plugins, and display a video file in a Docker* container window.

Run the Sample Application

  1. Check if your installation has the amr-gstreamer Docker* image.
    docker images |grep amr-gstreamer #if you have it installed, the result is: amr-gstreamer
    If the image is not installed, continuing with these steps
    triggers a build that takes longer than an hour
    (sometimes, a lot longer depending on the system resources and internet connection).
  2. If the image is not installed, Intel recommends installing the Robot Base Kit or Robot Complete Kit with the Get Started Guide for Robots.
  3. Go to the
    cd <edge_insights_for_amr_path>/Edge_Insights_for_Autonomous_Mobile_Robots_*/AMR_containers
  4. Prepare the environment setup:
    source ./01_docker_sdk_env/docker_compose/common/docker_compose.source export CONTAINER_BASE_PATH=`pwd` export ROS_DOMAIN_ID=31
  5. Run an automated yml file that opens a GStreamer* sample application inside the EI for AMR Docker* container.
    CHOOSE_USER=eiforamr docker-compose -f 01_docker_sdk_env/docker_compose/05_tutorials/gstreamer_video.tutorial.yml up
    Expected output: The video file is displayed in a window in the container.
  6. To close this, do one of the following:
    • Type
      in the terminal where you did the up command.
    • Run this command in another terminal:
    CHOOSE_USER=eiforamr docker-compose -f 01_docker_sdk_env/docker_compose/05_tutorials/gstreamer_video.tutorial.yml down
  7. For an explanation of what happened, open the yml file:
    • The first 23 lines are from the EI for AMR infrastructure.
    • Line 26 clones some sample videos.
    • Line 27 play the video using GStreamer*.
  8. To use your own video, use the same yml file but update line 27 to target your own file.
    For example, copy the file:
    cp test.mp4 ${CONTAINER_BASE_PATH}/01_docker_sdk_env/docker_compose/05_tutorials/test.mp4
    And update line 27 to:
    gst-launch-1.0 playbin uri=file://${CONTAINER_BASE_PATH}/01_docker_sdk_env/docker_compose/05_tutorials/test.mp4


If running the yml file gets stuck at downloading:
gedit 01_docker_sdk_env/docker_compose/05_tutorials/gstreamer_video.tutorial.yml # In the same way open any other yml you want to test behind a proxy.
Add the following lines after “echo “
Run gst-launch with video sample from the Docker container
”, replacing
with your actual environment http_proxy.
export http_proxy="http://<http_proxy>:port" export https_proxy="http://<https_proxy>:port"
Check your system date and time:
If the date is incorrect, contact your local support team for help setting the correct date and time.
For general robot issues, go to: Troubleshooting for Robot Tutorials.

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at