Manage plugins

Norsk Studio’s node catalog is extended through plugins. norsk-ctl keeps track of which plugins are enabled and tells each Studio container which ones to load at launch time.

Plugin catalog

Name	Category	Default	Description
norsk-studio-built-ins	builtin	locked (always on)	Core built-in nodes — cannot be disabled
norsk-studio-alpha	bundled	disabled	Alpha / experimental nodes. May change without notice
norsk-studio-beta	bundled	enabled	Beta nodes approaching stable
norsk-studio-aws	third-party	disabled	AWS S3 / MediaLive integration. Requires AWS credentials

The canonical list lives in backend/src/lib/plugins.ts:PLUGIN_CATALOG — that’s the source of truth if this table ever drifts.

Categories

• builtin — core nodes shipped with the Studio image. Always loaded, locked in the UI, CLI returns an error if you try to disable one.
• bundled — additional node packages shipped alongside norsk-ctl, tested against the same Studio version. Freely enabled or disabled.
• third-party — external packages not maintained by Norsk Video. May require extra credentials; not covered by Norsk Video support.

How plugins are applied

On launch (or restart) of a Studio container, norsk-ctl reads the enabled list from its state database (~/.norsk-ctl/norsk-ctl.db) and injects a comma-separated value into the container’s environment:

NORSK_STUDIO_PLUGINS=norsk-studio-built-ins,norsk-studio-beta

Studio loads the named plugins at startup.

Restart required

Plugin changes are saved immediately, but only take effect on the next instance launch or restart. Toggling a plugin while an instance is running has no effect on that running instance — run norsk-ctl instance restart <id> to apply.

Via the CLI

# List all plugins and their state
norsk-ctl plugin list

# Enable
norsk-ctl plugin enable norsk-studio-alpha
norsk-ctl plugin enable norsk-studio-aws

# Disable
norsk-ctl plugin disable norsk-studio-beta

# Apply: restart the instance
norsk-ctl instance restart <instance-id>

Example plugin list output:

NAME                      CATEGORY    STATE
norsk-studio-built-ins    builtin     locked
norsk-studio-alpha        bundled     enabled
norsk-studio-beta         bundled     disabled
norsk-studio-aws          thirdparty  enabled

Disabling a locked plugin (the built-ins) returns an error — they cannot be turned off.

Via the web UI

The Plugins page shows all plugins as toggles grouped by category. Flip a toggle to change state — norsk-ctl persists the change immediately. Then restart the relevant instance from the Instance Detail page so Studio picks up the new plugin list.

Locked plugins render with their toggles greyed out.

Where plugin state lives

In the SQLite state database at ~/.norsk-ctl/norsk-ctl.db, under a plugins key. Do not edit by hand — use the CLI or UI. See Configuration for the wider picture of what norsk-ctl stores there.