bob/candyfloss: Python sugar for Gstreamer - candyfloss - Gitea: Git with a cup of tea

Candyfloss is an ergonomic interface to GStreamer. It allows users to build and run pipelines to decode and encode video files, extract video frames to use from python code, map python code over video frames, etc.

Candyfloss requires that gstreamer is installed. Most desktop linux distros have it installed already. If you aren't on linux or don't have it installed check the GStreamer install docs here. In addition to the installation methods mentioned there if you're on macos you can install it with homebrew by running brew install gstreamer.

Candyfloss runs pipelines. They are created by constructing a candyfloss.Pipeline object. Pipelines can be used two ways: either as context managers or as iterators. When used as a context manager, they allow you to construct a pipeline within the context and then the pipeline is executed when the context exits.

When the pipeline is used as an iterator, it allows you to iterate over the frames produced by the pipeline. To construct the pipeline, pass a function to the Pipeline constructor that builds and returns it.

Leave a Comment