Screenshot Bot

---

Sample Bot ( Screenshot - Bot )

umz screenshot gen bot

🚀 Features

• Accepts .mp4 and .mkv files sent as video or document
• Allows user to select 1–20 evenly spaced screenshots
• Returns screenshots as a Telegram media group
• /start, /help, /cancel, /stats, and /broadcast commands
• Stores user data and stats in MongoDB
• Logs every request to a private log channel
• Admin-only /broadcast and /stats commands
• Docker-ready with health check endpoint

---

📚 Requirements

• Python 3.10+
• FFmpeg (included in Docker image)
• MongoDB (MongoDB Atlas or local)
• Telegram Bot Token
• Telegram API ID & Hash from my.telegram.org

---

📦 Setup Instructions

1. Clone the repository

git clone https://github.com/Chamindu-Gayanuka/Screenshot-Bot.git

cd Screenshot-Bot

2. Install dependencies

pip install -r requirements.txt

3. Configure environment variables

API_ID = your_api_id
API_HASH = your_api_hash
BOT_TOKEN = your_bot_token
ADMIN_ID = your_telegram_user_id
MONGODB_URI = your_mongodb_uri
LOG_CHANNEL = -100xxxxxxxxxx  # Telegram Channel ID for logging

4. Bot Commands

start - Start the bot
help - Show instructions
cancel - Cancel the current upload
stats - Show usage stats (admin only)
broadcast - Broadcast a message to all users (admin)

🚀 Deployment

📝 Note

• Make sure to set the environment variables in your deployment platform.
• For local testing, you can run the bot using:

python bot.py

©️ License

This project is licensed under the MIT License. See the 𝙇𝙄𝘾𝙀𝙉𝙎𝙀 file for details.

🙏 Acknowledgements

• 𝙋𝙮𝙧𝙤𝙜𝙧𝙖𝙢 for the Telegram bot framework
• 𝙁𝙁𝙢𝙥𝙚𝙜 for video processing
• 𝙈𝙤𝙣𝙜𝙤𝘿𝘽 for data storage
• 𝘿𝙤𝙘𝙠𝙚𝙧 for containerization

❣️ Special Thanks 👍

• 𝘾𝙝𝙖𝙢𝙞𝙣𝙙𝙪 𝙂𝙖𝙮𝙖𝙣𝙪𝙠𝙖 for creating this bot ❤ ♥
• 𝙐𝙣𝙡𝙞𝙢𝙞𝙩𝙚𝙙 𝙈𝙤𝙫𝙞𝙚 𝙕𝙤𝙣𝙚 for the inspiration and support

Last Updated

• 05-06-2025 09:30 AM