Skip to content

Install & manage plugins

Layout

text
storage/plugins/{source|asr|tts|schedule}/<dir>/
  plugin.json
  index.js   # or entry from manifest

storage/plugins/** is local (not committed by default).

Install

bash
mkdir -p storage/plugins/source
cp -R /path/to/plugin storage/plugins/source/my-plugin

Or upload zip under Settings → Plugins (when available).

Rescan

  • UI: Rescan
  • API: POST /api/{source|asr|tts|schedule}-plugins/rescan

Toggle & config (Source example)

ActionAPI
ListGET /api/source-plugins
EnablePATCH /api/source-plugins/:id {"enabled":true}
Reset enablePOST /api/source-plugins/:id/reset
Save configPUT /api/source-plugins/:id/config {"config":{...}}
Clear configPOST /api/source-plugins/:id/config/reset

Swap prefix for asr / tts / schedule.

Risk

riskLevel: "high" → forced default off.