0b08f855c5
When both audio and video are enabled, but the primary stream only has either, when that stream ends we want to end the other fallback-only stream as well. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/-/merge_requests/515> |
||
|---|---|---|
| audio | ||
| ci | ||
| generic | ||
| net | ||
| text | ||
| tutorial | ||
| utils | ||
| version-helper | ||
| video | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| Cargo.toml | ||
| cargo_wrapper.py | ||
| deny.toml | ||
| LICENSE-APACHE | ||
| LICENSE-LGPLv2 | ||
| LICENSE-MIT | ||
| Makefile | ||
| meson.build | ||
| meson_options.txt | ||
| README.md | ||
| update-version.sh | ||
gst-plugins-rs 
Repository containing various GStreamer plugins and elements written in the Rust programming language.
The plugins build upon the GStreamer Rust bindings. Check the README.md of that repository also for details about how to set-up your development environment.
Plugins
You will find the following plugins in this repository:
-
generic-
file: A Rust implementation of the standardfilesrcandfilesinkelements -
sodium: Elements to perform encryption and decryption using libsodium. -
threadshare: Some popular threaded elements reimplemented using common thread-sharing infrastructure.
-
-
net -
audio-
audiofx: Plugins to apply audio effects to a stream (such as adding echo/reverb, removing noise or normalization). -
claxon: A FLAC decoder based on the Claxon library. -
csound: A plugin to implement audio effects using the Csound library. -
lewton: A Vorbis decoder based on the lewton library.
-
-
video-
cdg: A parser and renderer for CD+G karaoke data. -
closedcaption: Plugins to deal with several closed caption formats (MCC, SCC, EIA-608/CEA-608 and timed text). -
dav1d: AV1 decoder based on the dav1d library. -
flavors: FLV demuxer based on the flavors library. -
gif: A GIF encoder based on the gif library. -
rav1e: AV1 encoder based on the rav1e library.
-
-
utils-
fallbackswitch: Aggregator element that allows falling back to a different sink pad after a timeout. -
togglerecord: Element to enable starting and stopping multiple streams together.
-
Building
gst-plugins-rs relies on cargo-c to generate shared and static C libraries. It can be installed using:
$ cargo install cargo-c
Then you can easily build and test a specific plugin:
$ cargo cbuild --manifest-path video/cdg/Cargo.toml
$ GST_PLUGIN_PATH=$GST_PLUGIN_PATH:target/debug gst-inspect-1.0 cdgdec
The plugin can also be installed system-wide:
$ cargo cbuild --manifest-path video/cdg/Cargo.toml --prefix=/usr
$ cargo cinstall --manifest-path video/cdg/Cargo.toml --prefix=/usr
This will install the plugin to /usr/lib/gstreamer-1.0.
You can use --libdir to pass a custom lib directory
such as /usr/lib/x86_64-linux-gnu for example.
Note that you can also just use cargo directly to build Rust static libraries
and shared C libraries. cargo-c is mostly useful to build static C libraries
and generate pkg-config files.
LICENSE
gst-plugins-rs and all crates contained in here that are not listed below are licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
gst-plugin-togglerecord is licensed under the Lesser General Public License (LICENSE-LGPLv2) version 2.1 or (at your option) any later version.
gst-plugin-csound is licensed under the Lesser General Public License (LICENSE-LGPLv2) version 2.1 or (at your option) any later version.
GStreamer itself is licensed under the Lesser General Public License version 2.1 or (at your option) any later version: https://www.gnu.org/licenses/lgpl-2.1.html
Contribution
Any kinds of contributions are welcome as a pull request.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in gst-plugins-rs by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.