Repository navigation
Releases
v6.0.0-alpha
v6.0.0-alpha
A big reliability release. Trackarr is now much more careful about what it removes and searches for, works properly
with more than one Radarr or Sonarr, handles HTTPS and reverse proxies, and is simpler to set up in Docker.
Before You Upgrade
- Your download health history starts fresh. Older versions could mix up downloads between two servers of the same
type (for example a 1080p and a 4K Radarr), and that history can't be fixed. It's cleared once, the first time v5.2
starts. Your servers, settings, missing media and search history are kept. - The default port is now 8585. If your container still has an
ASPNETCORE_URLSvariable from the old template, it
keeps using its old port. To move to 8585, remove that variable and change your port mapping to8585:8585. - Fewer Docker settings. Only the port, the
/configfolder, your time zone (TZ) and optionallyPUID/PGIDare
needed. The other variables in the old template can be removed (leaving them does no harm). - Trackarr no longer runs as root in Docker. It runs as user 99 / group 100 by default (Unraid's usual
nobody:users) and fixes the ownership of your/configfolder automatically. SetPUID/PGIDif you use different
IDs. - Set your time zone with
TZ(for exampleAmerica/New_York) so times show in your local time instead of UTC. - Logs and crash reports now live in your config folder (
logsandcrashes), so they survive updates. - Deleting a server now deletes everything that belonged to it. Leftovers from servers deleted in earlier versions
are cleaned up automatically. - The connection timeout setting now actually works. It defaults to 30 seconds, so an offline server may take a
little longer to be noticed. You can lower it under Settings > Servers.
New
- Server health and uptime. Servers that stop responding are disabled automatically and switched back on (with a
full sync) when they come back. A new Uptime page per server shows uptime, response times, Radarr/Sonarr's own
health warnings, and a history of outages. - Network settings. A new Settings > Network page for the port, which network address to listen on, a URL base
(to run Trackarr at an address likehttps://example.com/trackarr), reverse proxy support, and an optional proxy for
reaching Radarr and Sonarr. - HTTPS to Radarr and Sonarr. You can now connect through a reverse proxy at a sub-path (like
https://example.com/radarr), or to Radarr/Sonarr's own HTTPS with a self-signed certificate. Paste the full address
and Trackarr fills in the details. When a connection fails, it now tells you why. - Protect a download. Mark a download as protected and Trackarr will never remove it automatically.
- Evaluate is now a preview. It shows what Trackarr would decide for a download right now, without counting as a
check, so clicking it can't push a download toward removal. - Quality profiles are put back. When Trackarr lowers a movie's or show's quality profile to find a release, it
now restores the original once the item downloads. If you changed the profile yourself in the meantime, it leaves
yours alone. - Force Search on the Missing page searches for an item right away.
- Docker health check, so Docker and Unraid can show whether Trackarr is running properly.
Smarter Download Handling
- Downloads that are simply waiting (queued, paused, held back on purpose, or finished and waiting to be imported) are
no longer treated as failing, so they won't be removed and blocklisted by mistake. - If your download client is offline, Trackarr waits instead of treating the whole queue as stuck.
- TV downloads are judged per episode, so one bad episode no longer counts against the whole show.
- A download has to be missing twice in a row before Trackarr decides it disappeared.
- A download only shows "Remove" when Trackarr will actually remove it. If Passive Mode or Auto Remove is stopping it,
you're told why. - Removing a download yourself no longer counts as a failure.
- Downloads that recover are protected for the number of checks you set (this was accidentally measured in minutes).
Smarter Missing Media Searches
- Trackarr searches a limited number of items per server each run (10 by default) so it doesn't flood your indexers.
- Searches go out as one request instead of one per item.
- Time between searches is now in hours (6 by default) and grows after each unsuccessful search. Items are given
about a day and a half before the quality profile is lowered, and about a week before Trackarr stops searching. - Items Trackarr gave up on are tried again after 30 days, since new releases show up over time.
- Passive Mode now also stops searches and quality profile changes.
- New settings for searches per run and the retry period are under Settings > Missing Media.
Settings That Now Work As Described
- Connection timeout, Monitor Queue, Auto Remove, Recovery Protection and Bad Scan Decay now behave the way the
settings page says. - Turning a routine off or changing how often it runs is no longer undone by a restart.
- "Run routines on schedule" (Settings > General) applies straight away, and turning it off no longer stops the Run
buttons. - The cleanup interval applies as soon as you save it.
- Speed and ETA rewards were never actually used, so they've been removed from the Health Scoring page.
Faster
- Trackarr makes far fewer calls to Radarr and Sonarr and to its own database, which matters most with large
libraries and long queues. - Open browser tabs refresh once per batch of changes instead of once per download.
Fixes
- The sidebar counters no longer trigger searches in the background.
- Two Radarr or two Sonarr servers no longer mix up each other's movies and shows.
- One offline server no longer stops the queue from updating for all the others.
- Routines that partly failed now show as Failed instead of Success.
- The Servers page no longer crashes when something goes wrong, and a wrong API key now shows as not authenticated.
- Saving a server no longer undoes its latest status.
- The queue no longer shows duplicate rows or hides downloads that don't have an ID yet.
- The History page no longer crashes after a server has been deleted.
- The Routines page no longer keeps checking in the background after you leave it.
- Resetting the database works again, saving a server whose address is unreachable no longer fails, and settings
pages correctly show unsaved changes. - Times are shown in your time zone.
- An invalid blacklist pattern is now reported in the logs instead of being silently ignored.
Behind the Scenes
- The Docker image is about 178 MB smaller.
- The web interface's external styles and scripts are pinned to fixed versions, so outside updates can't change how
it looks. - Database updates for this version run automatically the first time v5.2 starts.
v5.1.0-alpha
New
- Passive mode — New setting under Servers > Removal Behavior that lets Trackarr monitor and score downloads without actually removing anything. Shows a warning banner when active.
- Console log level — Change log verbosity from the General settings page. Takes effect immediately without restarting.
- Danger zone — General settings now includes Wipe Database, Reset Settings, and Restart Application with confirmation prompts.
- Live auto-refresh — Pages now update automatically when data changes instead of polling on a fixed timer. The sync interval is configurable under Display settings.
- Health check routine — Server connectivity and status warnings are now checked by a dedicated background routine instead of on every page load.
- Server enable/disable — Servers can be temporarily disabled from the row dropdown menu. A "Disabled" status filter is available on the Servers page.
- Disabled server appearance — Disabled servers appear dimmed with strikethrough text across Queue, Missing, and Servers pages so they're easy to distinguish.
- CI test gate — Tests now run automatically in the build pipeline before publishing a new Docker image.
- No-servers placeholder — Queue, Missing, and History pages show a helpful prompt when no servers have been added yet.
- Queue comfortable density — When table density is set to "comfortable," queue groups show the download client, indexer, and total file size.
- "By Media Title" grouping — The queue grouping dropdown now has an explicit "By Media Title" option, which is the new default.
- Episode sync — Episode data is now synced from Sonarr during missing media scans, keeping the local database up to date.
- New tests — Added tests for passive mode, console log level, database wipe, and settings reset.
Improved
- Settings pages redesigned — All settings pages now use consistent section headers, dividers, and info tooltips. Inputs scale properly on all screen sizes instead of being fixed-width.
- Status page — The app info section is now a compact bar showing version, build time, and uptime instead of four large cards.
- Background routine stability — A single failing routine tick no longer stops the entire routine loop, and individual save errors are caught instead of crashing the run.
- Routines handle no servers — Background routines now skip gracefully with a log message when no servers are configured instead of running with nothing to do.
- Disabled server data — Disabled servers still show their previously tracked missing media from the database instead of appearing empty.
- Display settings reorganized — The separate "Health Badges" and "Server Icons" toggles have been replaced with a single "Poster Images" switch. Chart toggles are now grouped under a "Visual Elements" section.
- Compact density auto-hides — Poster images, media type badges, health badges, and server icons are automatically hidden in compact table density.
- Health policy form — Streak multiplier fields now show a "x" unit label, and threshold inputs are no longer fixed-width.
- Maintenance settings — All retention and cleanup fields now have descriptive tooltips.
- Add Server modal — The large "Ready to Test" banner has been replaced with a compact inline test button next to the fallback profile dropdown.
- Status alerts — Removed noisy "not reached in 15 minutes" and "routine failed on last run" warnings that generated false positives.
Fixed
- Fallback profile applied wrong quality — When lowering quality for repeatedly missing media, Trackarr was sending the wrong profile ID to Sonarr/Radarr. Downloads could silently get the wrong quality profile or fail to change at all.
- Fallback crash on deleted profile — If a server's fallback profile was deleted, the missing media scan would crash. It now skips the fallback step safely.
- Component styles not loading — Per-component styles were not being applied anywhere in the app due to a missing stylesheet reference.
- Multiple confirmation dialogs conflicted — Pages with more than one confirmation prompt (e.g., the new Danger Zone) would only show the first one. Each dialog now has its own identity.
- Database connection error on status page — Checking the SQLite version could fail when the connection was already in use.
- Wrong build time in Docker — The Status page showed an incorrect or missing build timestamp when running in Docker. It now reads the embedded build time correctly.
- Queue status messages not parsing — Download status messages from Sonarr/Radarr were not being decoded properly due to a deserialization issue.
- Missing episodes incomplete — The Missing page could show incomplete episode data for a series. It now loads all episodes for each matched series.
- Server filters counted disabled servers — The Online, Offline, and Error filters on the Servers page included disabled servers, giving misleading counts.
- Sync All contacted disabled servers — Clicking "Sync All" would try to reach disabled servers, causing unnecessary timeouts and errors.
- Pages could stop updating — The Missing, Servers, and sidebar health pills pages each managed their own refresh timers, which could leak or stop working. All pages now use a single shared refresh system.
- Couldn't save server without testing first — The Add Server modal required a successful connection test before the Save button became available, even with all fields filled in.
- Page spacing rule not applied — A CSS syntax error prevented a layout spacing rule from taking effect.
- Dropdown styling applied twice — Several dropdown menus had a duplicate style class that could cause rendering inconsistencies.
- Queue health chart misaligned — The health score distribution chart had broken indentation causing layout issues.
- Blacklist button sizing — Buttons on the Blacklist settings page were inconsistently sized.
Full Changelog: v.5.0.10-alpha...v5.1.0-alpha
v.5.0.10-alpha
v5.0.10-alpha
New
- Release Notes page — View past releases and changelogs directly in the app under System > Releases.
- License page — Added a License page under System showing project permissions and terms.
- Queue pagination — The queue now splits results across pages instead of showing everything at once.
- Mock server — Added a mock server project for testing without a live Sonarr/Radarr connection.
Improved
- Settings layout — Settings now uses a sidebar with grouped categories instead of a flat list of tabs.
- Status page — Added cards showing uptime, version, start time, migration count, and data totals (servers, movies, series, episodes, downloads, health events).
- Queue grouping — Groups can now default to expanded or collapsed based on a display setting.
- Queue details — Each queue group now shows which server it belongs to.
Fixed
- Queue filters — Changing or clearing filters now properly resets back to page 1.
- Database schema — Aligned several data models to match the current database structure.
- Unraid deployment — Fixed multiple issues preventing proper deployment on Unraid.
v5.0.2-alpha
Bug Fixes
- Blacklist removal now tracked correctly —
QueueEvaluationRoutinenow evaluates the download viaHealthServicebefore removing blacklisted items, so the correctDownloadAttemptIdis recorded instead of0 - Scoped
autoRemoveEnabled— moved the flag inside the per-server loop so each server uses its own setting instead of leaking state from a prior iteration - Topbar refresh state —
_isRefreshingis now explicitly initialized tofalseon component init
New Features
JsonHelper— centralized, safe JSON serialize/deserialize utility with case-insensitive parsing and graceful error handlingRoutineStateenum — explicit lifecycle states for routines (Created,WaitingToRun,Running,Success,Canceled,Failed)
Code Cleanup & Refactoring
-
Dead code removed:
LogEventLevelenum (unused, superseded byMicrosoft.Extensions.Logging.LogLevel)IHealthServiceinterface (dead abstraction, onlyHealthServiceconcrete class used)IRoutineRuninterface (unused)- Custom
AppTable/AppTableColumn/AppTableSortBlazor components and their scoped CSS
-
Namespace correction: all routines moved from
Trackarr.TaskstoTrackarr.Routinesto match the project name -
Typo fix:
HearbeatRoutine.csrenamed toHeartbeatRoutine.cs -
Classes sealed:
EventService,MissingMediaFetchRoutine,QueueEvaluationRoutinemarkedsealedto prevent unintended inheritance -
DLL reference → NuGet:
Microsoft.Extensions.Hosting.Abstractionschanged from a local DLL reference to a properPackageReference -
Unused dependency removed:
IDbContextFactoryremoved fromRoutineHostedServiceconstructor -
Redundant stats update removed:
QueueRefreshRoutineno longer callsUpdateServerStatsAsyncafter fetching the queue -
Region organization:
#regionblocks added across core models and services to group Identity, Properties, Navigation, Public API, etc.
UI / Layout
- Layout reworked: CSS class scheme changed from custom (
app-shell,app-main,app-content) to standard Tabler conventions (page,page-wrapper,page-body) - NavMenu rewritten with expanded navigation structure
- Sidebar backdrop simplified — removed
d-lg-nonerestriction andapp-sidebarclass - Scoped CSS removed for
MainLayoutandNavMenu(styles consolidated intoapp.css) - Page components refactored: Queue, Missing, History, Servers, Events, and Routines pages all received significant cleanup
Tests
- ~3,400 lines of new tests added:
CoreModelExtendedTests— JsonHelper, model defaults, computed properties, edge casesHealthEvaluatorDecisionTests— removal/blacklist decision logicHealthEvaluatorHelperTests— helper and utility methodsHealthEvaluatorObservationTests— observation building from download statesHealthEvaluatorScoringTests— health score calculationHealthServiceLifecycleTests— full evaluate/mark-removed lifecycleSettingsServiceTests— settings read/write coverage
Stats: 100 files changed, 5,690 insertions, 2,505 deletions
v5.0.0-alpha
What's New
Data & Models
- Added
ManualOverridehealth event type - Added per-server settings:
MonitorQueue,AutoRemoveDownloads,SearchMissing,RequestTimeoutSeconds,Priority - Added
AppSettingsandBlacklistdatabase tables with migrations - Health policy is now dynamic — loaded from
SettingsServiceinstead of hardcoded defaults - Health event deduplication: no-change events update the existing row's timestamp instead of creating duplicates
- Refined stuck-detection logic to preserve "abandoned-search" reason when clearing download-failure state
Routines
HeartbeatRoutinenow skips disabled serversMissingMediaFetchRoutinefilters by enabled + search-missing setting, ordered by server priorityQueueRefreshRoutinefilters by enabled + monitor-queue setting, ordered by server priorityQueueEvaluationRoutinechecks downloads against a blacklist (indexer, release group, keyword) and auto-removes matches; respects per-server auto-remove setting- Routine infrastructure updated
UI
- Rebuilt main layout with CSS grid shell
- Redesigned top bar with breadcrumbs, page title, refresh, GitHub link, settings dropdown, and mobile sidebar toggle
- Redesigned nav menu with collapsible groups, chevron animations, and system status badge
- Added mobile sidebar backdrop
- All pages updated to new card and table styling with density support
- Significantly expanded Queue and Missing page functionality
- Expanded media details and add-server modals
- Consolidated settings pages into a single view
- Reworked System Events and Routines pages
Infrastructure
- New service registrations
- Major CSS overhaul
- Dynamic app title from settings
- Added queue and missing chart scripts
- Added sidebar toggle helper
- Updated dependencies and tests
v4.0.0-alpha
What's New
Data & Models
- Added
ManualOverridehealth event type - Added per-server settings:
MonitorQueue,AutoRemoveDownloads,SearchMissing,RequestTimeoutSeconds,Priority - Added
AppSettingsandBlacklistdatabase tables with migrations - Health policy is now dynamic — loaded from
SettingsServiceinstead of hardcoded defaults - Health event deduplication: no-change events update the existing row's timestamp instead of creating duplicates
- Refined stuck-detection logic to preserve "abandoned-search" reason when clearing download-failure state
Routines
HeartbeatRoutinenow skips disabled serversMissingMediaFetchRoutinefilters by enabled + search-missing setting, ordered by server priorityQueueRefreshRoutinefilters by enabled + monitor-queue setting, ordered by server priorityQueueEvaluationRoutinechecks downloads against a blacklist (indexer, release group, keyword) and auto-removes matches; respects per-server auto-remove setting- Routine infrastructure updated
UI
- Rebuilt main layout with CSS grid shell
- Redesigned top bar with breadcrumbs, page title, refresh, GitHub link, settings dropdown, and mobile sidebar toggle
- Redesigned nav menu with collapsible groups, chevron animations, and system status badge
- Added mobile sidebar backdrop
- All pages updated to new card and table styling with density support
- Significantly expanded Queue and Missing page functionality
- Expanded media details and add-server modals
- Consolidated settings pages into a single view
- Reworked System Events and Routines pages
Infrastructure
- New service registrations
- Major CSS overhaul
- Dynamic app title from settings
- Added queue and missing chart scripts
- Added sidebar toggle helper
- Updated dependencies and tests
v0.1.0-alpha
Trackarr v0.1.0-alpha
This is the first alpha release of Trackarr.
Trackarr is still early, but it has reached the point where the core idea is working enough to start testing it outside of my development environment. This release is mostly about getting the current app stable, deployable, and usable on a real server.
The goal for this release is simple:
Trackarr should be able to run, connect to Radarr and Sonarr, track queue activity, show useful media status, and help surface items that need attention.
This is not a finished product yet. There are still rough edges, unfinished UI pieces, and some settings that are not editable from the app yet. But the foundation is there.
What is included
- Radarr and Sonarr server support
- Server setup and connection handling
- Queue tracking
- Download status display
- Health scoring for downloads
- Download attempt history
- Media details modal
- Missing media tracking
- Missing movies support
- Missing episode grouping by series
- Routine system for background tasks
- Routine run history
- Basic dashboard cards
- Tabler/Bootstrap based UI
- SQLite database support
What changed
This release moves Trackarr from “feature building” into “release testing.”
A lot of the recent work has been focused on making the app feel more like a real self-hosted tool instead of a collection of working pages.
The biggest areas of progress are:
- Better queue tracking
- Better media details
- Better background routine handling
- Better missing media structure
- Better database models for queue, health, attempts, routines, and missing media
- Cleaner table components
- More consistent UI across pages
- More useful status and health information
Known issues
This is still alpha software.
Some things are not done yet:
- Some settings are not editable through the UI
- Some UI pages still need cleanup
- Some table and modal behavior may still be rough
- Some backend paths need more hardening
- Docker deployment is still being tested
- Documentation is still early
- Tests are limited right now
- Breaking database changes may still happen
Do not treat this as a stable production release yet.
Testing focus
The main things being tested right now are:
- App startup
- Database creation and migrations
- Radarr/Sonarr connection handling
- Queue refresh behavior
- Missing media refresh behavior
- Routine execution
- Docker deployment
- App restart behavior
- Handling offline servers or bad API responses
Upgrade warning
Since this is the first alpha, there is no stable upgrade path yet.
Database changes may happen between alpha builds. Back up your database before updating.
What comes next
The next phase is focused on stability, not new features.
Planned focus areas:
- Docker deployment cleanup
- Better setup documentation
- More release testing
- More backend safety checks
- More useful error messages
- More tests around fragile logic
- Settings cleanup
- UI bug fixes
- Public GitHub cleanup
Final note
Trackarr is being built as a self-hosted tool for people who want better visibility into what Radarr and Sonarr are doing.
This release is not the finish line. It is the first version that is ready to be tested like a real app.