# BookBounty

BookBounty is a self-hosted web app that helps Readarr users find books missing from their library by querying configured book repositories. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1371/bookbounty

## Description

BookBounty is a self-hosted web app that helps Readarr users find books missing from their library by querying configured book repositories.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

56/100 (Fair), based on 3 of 4 factors.
- Maintained: 71 (last commit 63 days ago)
- Popular: 49 (291 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/TheWicklowWolf/BookBounty
- Docker Hub: https://hub.docker.com/r/thewicklowwolf/bookbounty
- Unraid: https://ca.unraid.net/apps/bookbounty-1y8xny91u6j61p?q=bookbounty

## Common questions

### How do I run BookBounty with Docker Compose?

Use the BookBounty Docker image and map a config volume, a downloads volume, and port 5000. Set restart to unless-stopped and optionally set PUID and PGID.

### How should the BookBounty downloads folder be mapped for Readarr?

Map the app downloads folder directly into Readarr and set selected_path_type to folder so it creates the correct author/book structure. Alternatively, map it to an unprocessed folder, set selected_path_type to file, and let Readarr scan the files.

### How do I schedule BookBounty to sync automatically?

Set sync_schedule to a comma-separated list of 24-hour hours, such as 2 and 20. The sync may start up to 10 minutes after the scheduled time.

### What environment variables configure the Readarr connection?

Use readarr_address for the Readarr URL and readarr_api_key for the Readarr API key.

### How can I stop Audiobookshelf from importing BookBounty downloads before Readarr processes them?

Point BookBounty at a download path that Readarr can see but Audiobookshelf cannot. Use the Audiobookshelf Docker Compose volumes so ABS does not monitor that path until Readarr has imported the files.

---
Source: Our Local Host (https://ourlocalhost.com/app/1371/bookbounty), the self-hosted and open-source app directory.