gst-make

Command line tool for creating gstreamer plugin projects. Heavily based on the tools from gstreamer-plugins-bad.

Getting Started

These tools consists of a collection of shell scripts for generating gstreamer plugin projects, plugins and elements.

git clone https://github.com/ast/gst-make.git
cd gst-make
# to install an editable (development) version:
pip3 install -e .  

Should also be possible to install like a normal python packge but it's not stable yet, so not recommended.

pip3 install gst-make

Using

# create project
cd
gst-make project my_project
cd gst-my-project

# build with meson
meson build
# and ninja
ninja -C build

# add a plugin
cd gst
gst-make plugin myplugin
# add this plugin to meson.build
echo "subdir('myplugin')" >> meson.build

# rebuild with plugin
ninja -C ../build

cd myplugin
# add an element
gst-make element my_element basetransform
# add gstmyelement.c to meson.build and rebuild

# add to gstreamer plugin search path
export GST_PLUGIN_PATH = $HOME/gst-my_project/build/gst/myplugin:$GST_PLUGIN_PATH

Using with Xcode

If you are developing on a mac like me.

# Add the output of this command to "Other Linker Flags"
pkg-config --libs gstreamer-1.0 gobject-2.0 gstreamer-audio-1.0 gstreamer-base-1.0

Using with Visual Studio Code

Prerequisites

You will need:

• python3
• gstreamer
• meson
• ninja

TODO

• The naming of projects and plugins is not optimal.
• Some of the element templates are out of date.
• Probably a lot of other bugs.

Built With

• gstreamer - Best media framework in this galaxy.
• meson - The Meson Build system.
• ninja - Ninja is a small build system with a focus on speed.

Contributing

Feedback and pull-requests are very welcome.

Versioning

Still too early.

Authors

• Albin Stigö - Initial work - ast

License

LGPL

Acknowledgments

• gstreamer team