Skip to content

Document plugin video configuration fields - #239

Open
gabek wants to merge 2 commits into
owncast-docusaurusfrom
gek/plugin-video-config-parity
Open

Document plugin video configuration fields#239
gabek wants to merge 2 commits into
owncast-docusaurusfrom
gek/plugin-video-config-parity

Conversation

@gabek

@gabek gabek commented Aug 5, 2026

Copy link
Copy Markdown
Member

Expand the plugin API reference to cover the complete video configuration contract.

  • List autoplay modes and supported video codec names.
  • Document every output variant field, including CPU usage level.
  • Clarify that plugin updates do not expose or replace existing audio settings.
  • Update JavaScript and Python partial-write examples.

The English production site build passed, and the generated plugin API page contains the new fields and values.

Related to owncast/owncast#5114 and owncast/plugin-sdk#14.

Copilot AI lite review requested due to automatic review settings August 5, 2026 22:28

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR expands the plugin API reference documentation to fully describe Owncast’s video configuration surface (VideoConfig) so plugin authors can read and partially update the same fields exposed in the admin UI.

Changes:

  • Documented the full VideoConfig contract, including supported autoplay modes and video codec names.
  • Documented the complete StreamVariant shape, replacing per-variant audio bitrate with cpuUsageLevel.
  • Updated JavaScript and Python videoConfig.write partial-update examples and clarified that audio settings are preserved and not plugin-addressable.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants