Librarr

Downloads

Wanted

Wanted Books

Track books you want next. Librarr can now monitor these titles and search Prowlarr without downloading yet.

Administration

Settings

Configure the folders, services, accounts, and search behavior Librarr uses to manage your library.

Library & Import

Configure the folders Librarr watches and where imported books are organized.

Step 1 – Configure Library Folders

Configure the folders where Librarr should find your existing books and where new downloads will be imported. After saving, you can scan your library to begin building your collection.

Folder where Librarr watches for newly downloaded books.

Destination for organized ebook files after import.

Organize imported files automatically

When enabled, Librarr moves imported files into the configured library directories.

Step 2 – Scan Your Existing Library

Available after saving your library folders.

Audiobooks

Apple Books Export

Copy normalized audiobooks or EPUB/PDF ebooks to a safe handoff folder for Apple Books. Librarr never changes the source files.

Recent Apple Books Exports

No exports yet.

User Management

Create accounts, manage roles, and inspect login status.

Invite Codes

Share a code so someone can self-register with the role you choose. Single-use by default.

Bootstrap Information

If this install was bootstrapped from Docker environment variables, that only applies before local users exist.

After initialization, users are managed here.

Changing AUTH_USERNAME or AUTH_PASSWORD in Docker Compose does not rename or modify existing accounts.

OPDS Catalog

Connect an OPDS-compatible reader to browse and download your Librarr books.

Open Catalog

Use your external Librarr URL plus /opds in reader apps.

Authentication: HTTP Basic Auth with your Librarr username and password.

Formats: EPUB and PDF are preferred; MOBI/AZW3 are offered as raw downloads.

Remote access: use HTTPS through your reverse proxy.

Integrations

Edit URLs and credentials without restarting the container. Saved values override the env vars in your compose file on next restart.

Anna's Archive

Your Anna's Archive account secret key (login key; also called a donator key in some tools) enables membership fast downloads via /dyn/api/fast_download.json. Without it, Librarr uses public LibGen mirrors. Fast downloads also require an active membership on that account.

Prowlarr

qBittorrent

Remote path as seen by qBittorrent, not Librarr's Import Folder.

rTorrent / ruTorrent

XML-RPC validation, submission, and completion tracking. Cleanup/removal is not implemented.

Legacy full XML-RPC URLs remain supported. New fields construct the endpoint from host, port, TLS, and path.

Remote Path Mappings

Translate paths reported by this client into paths visible inside Librarr.

Transmission

rTorrent is available after it is enabled and diagnostics succeed. Cleanup/removal is not implemented.

SABnzbd

Audiobookshelf

Kavita

Komga

Calibre

Connection Diagnostics

Run staged checks for configuration, DNS, TCP, TLS, authentication, API validation, version, and latency.

Prowlarr

Not tested

qBittorrent

Not tested

rTorrent / ruTorrent

Not tested

Search Preferences

Filter non-English results

When enabled, books with non-English titles are hidden from English-focused sources. Multilingual sources (Flibusta, Z-Library) always show all results.

Wanted

Control how often Librarr searches Prowlarr for monitored wanted books. This milestone only searches and stores results.

Download Behavior

Remove torrents after import

When enabled, torrents are removed from qBittorrent after files are imported. Disable to keep seeding.

Search Sources

Loading sources...

Configuration

Loading...