BookBounty

BookBounty is a lightweight Python tool designed to locate books missing from a Readarr-managed library by querying Library Genesis and downloading matching files into a user-configured downloads location. It is distributed as a container image and configured primarily via environment variables.

Key Features

• Integrates with Readarr via its API to identify missing books and coordinate imports.
• Searches Library Genesis (configured mirror) for matches and downloads results that meet a configurable match ratio.
• Two download modes: create folder structure (author/book/filename) or place files into a single imports folder.
• Configurable filters: language selection, fiction vs non-fiction search, and preferred file extensions per type.
• Scheduling and concurrency controls: sync schedule (hour list), sleep interval, thread limit, and request timeout.
• Docker-ready with a provided Dockerfile and container image; includes a gunicorn configuration for serving the app.
• Option to trigger a Readarr library scan after downloads to automate import and reduce manual steps.

Use Cases

• Automatically fill gaps in a Readarr library by fetching missing ebook files from Library Genesis.
• Automate periodic scans to locate and add editions unavailable through other indexers or metadata sources.
• Run on a home server or NAS (Docker container) to integrate with an existing *arr ecosystem and centralized media management.

Limitations and Considerations

• Only one Library Genesis mirror is supported by the code as provided; if that mirror changes or is blocked, BookBounty may fail to find/download items.
• Functionality depends on Readarr availability and correct Readarr metadata; mismatches in metadata can reduce success rates and may require manual tuning of match thresholds and search options.
• The project automates downloads from an external mirror; users should ensure they comply with applicable laws and hosting policies when retrieving content.

BookBounty is a focused utility for Readarr users who need automated retrieval of missing ebooks from Library Genesis. It emphasizes simple deployment via container images and configurable behaviour through environment variables, making it suitable for home server automation workflows.