GstPipelineStudio: Draw your own GStreamer pipeline ...

Important

Until version 1.0, this software should be considered as unstable. The settings moreover the graph file format might change over the development phase.

Description

GstPipelineStudio aims to provide a graphical user interface to the GStreamer framework. From a first step in the framework with a simple pipeline to a complex pipeline debugging, the tool provides a friendly interface to add elements to a pipeline and debug it.

Setup

Install the Rust toolchain via rustup

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Check https://rustup.rs for alternative installation options.

Ubuntu/Debian/etc

apt install python3-pip ninja-build pkg-config
pip3 install --user meson
apt install libgtk-4-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev

Fedora/RedHat/SuSE/etc

dnf install python3-pip ninja-build pkgconfig
pip3 install meson
dnf install gtk4-devel gstreamer1-devel gstreamer1-plugins-base-devel python3-pip ninja-build pkgconfig

MacOS

brew install gtk4
brew install gstreamer gst-plugins-base gst-plugins-bad

Getting started

$ meson setup builddir -Dbuildtype=release
$ ninja -C builddir
$ ./builddir/target/release/gst-pipeline-studio

Flatpak

The application is also available on Flathub.

License

GstPipelineStudio is distributed under the terms of the GPL3 license. See LICENSE for more information.

Credits

GstPipelineStudio wouldn't exist without free and open-source software such as GLib, GStreamer, GTK and many more.

This project has been also possible thanks to amazing projects such as:

• pipeviz
• helvum

Contributing

Every contribution is greatly appreciated! You will just need a gitlib account. Fork this repo, clone your fork, create a feature branch, commit, push and submit a merge request.

Development Setup

Install pre-commit hooks to validate your commits locally:

pip3 install pre-commit
pre-commit install --hook-type commit-msg

Or using meson:

meson setup builddir
ninja -C builddir install-git-hooks

This will validate commit messages following GStreamer guidelines:

• Format: module: short description (e.g., settings: fix crash on startup)
• No WIP, fixup!, or squash! commits in merge requests

Submit any suggestions, questions or bugs to the Issue Tracker.

Troubleshooting

Interface is not clean: rm ~/.config/dev.mooday.GstPipelineStudio/settings.toml