53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
# wordarr
|
||
|
||
Request and import manager for **ebooks**, **comics/manga** and **audiobooks**, in
|
||
the style of Sonarr/Radarr. Search metadata providers, keep a list of wanted
|
||
titles, and move finished downloads into your library under a naming scheme of
|
||
your choice.
|
||
|
||
## Deployment
|
||
|
||
```bash
|
||
docker compose up -d --build
|
||
# web UI: http://localhost:8787
|
||
```
|
||
|
||
Mount `/mnt/downloads` and your library roots so that the `root_path` values
|
||
configured in wordarr exist inside the container. Keep downloads and libraries on
|
||
the same mount, otherwise moving turns into copy + delete.
|
||
|
||
| Env | Default | Description |
|
||
|---|---|---|
|
||
| `WORDARR_DOWNLOAD_DIR` | `/mnt/downloads` | scanned download folder |
|
||
| `WORDARR_CONFIG_DIR` | `/config` | location of the SQLite database |
|
||
| `WORDARR_AUDIBLE_REGIONS` | `de,com` | Audible marketplaces, first ranks first |
|
||
| `WORDARR_MUSICBRAINZ_UA` | see `metadata/musicbrainz.py` | user agent MusicBrainz requires |
|
||
|
||
## Usage
|
||
|
||
1. **Libraries** – create one per target folder with a media type, a naming
|
||
scheme (`{Author}` `{Authors}` `{Narrator}` `{Narrators}` `{Title}` `{Year}`
|
||
`{Series}` `{Volume}`) and optionally a language that filters the search.
|
||
2. **Search** – look up a title (ebooks: Open Library, audiobooks: Audible plus
|
||
MusicBrainz, manga: AniList) and request it, or add it by hand. For a series,
|
||
*Ganze Serie…* requests every episode at once.
|
||
3. **Import** – scan the download folder. wordarr suggests file→request matches,
|
||
which you confirm or correct; entries can be merged, split, or turned into
|
||
requests from their folder names. Importing renames and moves the files
|
||
according to the library's scheme and writes audio tags.
|
||
|
||
Imported titles can be edited afterwards; *Speichern & neu ablegen* re-applies
|
||
the naming scheme to files already in the library.
|
||
|
||
## Development
|
||
|
||
```bash
|
||
python3 -m venv .venv && .venv/bin/pip install -e '.[dev]'
|
||
.venv/bin/pytest
|
||
WORDARR_CONFIG_DIR=./config WORDARR_DOWNLOAD_DIR=/mnt/downloads \
|
||
.venv/bin/uvicorn wordarr.main:app --port 8787
|
||
```
|
||
|
||
The browser tests in `tests/test_ui_dialogs.py` need `playwright` plus its
|
||
chromium build and skip themselves when either is missing.
|