🙏 FAQ: Setup, Errors, and Common Questions

[Shineii86]

🙏 FAQ — Frequently Asked Questions

Before opening a new Issue or asking in chat, check if your question is answered here.

📦 Setup

Q: Bot doesn't respond to commands at all.
A: 99% of the time this means BOT_TOKEN or API_ID/API_HASH is wrong. Check the startup log — Pyrogram prints errors with the bad variable name. Verify your values with @myidbot on Telegram.

Q: Bot says "PEER_ID_INVALID" when I send a Telegram public link.
A: This was a known bug in 3.1.22 and earlier. Fixed in 3.1.23 — make sure you're on the latest version. git pull && pip install -U -r requirements.txt.

Q: How do I update the bot?
A: Three options:

1. Manual: git pull && pip install -U -r requirements.txt && python3 -m leechbot
2. /update command (auto-pulls if AUTO_UPDATE=true in env)
3. Re-deploy on your platform (Colab: re-run cells; Docker: docker pull + restart)

🐛 Errors

Q: YouTube shows "Sign in to confirm you're not a bot".
A: Two solutions:

1. PO Token plugin (auto) — already in requirements.txt, works out of the box
2. Cookies file — export your browser cookies for youtube.com to cookies.txt in the bot's working directory

See the YouTube Authentication section in GUIDE.md for details.

Q: Instagram carousels fail with AbortExtraction.
A: Fixed in 3.1.28 — Instagram now routes to yt-dlp first (better cookie support) with gallery-dl as fallback for multi-image posts. Update to latest.

Q: Bunkr says "no domain match".
A: Bunkr changed TLDs in 2026. Fixed in 3.1.26 with bunkr.cr, dl.bunkr.cr, balbums.st. Update.

Q: Bot dies silently mid-download.
A: Run python3 tests/test_diagnostics.py to catch known issues. Then check /logs 50 after a fresh restart.

🔧 Advanced

Q: How do I allow other users to use my bot?
A: Send /settings → "Allowed Users" → add their Telegram user ID (get from @myidbot).

Q: Can I run multiple bots from one account?
A: Not directly — each bot needs its own BOT_TOKEN. Run them in separate directories with separate config.py or environment variable overrides.

Q: How do I make downloads go directly to Google Drive without Telegram?
A: Use /gdupload <link> instead of /tupload <link>.

Q: Web dashboard auth token?
A: Auto-generated and printed in startup log. Override with WEB_TOKEN env var. Visit http://localhost:8080 and paste it.

📞 Still stuck?

• Issue tracker: github.com/Shineii86/LeechBot/issues
• Telegram group: t.me/MaximXGroup
• Developer DM: @Shineii86