selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
BookBounty logo

Self-host BookBounty

v0.2.15

Find missing Readarr books via Library Genesis

BetaOpen SourceMPL-2.0
Updated10 hours ago
LanguagePython
Setup difficultyEasy
Stars
294
Port
5000 (Web UI)
Docker
thewicklowwolf/bookbounty
Install with Docker Compose

What is BookBounty?

BookBounty is a self-hosted utility for Readarr users that automatically finds and downloads missing books from Library Genesis. It integrates with Readarr via its API to detect missing books, searches LibGen for matches, and downloads them to a configured folder. The tool supports scheduled syncs, configurable match thresholds, language and file extension filtering, and two download structure modes (flat files or organized author/book folders). It runs as a Docker container with a web UI on port 5000. The project is licensed under MPL-2.0 and is actively maintained with regular releases.

Should you self-host BookBounty?

BookBounty scores 43/100 on selfhost.directory (how scoring works) and ranks #11 of 12 in Book Management. It has 294 GitHub stars.

It shipped 5 stable releases in the past year. The latest, v0.2.15, came out on 21 August 2026. New versions land roughly every 2 months.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MPL-2.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is bookorbit (73/100, 5 868 stars). It scores higher overall, so compare the two before you pick. See BookBounty vs bookorbit side by side.

Features

  • Automatic library scan
  • Configurable match threshold
  • Download structure options
  • File extension filtering
  • Language filtering
  • Library Genesis search
  • Readarr Integration
  • Scheduled Sync
  • Search customization

BookBounty README

How to install BookBounty

Install BookBounty with Docker Compose

services: bookbounty: image: thewicklowwolf/bookbounty:latest container_name: bookbounty ports: - 5000:5000 volumes: - /path/to/config:/bookbounty/config - /path/to/downloads:/bookbounty/downloads - /etc/localtime:/etc/localtime:ro restart: unless-stopped

Requires Readarr instance and API key

How to configure BookBounty

  • libgen_addresshttp://libgen.isThe URL for Library Genesis

    The URL for Library Genesis

  • library_scan_on_completionTrueWhether to scan Readarr Library on completion

    Whether to scan Readarr Library on completion

    values: True, False

  • minimum_match_ratio90Minimum percentage for a match

    Minimum percentage for a match

  • PGID1000The group ID to run the app with

    The group ID to run the app with

  • preferred_extensions_fiction.epub, .mobi, .azw3, .djvuFilter fiction download by extension (comma separated)

    Filter fiction download by extension (comma separated)

  • preferred_extensions_non_fiction.pdf .epub, .mobi, .azw3, .djvuFilter non-fiction download by extension (comma separated)

    Filter non-fiction download by extension (comma separated)

  • PUID1000The user ID to run the app with

    The user ID to run the app with

  • readarr_addresshttp://192.168.1.2:8787The URL for Readarr

    The URL for Readarr

  • readarr_api_keyThe API key for Readarr

    The API key for Readarr

  • request_timeout120Timeout for requests (seconds)

    Timeout for requests (seconds)

  • search_last_name_onlyFalseUse only the author's last name in searches

    Use only the author's last name in searches

    values: True, False

  • search_shortened_titleFalseUse shortened title when searching (remove everything after :)

    Use shortened title when searching (remove everything after :)

    values: True, False

  • search_typefictionSelect Search Type (fiction or non-fiction)

    Select Search Type (fiction or non-fiction)

    values: fiction, non-fiction

  • selected_languageEnglishFilter download by languages (specific languages or all)

    Filter download by languages (specific languages or all)

  • selected_path_typefileSelect Download Structure (file or folder)

    Select Download Structure (file or folder)

    values: file, folder

  • sleep_interval0Interval to sleep between downloads (seconds)

    Interval to sleep between downloads (seconds)

  • sync_scheduleScheduled hours to run (comma separated values in 24hr)

    Scheduled hours to run (comma separated values in 24hr)

  • thread_limit1Max number of threads to use

    Max number of threads to use

BookBounty releases & version history

More in Book Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…