Auteur

The current scope of this project is that of a basic live node compositor, with a service exposing a JSON API for creating, connecting, inspecting, scheduling and removing GStreamer processing nodes (sources, mixers and destinations as of writing).

It can be used for things like linear video feeds that allow hotswapping inputs/sources and compositing them based on a schedule (cue time and duration). As well as fail-over to backup content when a source is unavailable.

An example client running commands one at a time is provided for exploring that API.

Read the documentation

Environment

This project depends on:

• Rust (stable channel)

• GStreamer (master as of writing)

• gst-plugins-rs (master as of writing)

The most convenient testing platform for this PoC is a Linux machine, https://gitlab.freedesktop.org/gstreamer/gst-build, enter a devenv then build https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/ and export GST_PLUGIN_PATH:

export GST_PLUGIN_PATH=$GST_PLUGIN_PATH:/path/to/gst-plugins-rs/target/debug

A few GStreamer plugins are needed, make sure to install the dependencies for all of those before building gst-build:

git grep "make_element(" | cut -d '"' -f 2 | sort -u

Building

cargo build

Running

Run the service:

AUTEUR_LOG=debug cargo run --bin auteur

Explore and test the API with the client:

cargo run --bin auteur-controller -- help

You can also find the API definition in common/src/controller.rs.

In addition, a simple wrapper script around the controller can be found in scripts/node_schedule.py, alongside other scripts that leverage it to demonstrate other features (eg scripts/crossfade.py)

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

License

All code in this repository is licensed under the MIT license.