Skip to content

README.md

Latest commit

 

History

History
107 lines (90 loc) · 3.76 KB

README.md

File metadata and controls

107 lines (90 loc) · 3.76 KB

Features:

  • Inline search - search manga in any chat. Search
  • Favorites - like the manga so you can easily open or share it. Favorites
  • Read manga directly in the telegram app, no need to open a browser. Instant preview
  • Discover new doujins with /rand command.
  • Open doujins using code or link, send multiple codes in one message.
  • Database - Bot works even if nhentai is down (more than 500k doujins are saved). Database screnshot
  • Translated into Russian and Spanish https://i.imgur.com/eh69bTA.png Language selection

One-Click Deploy Button

Pre-reqs for deploying this project to replit.com:

  • Create Replit account (free)
  • Configure a writable path for the SQLite database file (default: ./data/bot.sqlite)
  • Get bot token from @BotFather

Local development (Bun)

bun install
bun run preview

Proxy Support (Optional)

All manga sources support optional proxy via FlareSolverr to bypass Cloudflare protection.

Environment Variables

Variable Description
SOURCE_FLARESOLVERR_URL FlareSolverr endpoint (e.g., http://127.0.0.1:8191). Falls back to FLARESOLVERR_URL.
SOURCE_PROXY_URL Optional upstream proxy for FlareSolverr (e.g., http://127.0.0.1:8888).
SOURCE_MAX_TIMEOUT_MS Max timeout for FlareSolverr requests (default: 60000).

Running with FlareSolverr

# Start FlareSolverr (Docker)
docker run -d --name flaresolverr -p 8191:8191 ghcr.io/flaresolverr/flaresolverr:latest

# Run the bot with proxy enabled
SOURCE_FLARESOLVERR_URL=http://127.0.0.1:8191 bun run preview

Without these variables set, sources make direct HTTP requests (no proxy).

On replit.com you may need to run npm install node && npm install && npm run build before starting for the first time

Run on replit.com

Development progress:

  • User-related features
    • ability to set filter and random only in specific tags
    • ability to exclude tags from random
    • button to delete all user data in settings
    • button to clear history in settings
    • redesign settings
    • add answerCallbackQuery() to prevent infinite loading on buttons
  • instance features
    • support for readonly connection with database
    • ability to connect to multiple databases
    • generate webhook urls automatically from built in env variables on perl.it
  • Tanslations
    • Finish translations in the search
    • Indonesian
    • German
  • add actual logging
  • proxy support via FlareSolverr for all sources
  • switch from telegraf to grammy
  • typescript!
    • inline search
    • random
    • text handler (by code)
    • likes
    • help & settings
    • "fix" button
    • /zip command
  • find alternative for telegra.ph and implement as a fallback (for hosting images)
  • create new website with fancy stats