Skip to content

docs: describe how Sportarr shows are matched and where their artwork comes from - #164

Draft
Sportarr wants to merge 2 commits into
Maintainerr:mainfrom
Sportarr:docs-sportarr-native-ids
Draft

docs: describe how Sportarr shows are matched and where their artwork comes from#164
Sportarr wants to merge 2 commits into
Maintainerr:mainfrom
Sportarr:docs-sportarr-native-ids

Conversation

@Sportarr

Copy link
Copy Markdown

Draft until Maintainerr/Maintainerr#3604 and Maintainerr/Maintainerr#3606 land, since it describes what those two change.

Adds one paragraph to the Sportarr section of the configuration page: how a show is matched to its league (the sportarr id the Sportarr media server agents stamp, with the tvdb alias as the fallback for a library that has not been refreshed), and that posters, backdrops and descriptions for those shows come from sportarr.net without an API key.

@enoch85

enoch85 commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Suggested change

## Sportarr

Sportarr runs alongside Sonarr and Radarr, and all three can be configured at once. Sportarr's
configuration is required to use its parameters in rules and manage sports leagues, seasons, and
events. Maintainerr requires Sportarr 4.0.1022 or later.

Maintainerr matches a show to its league through the `sportarr` id the Sportarr media server agents
stamp on it, for example `lg-000278`. A library that has not been refreshed since those agents
started stamping it carries only the numeric alias they write into the tvdb namespace, and
Maintainerr resolves the league from that instead.

@Sportarr
Sportarr force-pushed the docs-sportarr-native-ids branch from 76ae068 to 545b755 Compare August 26, 2026 19:59
The paragraph described the old behaviour, where the sportarr.net read
was on unless SPORTARR_NET was set to off. It is opt-in now, and nothing
is requested from sportarr.net unless the variable is set to on.

Also names the Refresh Metadata action, which moved into the Sportarr
server dialog.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants