OpenAVC Community Plugins

Community plugin repository for OpenAVC — the open-source AV room control platform.

Plugins extend OpenAVC with system-wide integrations, control surfaces, sensors, and services that go beyond single-device protocol translation (which is what drivers are for).

_{The Stream Deck plugin in action: physical buttons mapped to room macros, with per-key icons and live state. Click to enlarge.}

Plugin Categories

Category	Directory	Examples
Control Surfaces	control_surfaces/	Elgato Stream Deck, X-Keys, MIDI controllers
Integrations	integrations/	MQTT bridge, Dante DDM, Home Assistant, webhooks
Sensors	sensors/	Occupancy sensors, ambient light, temperature
Utility	utility/	Analytics export, voice control bridges

Installing Plugins

Plugins can be installed directly from the OpenAVC Programmer IDE:

1. Open the Plugins view in the sidebar
2. Click the Browse tab
3. Find the plugin you want and click Install
4. Enable and configure the plugin in the Installed tab

Creating Plugins

See the Creating Plugins guide in the main repository.

For contribution guidelines, see Contributing Plugins.

Using an AI Assistant

If you use an AI coding assistant, point it to AGENTS.md in this repository. It contains the complete Plugin API, manifest format, and examples in a format optimized for LLM agents. Run python validate.py to check the result before submitting.

Validation

Run the validator before submitting a pull request:

python validate.py                               # Validate all plugins
python validate.py integrations/mqtt              # Validate a specific plugin
python validate.py --check-index                  # Also check index.json consistency

License

All plugins in this repository are MIT licensed. See LICENSE for details.