logabell / dewarr

Dewarr 
 Your reading lists, audiobook library, and downloads in one place. 
## Features
- **Library integration** — connect Audiobookshelf or Grimmory, see what you own, and import completed downloads into verified library folders.
- **Chapterized M4B** — merge a multi-file MP3 download into one audiobook, with a chapter per file, before library import. The download itself stays unchanged.
- **Goodreads sync** — follow shelves, import CSV exports, and check for new books automatically.
- **Author and series follows** — monitor future books with reviewed back-catalog selection, filters, exclusions, and release-day acquisition.
- **Hardcover sync** — track your lists and lists you follow, including private lists your account can access.
- **Custom Goodreads lists** — add public lists, track changes, and pin them to your discovery page.
- **For you** — personalize shelves with followed lists, recommendations, trending books, and new releases.
- **Auto download** — find and select eligible releases using list policies and approved import routes.
- **Download priorities** — rank sources and formats, apply size and seed preferences, and control download capacity.
- **Book discovery** — browse collections, awards, authors, and series.
- **Download sources** — connect MyAnonamouse, Prowlarr, and AudiobookBay; send transfers to qBittorrent.
- **Notifications** — personal and installation alerts through Discord, ntfy, Apprise, and JSON webhooks, with discovery digests. Setup and payload documentation.
- **Shared library** — individual accounts, reading lists, permissions, and download activity.
- **Self-hosted** — Docker, PostgreSQL, and an MIT license.
Early release. Automatic downloads are off by default. Goodreads RSS imports can be partial; CSV import fills historical gaps. See reading accounts for sync behavior.
## Quick start
Run **Dewarr + PostgreSQL**. Dewarr handles migrations and background jobs automatically. No Git, Python, setup script, or `.env` file is required.
`latest` tracks stable releases; use a `vX.Y.Z` tag to pin a release. The optional `edge` tag follows checked builds of main.
Choose an option below. Set both database passwords to the same value. For access from another computer, change `PUBLIC_URL` to `http://your-server:8000`.
 Docker Compose — recommended 
Save this as `compose.yaml`. Adjust `PUID`, `PGID`, and the folders to match your server.
 [code] 
 [code] 
 Docker CLI — download the Compose file 
 [code] 
Edit the passwords, `PUBLIC_URL`, and folder paths in `compose.yaml`, then start:
 [code] 
 Docker run — without Compose 
Change both `change-me` passwords to the same value before running these commands.
 [code] 
Already have PostgreSQL? Skip its container and use your existing database host, name, user, and password in the Dewarr command.
Open localhost:8000, or your server's address, and create your first account. Connect Audiobookshelf or Grimmory, Goodreads, Hardcover, and download clients in **Settings**.
Before cre