https://github.com/gpac/gst-gpac-plugin
Use a gpac filter session within GStreamer
https://github.com/gpac/gst-gpac-plugin
gstreamer multimedia
Last synced: about 1 year ago
JSON representation
Use a gpac filter session within GStreamer
- Host: GitHub
- URL: https://github.com/gpac/gst-gpac-plugin
- Owner: gpac
- License: agpl-3.0
- Created: 2025-01-27T21:21:53.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-26T22:37:40.000Z (about 1 year ago)
- Last Synced: 2025-07-27T02:17:23.435Z (about 1 year ago)
- Topics: gstreamer, multimedia
- Language: C
- Homepage:
- Size: 274 KB
- Stars: 3
- Watchers: 5
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# GStreamer GPAC Plugin
This plugin provides elements that interface with the GPAC library, bringing advanced multimedia processing capabilities of GPAC to GStreamer pipelines.
This plugin is dual-licensed AGPL or commercial. Contact [Motion Spell](https://www.motionspell.com/contact/) for more information.
## Elements
### `gpactf` element
The `gpactf` element is an aggregator element that runs the incoming buffers through the GPAC Filter Session. The element provides a `graph` option for you to specify the GPAC filter graph to use. Make sure to read the [Filters Concepts](https://wiki.gpac.io/Filters/filters_general/) page on the GPAC wiki to understand how to create filter graphs.
> [!NOTE]
> You can assume that source and sink filters are already present in the graph. You will be populating the graph in between these two filters.
### `gpacmp4mx` element
Functions similarly to `gpactf` element, you can assume it's equivalent to `gpactf graph=mp4mx`. Only difference is on how the element is configured. You can use the element options to set the `mp4mx` configuration.
#### Aliases
- **`gpaccmafmux`**: Equivalent to `gpacmp4mx` but enables `store=frag` and `cmaf=cmf2` options.
### `gpacsink` element
This is again a convenience element that functions similarly to `gpactf` element, except that it's contained under a `GstBin` and connected to `fakesink`. This element is useful for testing purposes.
### Other noteworthy elements
- **`gpachlssink`**: This element is a sink for HLS streams. It can be used to create HLS playlists and segments.
- **`gpachtsmx`**: This element is a sink for TS streams. It can be used to create MPEG-TS segments.
## Installation
The plugin requires GPAC to be installed on your system. You can install GPAC by following the instructions on the [GPAC wiki](https://wiki.gpac.io/Build/Build-Introduction/). There's no specific required version of GPAC, but we recommend building from source to ensure compatibility. You can also find the latest build artifacts for the plugin [here](https://github.com/gpac/gst-gpac-plugin/releases/latest). Be sure to rename the library files to `libgpac_plugin.{so,dylib}` and place them in the appropriate location.
## Build
The plugin requires GPAC to be installed on your system. You can build GPAC from source by following the instructions on the [GPAC wiki](https://wiki.gpac.io/Build/Build-Introduction/). The plugin also requires GStreamer headers and libraries to be installed on your system. You can follow the instructions on the [GStreamer website](https://gstreamer.freedesktop.org/documentation/installing/index.html?gi-language=c) to install GStreamer.
To build the plugin, follow these steps:
```bash
cmake -S . -B build
cmake --build build
```
## Usage
Refer to the launch tasks in [`.vscode/launch.json`](.vscode/launch.json) for examples of how to use the plugin. Each launch configuration builds the plugin and runs a GStreamer pipeline that utilizes it. After the session is completed, the pipeline graphs are dumped to `graph` folder.
## Contributing
We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute to this project.
## License
This project is dual-licensed AGPL or commercial. Contact [Motion Spell](https://www.motionspell.com/contact/) for more information.