Blacklist
The blacklist prevents Narratorr from re-downloading releases you’ve already rejected. Releases are identified by their info hash (torrents) or NZB GUID (Usenet).
How Releases Get Blacklisted
Section titled “How Releases Get Blacklisted”Releases are added to the blacklist automatically when:
- The quality gate auto-rejects a download (quality same or worse than the existing copy) — reason
bad_quality - You cancel an in-progress download from the Activity page (the Cancel & Blacklist button) — reason
user_cancelled, recorded as permanent - You choose Reject & Search on a held download awaiting review — this blacklists the release (reason
bad_quality) and re-searches for a different one
Note that the plain Reject button on a held download is dismiss-only: it does not blacklist the release. Only Reject & Search blacklists.
You can also manually blacklist any release from the search results modal (the Blacklist button on each release card). Entries are recorded with reason other.
Blacklist Types
Section titled “Blacklist Types”| Type | Behavior |
|---|---|
| Permanent | Stays on the blacklist forever. Only removed manually. |
| Temporary | Expires after a configurable TTL, then the release becomes eligible again. |
TTL Setting
Section titled “TTL Setting”Configure the temporary blacklist TTL in Settings > Search, under the Blacklist TTL (days) field. Range: 1–365 days. Default: 7 days.
Temporary blacklisting is useful when a release had a transient issue (bad quality at the time, incomplete upload) but might improve later.
Blacklist Reasons
Section titled “Blacklist Reasons”Each entry records why it was blacklisted:
| Reason | Meaning |
|---|---|
bad_quality | Quality gate rejection — quality too low |
wrong_content | Not the expected audiobook |
wrong_narrator | Different narrator than expected |
spam | Fake or spam release |
download_failed | Download itself failed |
infrastructure_error | Download client or network error |
user_cancelled | User Cancelled — download was cancelled by the user |
other | Manual blacklist or unspecified |
Managing the Blacklist
Section titled “Managing the Blacklist”The blacklist is managed from Settings > Blacklist. You can:
- View all blacklisted releases with their reason, type, and expiry date
- Toggle an entry between temporary and permanent
- Delete an entry to allow the release to be downloaded again
- Expired temporary entries are automatically cleaned up
How It Affects Search
Section titled “How It Affects Search”During search (manual, scheduled, and RSS), Narratorr checks every result’s info hash (torrents) and GUID (Usenet) against the active blacklist. Blacklisted releases are filtered out before ranking. Temporary entries that have passed their expiry date are not considered active.