Will-Luck/iplayer-arr v1.1.1

on GitHub

Breaking changes

Default PORT changed from 8191 to 62001 to avoid collision with FlareSolverr (which also defaults to 8191).

If your docker-compose.yml or docker run command uses -p 8191:8191, you need one of:

• Update the port mapping to -p 62001:62001 (recommended)
• Set -e PORT=8191 to keep the old port explicitly

No other manual action is required.

What's fixed

• #15 Match of the Day: BBC composite-format subtitles like "2025/26: 22/03/2026" no longer produce malformed triple-dated filenames. Sonarr's Daily-series parser now accepts Match of the Day releases.
• #16 DOWNLOAD_DIR variable: setting DOWNLOAD_DIR via Docker env var now correctly reflects in the web UI Config page, directory listing endpoints, and the SABnzbd compat handler. Files were already downloading to the right place; this was a display bug only.
• #18 Doctor Who duplicate brands: Sonarr searches for shows where BBC has multiple year-suffixed brand titles (classic Doctor Who, 2005-2022 era, Casualty reboots, etc.) now route to the correct brand via year-range disambiguation.
• #19 Port collision: see Breaking changes above.

Known limitation

If BBC's own metadata catalogue mislabels an episode under the wrong brand PID (e.g. a modern Doctor Who episode catalogued under the 1963-1996 brand), iplayer-arr cannot detect the inconsistency and will emit the release with the mislabelled brand name. This is a BBC data quality issue, not an iplayer-arr bug.

Closed as out of scope

• #14 STV Player support: iplayer-arr is intentionally BBC iPlayer-only.

Project governance

• Added DISCLAIMER.md with TV Licence requirement, BBC trademark disclaimer, personal-use restriction
• Added SECURITY.md pointing at GitHub Private Vulnerability Reporting
• Added structured GitHub Issue Forms (bug report + feature request) with all fields optional
• Backfilled the v1.1.0 CHANGELOG entry that was missing

Upgrade notes

Patch release. Other than the Breaking changes section above, no manual action is required. Existing BoltDB stores, persisted settings, and download queues carry over unchanged.

The new SeriesMapping.Year field is backward-compatible: old records without a year deserialise with Year=0 and trigger a one-time Skyhook re-fetch on first use, which writes back the year and warms the cache.

Configuration

No new configuration options introduced in v1.1.1. The v1.1.0 options (IPLAYER_PROBE_CONCURRENCY, IPLAYER_PROBE_TIMEOUT_SEC) are unchanged.

Full changelog

See PR #22 for the full diff.