# GStreamer command-line use cases

GStreamer provides command-line tools such as [gst-launch-1.0](https://gstreamer.freedesktop.org/documentation/tools/gst-launch.html) tool to help you run the AI/ML and multimedia use cases.

Prerequisites

- [Get started with the Qualcomm IM SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70029-51/install-sdk.html) for your Qualcomm Linux 1.8 or Ubuntu Server.
- Activate SSH on your Qualcomm Linux or Ubuntu to sign in with SSH and connect to the target device. For instructions see:

    - [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70029-254/how_to.html#use-ssh) for Qualcomm Linux
    - [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-90441-1/Use_Ubuntu_on_RB3_Gen2_3.html#sign-in-to-the-rb3-gen-2-console-using-ssh) for Ubuntu Server

Note

If SSH is already set up and Wi-Fi is connected, skip this step.
- Use the HDMI port to connect the display to the device. For instructions, see [Set up HDMI display](https://docs.qualcomm.com/bundle/publicresource/topics/80-70029-18/samples.html).
- Sign in to the target device using SSH.
- In the terminal of the target device, run the following commands from the SSH shell of the target device to activate the display on the host computer:

    - For Linux:

export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1
            Copy to clipboard
    - For Ubuntu Server:

export XDG_RUNTIME_DIR=/run/user/$(id -u ubuntu)/ && export WAYLAND_DISPLAY=wayland-1
            Copy to clipboard
- Connect the speaker to activate the audio on the target device. For instructions, see [Set up audio hardware](https://docs.qualcomm.com/bundle/publicresource/topics/80-70029-16/enable-audio.html).

    If you face issues in recording the audio, run the following command in the terminal of the target device:

pactl set-default-source pal_source_speaker_mic
        Copy to clipboard
- If you face issues with the camera or display, see [Camera troubleshooting](https://docs.qualcomm.com/bundle/publicresource/topics/80-70029-17/troubleshooting.html) and [Display troubleshooting](https://docs.qualcomm.com/bundle/publicresource/topics/80-70029-18/debug.html).
- In the terminal of your Linux host computer, run the following command to push the files on the target device:

scp -r <file_name> root@[DEVICE IP-ADDR]:/opt
        Copy to clipboard
- GBM errors are non-fatal. However, to avoid these errors, use the following commands:

mkdir -p /var/cache/display
        echo 0 > /var/cache/display/gbm_dbg_cfg.txt
        Copy to clipboard
- For Dragonwing IQ-9075 and Dragonwing IQ-8275, set the fullscreen property to true for the Waylandsink plugin:

fullscreen=true
        Copy to clipboard

- [Run machine learning use cases](https://docs.qualcomm.com/doc/80-70029-50/topic/machine-learning-use-cases.html)
LiteRT, Qualcomm Neural Processing SDK runtime, and open neural network exchange (ONNX) models are used for inference in the machine learning use cases.
- [Run multimedia use cases](https://docs.qualcomm.com/doc/80-70029-50/topic/multimedia-use-cases.html)
The multimedia use cases show various multimedia scenarios using the GStreamer pipelines.

Last Published: Apr 02, 2026

[Previous Topic
Run Docker image for GStD](https://docs.qualcomm.com/bundle/publicresource/80-70029-50/topics/container-use-cases-for-video-encode-and-ai-pipelines.md) [Next Topic
Run machine learning use cases](https://docs.qualcomm.com/bundle/publicresource/80-70029-50/topics/machine-learning-use-cases.md)