Repository navigation
Releases: shedman214/preludarr
Release list
Preludarr 1.14.1
Preludarr 1.14.1
This release makes it easier to enable YouTube links and custom audio uploads, with clear guidance when manual installs are off.
✨ Highlights
- Turn manual installs on or off in Settings without restarting Preludarr.
- Disabled tools explain how to enable them before you try to download or upload audio.
➕ Added
- Manual-install setting. Enable or disable YouTube links and custom audio uploads from YouTube’s Configure panel under Settings → Download Clients. The saved choice applies immediately and overrides the Docker default; review and confirmation remain required.
🔧 Fixed
- Disabled manual installs. The Theme Browser shows setup guidance and a settings link instead of upload and YouTube download forms when manual installs are off.
Docker image: ghcr.io/shedman214/preludarr:1.14.1 (also :1.14, :latest and :beta) · Unraid: update when it shows “update ready” · Full changelog
Preludarr 1.14.0
Preludarr 1.14.0
This release simplifies poster setup, fixes slow Radarr connection checks and improves theme readability.
✨ Highlights
- New installs automatically process missing posters after folders and a provider key are configured.
- Radarr connection checks allow more time for slow root-folder responses.
- Clearer text across appearance themes and more useful troubleshooting logs.
➕ Added
- Automatic posters for new installs. Missing library posters enter the existing background queue once roots are scanned and a TMDB or TVDB key is available. Processing respects pause controls, retry cooldowns and rate limits, retains cached posters and does not install theme music.
- Trace logging. Settings → General → Logging includes Trace, which adds HTTP method, response status and elapsed time to the log without including URLs, headers or request bodies in the new timing entries. The setting applies immediately and survives restarts.
🔄 Changed
- Unraid installation instructions. Community Applications installation is now the primary path, with manual template installation retained as an alternative.
- Background poster defaults. The Unraid template uses
auto: enabled for new installs and unchanged for existing installs. Explicittrueandfalsechoices still take priority.
🔧 Fixed
- Poster retry feedback. Missing or linked folders now produce a clear explanation instead of a generic HTTP 400 message. Retry still rejects unavailable paths without creating replacement folders or consuming the retry quota.
- Theme readability. Poster confirmation and picker buttons, Library view controls, Settings buttons and links retain readable text across appearance themes, including light and OLED modes. Live preview text follows the preview palette instead of inheriting conflicting colors from the saved theme.
- Slow Radarr root-folder checks. The root-folder request now allows 30 seconds instead of 12, so a measured 15-second response can complete without reporting a connection failure. The status check retains its shorter timeout.
- Direct Sonarr/Radarr connections. Connection requests no longer inherit outbound proxy settings. Timeout guidance now explains that the server must be reachable from the Preludarr container.
- Poster recovery status. The dashboard reports when background processing is off instead of showing it as running.
Docker image: ghcr.io/shedman214/preludarr:1.14.0 (also :1.14, :latest and :beta) · Unraid: update when it shows “update ready” · Full changelog
Preludarr 1.13.0
This release adds Language & Region settings and updates the YouTube downloader.
✨ Highlights
- Seven additional interface languages.
- A compact Language & Region settings tab with an easy way back to English.
- Updated YouTube downloader.
➕ Added
- Interface languages. Spanish, French, German, Portuguese (Brazil), Japanese, Simplified Chinese and Arabic for navigation and common controls. Untranslated text falls back to English.
- Arabic layout. Right-to-left navigation and forms.
- Date and time preferences. Short and long date formats, 12/24-hour time, display time zones and Today/Yesterday labels.
- English recovery. “Switch back to English” stays beside the language dropdown and preserves your date/time preferences.
🔄 Changed
- Displayed dates. Activity, backups and other supported displays follow your preferences. Stored timestamps and scheduled jobs remain unchanged.
- YouTube downloader. Updated yt-dlp from 2026.8.19 to 2026.10.26. Dependencies remain pinned and verified against published file hashes.
🔧 Fixed
- Stable-release documentation. The feature list, limitations and security support policy now correctly describe Preludarr as stable.
- Dependency maintenance. Fixed the dependency lock generator’s line continuations so it produces a valid requirements file.
Docker image: ghcr.io/shedman214/preludarr:1.13.0 (also :latest) · Unraid: update after image publication finishes and “update ready” appears · Full changelog
Preludarr 1.12.3
This release makes it easier to verify anime theme matches before choosing a theme.
✨ Highlights
- Open a candidate’s AnimeThemes page directly from the Theme Browser.
➕ Added
- AnimeThemes verification links. “View on AnimeThemes” appears beside search results, matched entries and manual or low-confidence suggestions. It opens the candidate’s anime page in a new tab.
🔄 Changed
- Search result details. Results show the provider’s year when available and keep their existing Preview OP/ED links.
- Following an AnimeThemes link never remembers a match or installs music.
Docker image: ghcr.io/shedman214/preludarr:1.12.3 (also :latest) · Unraid: update after image publication finishes and “update ready” appears · Full changelog
Preludarr 1.12.2
- Activity on the Dashboard. The latest events now also show on the Dashboard, with the same search and event filter as System → Activity (which stays as it is) and a Show 10 / 25 / 50 / 100 / 250 per page choice that is remembered.
- Library remembers your filters. A new install starts at All statuses / All posters. When you pick a Theme status or Poster status and press Search, the Library keeps them until you change them again (or press Clear). Links that open the Library with a filter for one view, such as the sidebar's Missing Themes, don't change what is remembered.
Update: ghcr.io/shedman214/preludarr:latest (Unraid: click Update when it shows "update ready"). Full changelog: CHANGELOG.md
Preludarr 1.12.1
Bug fix release.
- Sonarr/Radarr on Windows: path mappings now accept Windows paths, such as
G:\ => /mnt/media,G:\TV => /media/tv_showsor\\server\share => /media/tv_shows. They match the way Windows does (upper or lower case,\or/), the most specific mapping wins, and suggested mappings work for Windows paths too. Thanks @SterlynKong for reporting it! (#1)
Update: ghcr.io/shedman214/preludarr:latest (Unraid: click Update when it shows "update ready"). Full changelog: CHANGELOG.md
Preludarr 1.12.0
Preludarr 1.12.0 — first stable release. Theme songs for your media library: Preludarr finds the opening or theme song of each anime, TV show and movie and saves it as theme.mp3 in the title's folder, where Plex, Jellyfin and Emby play it.
Install
ghcr.io/shedman214/preludarr:latest
Docker Compose, docker run and Unraid instructions are in the README. On first start, the container log shows a one-time setup code for creating your account.
Coming from 1.12.0-beta.1? Nothing to do: the app is the same, and beta now points at this release too. Make a backup (System → Backup & Restore) before updating, as always.
Highlights
- Anime themes from AnimeThemes, TV shows from Plex TV Themes and ThemerrDB, movies from ThemerrDB, plus optional YouTube search (your own API key; MainThemeSoundtracks is checked first and costs no searches)
- Theme Browser to preview and install, Theme Queue for many titles, optional Automatic Themes
- Collections: a theme for each movie collection (Plex; Jellyfin and Emby experimental)
- Sign in with Plex, Jellyfin Quick Connect, Emby sign-in
- Appearance: Dark / Light / Auto, OLED mode, accent colours and immersive themes
- Replaced themes are kept in a recycle bin with Undo; backups with restore-on-restart
- Runs as a normal user (
PUID/PGID), API key read-only by default, images for amd64 and arm64 with SBOM and provenance
Full list of changes: CHANGELOG.md. Found a bug? Open an issue. Security problems: please report privately (see SECURITY.md).
Preludarr 1.12.0-beta.1
First public beta of Preludarr — theme songs for your media library. Preludarr finds the opening or theme song of each anime, TV show and movie and saves it as theme.mp3 in the title's folder, where Plex, Jellyfin and Emby play it.
Beta: make a backup (System → Backup & Restore) before each update.
Install
ghcr.io/shedman214/preludarr:beta
Docker Compose, docker run and Unraid instructions are in the README. On first start, the container log shows a one-time setup code for creating your account.
Highlights
- Anime themes from AnimeThemes, TV shows from Plex TV Themes and ThemerrDB, movies from ThemerrDB, plus optional YouTube search (your own API key; MainThemeSoundtracks is checked first and costs no searches)
- Theme Browser to preview and install, Theme Queue for many titles, optional Automatic Themes
- Collections: a theme for each movie collection (Plex; Jellyfin and Emby experimental)
- Sign in with Plex, Jellyfin Quick Connect, Emby sign-in
- Appearance: Dark / Light / Auto, OLED mode, accent colours and immersive themes
- Replaced themes are kept in a recycle bin with Undo; backups with restore-on-restart
- Runs as a normal user (
PUID/PGID), API key read-only by default, images for amd64 and arm64 with SBOM and provenance
Full list of changes: CHANGELOG.md. Found a bug? Open an issue. Security problems: please report privately (see SECURITY.md).