// the find
Joelkb/DQ-the-file-donor
DQ-The-File-Donor is a simple and powerful Aᴜᴛᴏ Fɪʟᴛᴇʀ Bᴏᴛ repository which supports Koyeb, Heroku, Okteto, Railway, Mogenius and VPS deployment.
A Telegram bot that indexes files from channels and serves them to users on request, with keyword filtering, IMDB integration, and admin controls. It's aimed at Telegram groups that share movies/TV files and want automated search-and-send functionality. The 809 forks vs 222 stars ratio tells you exactly what kind of ecosystem this lives in.
Pyrogram-based async architecture is solid for a Telegram bot of this scope. MongoDB with dual-URI support means you can split collections across free-tier Atlas instances, which is a practical workaround for storage limits. Deployment coverage is genuinely good — Heroku, Koyeb, Railway, Render, VPS all have working configs with one-click buttons. The filter system (per-group manual filters plus global filters) is well thought out for multi-group deployments.
The codebase is a fork of a fork of a fork — credits section names three upstream projects and the README explicitly calls out rampant 'kanging' of this code, so you're getting accumulated modifications with unclear provenance and no single coherent design. Last push was August 2024 and the Heroku deploy button points to a dead free tier, so the deployment docs are already partially wrong. No test coverage anywhere, and config lives in a raw info.py file checked into the repo — the sample_info.py pattern means one slip and your bot token is in git history. The primary use case (distributing copyrighted movie files via Telegram) is the obvious elephant in the room.