Library & Folders

Library Path

The library path is the root directory where Narratorr stores your organized audiobooks. Every imported book gets its own folder inside this directory, structured according to your folder format template.

The library path is configured in the Settings UI (Settings > General > Library section, the Library Path field) and stored in the database — there is no environment variable for it.

• Default: /audiobooks for every install type. For Docker, mount your host audiobook directory to the container’s /audiobooks volume and leave the path at its default. For manual installs, change it in Settings to a real directory on your host.

The directory must exist and be writable by the Narratorr process.

Folder Format

The folder format template controls how audiobook directories are named inside your library. Configure it in the File Naming section of Settings > General.

Default: {author}/{title}

This creates a structure like:

/audiobooks/
├── Brandon Sanderson/
│   ├── The Way of Kings/
│   └── Words of Radiance/
├── Terry Pratchett/
│   └── Guards! Guards!/

You can include series information, publication year, and other metadata using tokens. See Folder Format Tokens for the complete reference.

The File Naming section also includes a Separator control (Space / Period / Underscore / Dash), a Case control (Default / lowercase / UPPERCASE / Title Case), and selectable naming presets. These apply to both generated folder and file names.

File Format

The file format template controls how individual audiobook files are renamed within their folder. Configure it in the File Naming section of Settings > General.

Default: {author} - {title}

For multi-file audiobooks, track-specific tokens like {trackNumber} and {partName} help keep files in order.

Import Behavior

When a download completes, Narratorr:

1. Detects the completed download in your download client
2. Copies (or moves) the files to your library path using the folder and file format templates
3. Optionally runs audio processing (merge, format conversion)
4. Marks the download as imported

Related Settings

• Delete After Import (Settings > General > Import section) — remove the torrent from the download client after files are imported
• Minimum Seed Time (Settings > General > Import section) — for torrents, how long to seed before the torrent is removed. This applies only when Delete After Import is enabled, and it never delays the import itself.
• Processing (Settings > Post Processing) — merge multi-file downloads, convert formats

If downloads aren’t importing, see Troubleshooting > Downloads aren’t importing.