Narratorr’s settings are organized into sections, accessible from Settings in the sidebar. This page gives an overview of each section. Individual topics have dedicated pages linked below.
| Setting | Description |
|---|
| Log Level | Controls how verbose Narratorr’s logs are. Options: error, warn, info, debug. Default: info. Turn up to debug when troubleshooting. |
| Audible Region | Region used for metadata lookups (cover art, descriptions). Options: us, ca, uk, au, fr, de, jp, it, in, es. Can also be set via the AUDIBLE_REGION environment variable. |
| Setting | Description |
|---|
| Library Path | Root directory where Narratorr stores your audiobooks. In Docker, this maps to /audiobooks. |
| Folder Format | Template for organizing audiobook folders. Uses tokens like {author}/{title}. See Folder Format Tokens. |
| File Format | Template for renaming audiobook files within folders. |
| Setting | Description |
|---|
| Enabled | Toggle automatic searching on/off. |
| Interval | How often (in minutes) Narratorr searches for missing books. Range: 5–1440. Default: 360 (6 hours). |
| Setting | Description |
|---|
| Delete After Import | Remove the downloaded files from the download client after successful import. |
| Minimum Seed Time | For torrents: minimum time (in minutes) a torrent must seed before Narratorr will import it. Prevents premature removal from swarms. |
Audio processing requires ffmpeg. In Docker, ffmpeg is pre-installed. For manual installs, install ffmpeg and configure its path.
| Setting | Description |
|---|
| Enabled | Toggle audio processing on/off. |
| ffmpeg Path | Path to the ffmpeg binary. Auto-detected in Docker. |
| Output Format | Target format: m4b or mp3. |
| Keep Original Bitrate | When enabled, the target bitrate setting is ignored and the source file’s bitrate is retained. |
| Bitrate | Target bitrate in kbps (32–512). Default: 128. Ignored when keep original bitrate is enabled. |
| Merge Behavior | When to merge multi-file downloads: always, multi-file-only, or never. |
See Audio Processing for more detail.
