Tools and Advanced

Metadata, the downloader, and one-off maintenance tools.

Metadata

With Save metadata on in a scrape config, results show up under Metadata. You can search, edit, and delete them.

Import

• JSON: paste or upload on the Metadata page; a single object or an array
• NFO folder: under Tools, pick a directory and either skip existing rows or force-update

Fields

Required: number, actor, title, cover.

Uploading a cover only updates the linked image; the original cover field is left as-is.

Transmission

In Service settings, set the RPC URL, username, password, and path mapping:

• Source path — download path inside Transmission (container path)
• Destination path — the same location as seen by Bonita / the host

When enabled, deleting a source file during record cleanup can also remove the matching torrent.

Tools page

Tool	Use
Import metadata	Import from a folder of NFO files
Sync Emby watch history	See Media servers
Sync transfer record paths	After a source-folder change, rewrite prefixes and ExtraInfo
Cleanup files and records	Drop records whose files are gone, and torrents deleted more than 7 days ago. Delete immediately skips the grace period

Proxy

Service settings → Proxy applies to outbound scraping requests. Fill HTTP and HTTPS, enable, then save.

Planned

Push notifications (Telegram, WeChat, …) and AI recommendations are still planned; they are not in the UI yet.

Notes

• Back up /app/backend/data (at least db.sqlite3) before major changes
• FIRST_SUPERUSER_* only applies on the first database create
• YAML wins over environment variables when both are set