maubot-media

Maubot plugin: Matrix companion to the homelab media stack — Seerr, Emby, Sonarr, Radarr, NZBGet, qBittorrent.

This wiki is intentionally sparse — the canonical operational doc lives in the homelab wiki:

📖 clustered-fucks wiki → Media Bot

That page covers commands, webhooks, daily digest, deploy flow, secrets, known gaps, and architecture.

Repo conventions

Plugin ID: com.3ddbrewery.media
Bot user: @mediabot:fails.me
Local working copy: ~/maubot-media/ on the control server
Build: zip -rq com.3ddbrewery.media-vX.Y.Z.mbp maubot.yaml base-config.yaml media_bot/ README.md LICENSE -x '*/__pycache__/*'
Hot reload: upload via maubot UI or POST /v1/plugins/upload?allow_override=true. Container is not restarted.

Manifest must include

config: true
extra_files: [base-config.yaml]
database: true        # required for !media subscribe + digest state
webapp: true          # required for the @web.post(...) webhook routes

Forgetting webapp: true → routes return 404. Forgetting database: true → self.database is None.