Skip to content
narratorr

First Run Setup

After installing Narratorr, you’ll configure the essentials to start searching and downloading audiobooks.

  1. Turn on authentication

    On a fresh install, authentication ships OFF by default (mode None) — anyone who can reach the app has full access. Enabling it should be your very first action.

    Navigate to Settings > Security and choose an authentication mode:

    • Forms (Login Page) (recommended) — a login page with session-based auth
    • Basic (Browser Prompt) — HTTP Basic Auth prompted by the browser
    • None (No Authentication) — no auth (only if Narratorr is on an isolated network)

    In the same Security section, set a username and password. See Security & Auth for details.

  2. Configure your library path

    Go to Settings > General (the library path is the first section there). Set the path where Narratorr should store your audiobooks. In Docker, this is /audiobooks by default (mapped to a host directory via volumes).

  3. Add an indexer

    Go to Settings > Indexers and add at least one source to search:

    • Torznab — for torrent indexers via Jackett or Prowlarr
    • Newznab — for Usenet indexers
    • MyAnonamouse (MAM) — direct integration with the MAM private audiobook tracker (mam_id + freeleech-wedge support)
    • AudioBookBay — a best-effort, Cloudflare-gated scraper that often needs FlareSolverr and can be unreliable; prefer Torznab, Newznab, or MAM as your primary sources

    Click Test to verify the connection. See Indexers for per-type setup.

  4. Add a download client

    Go to Settings > Download Clients and add your client:

    Click Test to verify the connection. See Download Clients for per-type setup.

  5. Search for your first audiobook

    Go to the Search page. Type an author or title and hit search. Narratorr queries all your configured indexers and shows combined results.

  6. Add a book to your library

    From the search results, select a book to view its details. Click Add to Library to track it.

  7. Grab a release

    Browse the available releases for your book. Click Grab on the one you want — Narratorr sends it to your download client.

  8. Monitor the download

    Check the Activity page to watch download progress. Once the download completes, Narratorr automatically imports it into your library folder using your configured folder format.