Huntarr Changelog

What is this? This document tracks every major change to Huntarr. If you're new, start at the top — each version explains what changed and why it matters for your setup.

v9.4.1 — The Big Overhaul

Release Theme: Architecture cleanup, premium UI modernization, smarter hunting, and security hardening. This release removes complexity, adds powerful new automation features, and makes Huntarr significantly more polished and secure.

🏗️ Architecture Changes

These are foundational changes to how Huntarr works under the hood. If you're upgrading, read these first.

Removed SABnzbd & NZBGet Support

SABnzbd and NZBGet have been removed as download client options. They added layers of complexity that made troubleshooting harder for new users.

What to use instead: Huntarr's built-in NZB Hunt handles all Usenet downloading natively — no external download client needed. Index Master makes download decisions automatically based on the priority and indexers you configure.

Removed the Clients Page

The separate download clients configuration page has been eliminated. Index Master now handles all download routing decisions based on your indexer priorities. This simplifies the setup process — you just add indexers and let Huntarr figure out the rest.

🔥 Major New Features

🔀 Search Order Toggle

What it does: Choose how Huntarr picks which missing items to search for first.

How it works: Items are sorted by release/air date via the *arr API before being queued for search. Configure this per-app in your scheduling settings.

Why it matters: If you just added 50 new movies, "Newest First" ensures the ones you care about most get searched immediately. If you're backfilling a classic TV library, "Oldest First" works through seasons in order.

💾 Disk Space Pause

What it does: Automatically pauses hunting when your storage is running low, preventing your drives from filling up completely.

How it works:

1. Before each processing cycle, Huntarr queries GET /api/v3/diskspace (built into all *arr apps)
2. It checks free space on every root folder configured in Sonarr/Radarr
3. If any folder drops below your configured threshold, the entire hunt cycle is skipped
4. A clear log message tells you exactly which folder triggered the pause and how much space is left
5. Set the threshold to 0 to disable this feature entirely

Why it matters: No more waking up to a full drive and corrupted downloads. Huntarr stops grabbing new content before you run out of space.

🎛️ Overhauled Filter System

The discover page filter system has been completely rebuilt:

• Per-user filter saving — Movie and TV preferences are saved independently for each user in the database, so your filters don't affect other household members
• Auto-save — Filters save automatically in the background as you adjust them. No "Save" button needed
• Instant loading — Uses local storage for instant page loads while keeping the server as the source of truth. Filters survive page reloads and apply automatically
• Keyword blacklist — Type comma-separated keywords in the filter panel to exclude matching results from your discover feed. Lookups are cached in memory for speed
• Content rating filter — A dedicated dropdown to restrict the discover feed to content at or below your selected certification level (e.g., PG-13, R, TV-MA)
• Active filter badge — Shows how many filters are active. All filters cleanly reset with the "Clear Filters" button

🎨 UI & Design Modernization

The entire Huntarr interface has received a significant visual upgrade, moving toward a premium glassmorphism design language with refined typography and micro-animations.

Menu System Overhaul

• Rigid multi-grid layout — Menus now use a structured grid system (inspired by HuntarrOS) for consistent alignment and spacing
• Instance management relocated — Moved to its own dedicated menu instead of being buried inside individual instances. Users were often unaware of configuration options hidden inside instance views
• Removed legacy info icons — Cleaned up outdated information icons that cluttered page headers
• "Media Hunt" renamed to "Movie Hunt" — The sidebar and all page headers now say "Movie Hunt" since it manages both movies and TV together

Requestarr Visual Upgrade

• Search bars — Frosted glass design with animated focus glow and smooth transitions
• Media cards — Premium glass styling with hover effects, animated poster scaling, and shimmer-effect request buttons
• Instance selectors — Custom-styled dropdowns with frosted glass backgrounds and inner shadows
• Carousel arrows — Glass-styled with colored glow shadows
• Status badges — Color-coded glow effects for requested, available, and missing states
• TV season accordion — Redesigned with indigo hover glow and animated chevrons
• Blacklist search bars — Unified frosted glass design matching the discover page
• Pagination — Glassmorphism buttons with amber hover glow and refined typography
• Unhide buttons — Green glow shadow with enhanced hover effects
• "Minimum Availability" → "Min Availability" — Shortened label in request modals for cleaner layout

Smart Hunt Improvements

• Infinite scroll — Smart Hunt screen now loads content continuously instead of dumping one massive page. Scroll down and more items load automatically
• Improved filter design — Smart Hunt filters have been visually upgraded to match the overall design language

Setup Screen Update

• Updated the finish message to reference the 529 college fund and HuntarrOS.com
• Added a Donate button below the thank-you message
• Sponsor banners in the sidebar are now hidden for owners — they only appear for non-owner users

Documentation Overhaul

The docs site (GitHub Pages) has been modernized to match Huntarr's design:

• Design system updated — Indigo accent color, deeper dark backgrounds, glassmorphism cards with glow hover effects
• New sections added:
  • "New to Huntarr? Start Here" — 4-step quick start for new users
  • "How It Works" — Explains the core problem Huntarr solves
  • "Pro Tips for New Users" — Practical advice for getting started
• Settings docs expanded — Authentication modes, feature flags, reverse proxy configs (Nginx, Caddy, Traefik), Docker env vars, performance tuning
• Scheduling docs expanded — Hunt cycle walkthrough, missing vs. upgrade explanation, multi-instance strategies, queue-aware pausing, troubleshooting guide
• Setup Wizard docs expanded — All 6 steps documented in detail with security guidance and post-setup checklist

🔗 Requestarr Enhancements

Requesting & Discovery

• IMDB and TMDB links — Advanced request pages now include direct links to view detailed info on IMDB and TMDB before requesting
• TV show metadata — Additional metadata information now displayed for TV shows (network, seasons, episode count, etc.)
• Fixed personal user blacklist layout — The personal request ban list now renders correctly
• Fixed search — Search on the front page for movies and TV shows within Requests now works reliably
• Fixed filtering bug — Items you already have in your library are now properly filtered out of request results
• Smart Hunt full-page discovery — Full-page discovery view for Smart Hunt (community suggestion from Makerrs)
• Calendar links — Calendar items now navigate directly to the item's detail page when clicked

Bundles

• Bundle support — Group multiple instances together (e.g., standard + 4K) and request through all of them simultaneously with a single click
• Mixed app types — A bundle can include Movie Hunt + Radarr, or TV Hunt + Sonarr together
• Fault tolerance — If one bundle member fails (offline, misconfigured), the rest continue

User Management

• User logins — Each user gets their own account with dedicated login credentials
• Plex SSO — Users can sign in with their Plex accounts
• Self-service settings — Users can now change their own passwords, link their Plex account, and set up 2FA from their profile
• Global owner media bans — Owners can ban specific media globally so no user can request it
• Personal request bans — Per-user blacklists for request content
• Notifications link — Notifications link added to Requests sidebar (owner only) with context-aware default category

🔒 Security & Hardening

• Container hardening — Non-owner users are now strictly isolated to only the actions they're authorized to perform. Admin-level endpoints are properly gated behind role checks
• Login mode relocated — Moved from general settings directly into the user panel for easier access
• Auto local bypass — System automatically upgrades to local bypass mode when a non-owner user is created, ensuring smooth multi-user access
• Database corruption resiliency — Enhanced safeguards against failed startups and database corruption to keep the application running reliably

🛠️ System Improvements

Notifications

Added new notification providers:

• Gotify — Self-hosted push notification server
• Ntfy — Simple HTTP-based pub/sub notifications
• LunaSea — Mobile app for managing your media stack

All existing providers (Discord, Telegram, Pushover, Email, Apprise) continue to work as before.

Proxy Support

Route outbound HTTP requests through a proxy server — supports HTTP, SOCKS4, and SOCKS5 proxies. Useful for users behind restrictive networks or who want to route indexer traffic through a VPN. (Thanks Makarr!)

External URLs

Added support for external URLs for 3rd party apps (Sonarr, Radarr, etc.). If your *arr apps are accessible at a different external URL than the internal Docker network URL, you can now configure both.

Importer (Renamed)

The old "Logs" section has been renamed to Importer to better reflect its purpose — tracking media imports, downloads, and processing activity.

Other System Changes

• Removed unnecessary logs and standardized logging format across all modules
• Added user cleanup consistency to prevent orphaned accounts
• Improved Plex integration (updated linking flow from setup)
• Redesigned user profile section in the sidebar (bottom-left)
• Fixed grid mode TV Hunt and Movie Hunt tally counts and card alignment
• Display and performance improvements when certain Huntarr features are disabled
• Menu interface enhancements across the board

Removed

• Beta chat feature — Removed entirely. It added more burden than value for multi-user setups
• SABnzbd support — Use NZB Hunt instead
• NZBGet support — Use NZB Hunt instead
• Download clients page — Index Master handles routing
• Legacy info icons — Cleaned up from page headers
• Wizard auto-popup — No longer interrupts users on collections; a button is provided instead

🐛 Bug Fixes