book recon

Book recon is a service to find books via Telegram Bot.

Features

• UI: Telegram bot
• Supported providers:
  • https://royallib.com/
  • http://flibusta.site/
  • RuTracker (via Jackett)

Quick start

cp .env.example .env

# edit .env

# run
docker compose up -d

RuTracker setup

RuTracker works through Jackett — a proxy server for torrent trackers.

1. Set the API key

Generate a random string (e.g. openssl rand -hex 16) and put it in two places:

jackett/ServerConfig.json (template already exists in the repo):

{
  "APIKey": "your_key_here"
}

.env:

JACKETT_API_KEY=your_key_here

The keys must match. The jackett/ServerConfig.json file is mounted into the container automatically via docker-compose.yml.

2. Start Jackett

docker compose up -d jackett

3. Add the RuTracker indexer

Jackett port is bound to localhost only. To access the Web UI, use an SSH tunnel:

ssh -L 9117:localhost:9117 your-server

Then open http://localhost:9117 in your browser:

1. Click Add Indexer
2. Find RuTracker.RU
3. Enter your RuTracker username and password
4. Click Okay

4. Enable the provider

In .env:

RUTRACKER_ENABLED=true

Restart the bot:

docker compose up -d