A Silo host plugin that fulfills Silo content requests (movies and series)
against one or more Sonarr/Radarr instances. It implements the
request_router.v1 capability defined in the Silo plugin SDK, letting Silo
route an approved request to the correct instance (HD vs. 4K, anime overrides,
per-instance root folder / quality profile / tags) and trigger the add + search.
The plugin is stateless: it stores nothing. All credentials and per-connection configuration (service endpoint, API key, root folder, quality profile, tags, default/4K/anime flags, etc.) are supplied by the Silo host on every call.
The plugin declares supports_seasons, so Silo can send it a series request
that names seasons, including a request for the seasons a series in the
library is missing.
- A new series is added with only the requested seasons monitored, and the add-time search covers only them. Seasons Sonarr learns of later stay unmonitored.
- A series Sonarr already has keeps its other seasons as they are. The requested seasons, and every episode in them, are monitored and searched.
- A repeated request changes nothing more, and does not search a season whose aired episodes are all on disk.
- A request counts as complete when the aired, monitored episodes of its seasons are on disk; downloads for other seasons do not affect it.
The connection's Monitor policy applies only to whole-series requests. Radarr ignores seasons.
The plugin declares reports_download_progress and reports how far a
request's downloads are while they sit in the Sonarr or Radarr queue: a phase
(waiting, downloading, paused, stalled, importing, or import blocked), the
size and bytes left, and the latest estimated completion time. It reads the
same queue the plugin already checks for the request's status, so it needs no
settings.
- A season pack counts once, although Sonarr lists it under every episode.
- A season request counts only the downloads for its seasons.
- While any of a request's downloads has no known size yet, the size and bytes left are reported as 0, so Silo shows no percentage rather than an overstated one.
- While any of a request's downloads has failed, no progress is reported for it.
When Sonarr or Radarr reports one of a request's downloads as failed, the plugin reads the service's Redownload Failed setting (Settings > Download Clients > Failed Download Handling) to decide what Silo should do.
- With it on, the default, the service blocklists the release and searches for another, so the request stays in progress, with a message that the download failed and the service is looking for another release.
- With it off, nothing fetches the title again, so the plugin reports that server's part of the request as failed, with the reason. Silo marks the request failed, and an admin can retry it.
- When the setting cannot be read, the plugin treats it as on, so a transient error never fails a request.
The setting is read only while a request has a failed download, so other status checks cost no extra call. A season request looks only at the downloads for its seasons.
Sonarr v5 keeps a metadata language for each series and fetches its titles and descriptions in that language. A Sonarr connection's Metadata language picks the language for the series the plugin adds, and a route can override it.
- Without a choice, a new series gets Sonarr's own preferred metadata language (Settings > Metadata Source). Sonarr v5 would otherwise add it in English.
- The admin form lists Sonarr's preferred language first and fills an empty choice with it.
- If Sonarr's preferred language cannot be read, the add fails and Silo retries it, rather than adding the series in English.
- A series Sonarr already has keeps its language.
- Sonarr v4 has no per-series language: the setting offers no choices there and the plugin sends none.
make buildThis produces a plugin binary. Use make build-all to cross-compile the
release matrix (linux/amd64, linux/arm64, darwin/arm64, freebsd/amd64,
freebsd/arm64) into dist/.
This is an approved community plugin maintained in the
Silo-Community organization. Use
GitHub Issues
for support and bug reports. Security reports should follow
SECURITY.md.
The plugin consumes the published
silo-plugin-sdk; CI rejects
machine-local SDK replacement directives.
Releases are signed with GitHub artifact attestations. CONTRIBUTING.md describes how maintainers cut a release and how to verify a downloaded binary.
Licensed under AGPL-3.0. See LICENSE.