Best Whisparr Settings After a Fresh Install

A fresh Whisparr install works out of the box, but the defaults are deliberately neutral. Fifteen minutes in Settings decides whether you get a tidy, self-maintaining library or constant churn of re-downloads and odd file names. These are the settings worth changing, in the order worth changing them.

1. Security first (Settings → General)

Enable authentication before anything else and set a strong password. If you ever plan to reach the UI from outside your home, do it through a VPN or an HTTPS reverse proxy — never by forwarding the raw port. While you are here, note the API key; Prowlarr and other tools will ask for it.

2. Quality profiles that will not thrash your disk (Settings → Profiles)

A quality profile has two levers: which qualities are allowed, and the upgrade cutoff. The mistake beginners make is allowing everything and setting the cutoff to the maximum — which tells Whisparr to keep re-downloading the same items forever as marginally better releases appear.

• Allow only the range you genuinely watch. If 1080p is your ceiling, do not allow 4K “just in case”.
• Set the cutoff to the quality you are happy with, not the best that exists. Once the cutoff is met, upgrading stops.
• Use size limits per quality to reject bloated or suspiciously tiny releases automatically.

3. A naming scheme you will not regret (Settings → Media Management)

Turn renaming on and build a format that is readable, sortable and consistent. Good schemes share three traits: the title comes first, the year or date disambiguates, and the quality tag comes last. Avoid characters that misbehave across operating systems (colons, slashes, question marks) — Whisparr's replacement rules handle most of this if renaming is enabled.

4. Root folders and folder strategy

One root folder per library type is plenty. Resist the urge to create many root folders as a categorization system — categories belong in tags and metadata, not in the filesystem. Keep the root folder inside the same data parent as your downloads so imports are instant hardlinks (the layout every guide on this site uses).

5. Importing behavior worth enabling

• Use hardlinks instead of copy: on by default in sensible layouts; verify it is active.
• Recycle bin: set a recycle bin path so upgrades move replaced files there instead of deleting them instantly. Give yourself a cleanup interval of a week or two.
• Unmonitor deleted items: prevents Whisparr from re-grabbing something you deliberately removed.

6. Indexer hygiene

More indexers is not automatically better. A few reliable indexers with correct categories outperform a dozen flaky ones that time out and stall searches. If you run Prowlarr, manage everything there and let it sync — one place to fix keys and URLs. Set sensible retention and seed settings on the download client side so the client, not Whisparr, enforces your sharing rules.

A settings checklist you can copy

• Authentication enabled, strong password, API key noted
• One quality profile trimmed to the range you actually use, cutoff at “happy”, size limits set
• Renaming on, cross-platform-safe naming format
• Single root folder inside the shared data parent
• Hardlinks verified, recycle bin path set
• Indexers tested green, download client category dedicated to Whisparr

Download Now