Indexers
Listenarr supports both manually configured audiobook indexers and importing compatible indexers from Prowlarr.
Open Settings -> Indexers to manage them.
Supported indexer types
Listenarr's indexer form currently supports these built-in implementations:
TorznabNewznabMyAnonamouseInternet Archive
The UI also exposes a Custom implementation, but most audiobook setups use one of the four implementations above.
Add an indexer manually
Every indexer starts with the same core fields:
NameImplementationEnablePriorityMaximum SizeEnable Automatic SearchEnable Interactive Search
Most indexers also support:
URLAPI KeyCategoriesEnable RSSMinimum Age
Torznab and Newznab
Use these for most private or public audiobook indexers.
Required inputs
URL: the base indexer URLAPI Key: if the site uses API auth
Optional inputs
Categories: comma-separated category IDsEnable RSS: stored RSS preference; see the limitation belowEnable Automatic SearchEnable Interactive SearchPriority: lower numbers are preferred (1is highest priority)Minimum Age: stored age setting in minutes; see the limitation belowMaximum Size
Newznab adds:
Retention: retention in days, mainly relevant for Usenet
If you are unsure about categories, start with them blank and narrow later.
MyAnonamouse
MyAnonamouse has its own dedicated setup block.
Required inputs
MAM ID
Available options
FilterSearch in descriptionSearch in seriesSearch in filenamesLanguage (numeric id)Freeleech wedgeEnrich resultsEnrich top results
Listenarr fixes the URL to https://www.myanonamouse.net for this implementation.
Internet Archive
Internet Archive is handled as a public-domain source rather than a private API integration.
Available collections:
Librivox (Free Audiobooks)Audio Books & Poetry
Notes:
- Internet Archive does not use the normal RSS flow in the Listenarr form.
- It is useful for public-domain content and backfilling classic titles.
Feature toggles
Enable RSS
The form stores an RSS preference, but the current application does not include an RSS polling worker. Use automatic searches for monitored books; enabling this field alone does not establish feed monitoring.
Enable Automatic Search
Lets Listenarr use the indexer for unattended searches and upgrades.
Enable Interactive Search
Lets you use the indexer during manual search from the UI.
Advanced settings
Priority
Lower numbers have higher priority. Use a smaller value for preferred sources and a larger value for fallback sources.
Minimum Age
The form stores this value in minutes. The current search scorer does not enforce it as a minimum-age gate.
Maximum Size
The form stores this value in MB. The current search scorer does not enforce this indexer field as a size cap; quality profile size limits apply to non-Usenet results.
Retention
Shown for Newznab. Use it only if the indexer's retention information matters to your search strategy.
Test an indexer
Always use Test before saving.
If a test fails:
- verify the URL and API key
- make sure the URL is reachable from Listenarr
- confirm the indexer really supports Torznab or Newznab the way you expect
- for MyAnonamouse, verify the MAM ID and search options
Import indexers from Prowlarr
Listenarr can import audiobook-related indexers directly from Prowlarr.
Open the Import from Prowlarr action and enter:
Prowlarr URL / IPPort (optional)API KeyTag Filter (optional)
What Listenarr imports
With no tag filter, the import keeps indexers carrying categories 3000 or 3030. With a tag filter, it instead selects indexers with a matching Prowlarr tag label, case-insensitively. This lets you choose indexers whose categories would otherwise exclude them.
The import remembers the connection settings for later use. Check the categories on imported entries, especially when using a tag filter: the importer only carries over category IDs 3000 and 3030.
During import, Listenarr:
- skips duplicates it already knows about
- labels imported entries with
(Prowlarr) - maps Usenet providers to
Newznab - maps torrent providers to
Torznab - routes requests through the Prowlarr proxy URL
Prowlarr requirements
Prowlarr must be reachable from Listenarr. If Listenarr runs in Docker, use the address reachable from the Listenarr container, not necessarily the host machine's localhost.
Recommended Prowlarr workflow
- Finish the indexer setup inside Prowlarr first.
- Verify those indexers work in Prowlarr.
- Import them into Listenarr.
- Test a few imported indexers from Listenarr.
This keeps category and credential management centralized in Prowlarr while still letting Listenarr use those sources.