# 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-80021-51/install-sdk.html) for your Qualcomm Linux 2.0 RC2.
- Activate SSH on your Qualcomm Linux 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-80021-254/how_to.html#use-ssh).

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-80021-18/samples.html).
- Sign in to the target device using SSH.
- 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-80021-16/enable-audio.html) and [Enable audio with GStreamer](https://docs.qualcomm.com/bundle/publicresource/topics/80-80021-16/enable-audio.html#enable-audio-with-gstreamer).

    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
- To enable camera on the target device, see [Enable camera functionality](https://docs.qualcomm.com/bundle/publicresource/topics/80-80021-150/migrate-features.html#enable-camera-functionality). If you face issues with the camera, see [Camera troubleshooting](https://docs.qualcomm.com/bundle/publicresource/topics/80-80021-17/troubleshooting.html).
- If you cannot locate the qtiqmmfsrc plugin, ensure that the camera server is running and clear the GStreamer cache using the following commands:

ps -ef | grep cam-server
        Copy to clipboard

rm ~/.cache/gstreamer-1.0/registry.aarch64.bin
        Copy to clipboard
- To access the Adreno OpenCL libraries, run the following command on the target device:

export OCL_ICD_FILENAMES=/usr/lib/libOpenCL_adreno.so.1
        Copy to clipboard
- To enable GPU-based ML operations required by QNN, SNPE, and TFLite frameworks run the following command:

ln -sf /usr/lib/libOpenCL.so.1 /usr/lib/libOpenCL.so
        Copy to clipboard
- If you face issues with the display, see [Display troubleshooting](https://docs.qualcomm.com/bundle/publicresource/topics/80-80021-18/debug.html).
- To push media files, models, and labels, create directories on the target device using the following command:

mkdir /etc/media && mkdir /etc/models && mkdir /etc/labels
        Copy to clipboard
- 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]:<target-directory>
        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
- To access the Adreno OpenCL libraries, please run the following command on the target device:

export OCL_ICD_FILENAMES=/usr/lib/libOpenCL_adreno.so.1
        Copy to clipboard
- Flash the device and run the following command to enable GPU‑based ML operations required by QNN, SNPE, and TFLite:

> 
> 
> ln -sf /usr/lib/libOpenCL.so.1.0.0 /usr/lib/libOpenCL.so
>     Copy to clipboard

Last Published: Mar 26, 2026

[Previous Topic
Run Docker image for GStD](https://docs.qualcomm.com/bundle/publicresource/80-80021-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-80021-50/topics/machine-learning-use-cases.md)