SmartMonitorBot is the ultimate Telegram channel event tracker, crafted with Pyrofork. This beast monitors your supergroups and channels like a cyber hawk, delivering real-time alerts to the owner for every major action. Powered by Client.get_chat_event_log(), it’s your go-to for staying in control. Rule your Telegram empire with style! 🚀

This project is open-source under the MIT License, but do not copy the code without proper attribution. Instead, fork the repository on GitHub and customize it for your needs. If you use any part of this code, give credit to @ISmartCoder and link back to this repository. Respect the hustle and keep it ethical! 🙏

SmartMonitorBot is loaded with features that make it the slickest Telegram monitoring tool:

• Instant Alerts: Get pinged the moment something happens in your channel. No delays, just raw speed. ⚡️
• All-Seeing Event Tracking: Catches every move, including:
  • Title, description, username, or photo changes 📝
  • Invite, signature, or slow mode toggles 🔄
  • Pinned/unpinned messages 📌
  • Edited or deleted messages ✏️🗑️
  • Joins, leaves, or invites 👥
  • Bans, unbans, admin promotions, or demotions 🚨
  • Group calls, sticker sets, linked chats, or location updates 🎙️🌍
  • Subscription extensions or pre-history toggles ❄️
• One-Command Start: Hit /start, and the bot auto-notifies the owner. Zero hassle. 😎
• Deployment Nirvana: Heroku, VPS with screen, or Docker—pick your vibe. 🐳
• Custom Prefixes: Set prefixes like !, ., #, ,, or / via .env. Make it yours. ⚙️
• Bulletproof Config: Validates required env vars to keep things rock-solid. No crashes allowed. 💪

Here’s the full rundown of what SmartMonitorBot tracks (from EVENT_TYPE_MAP):

Here’s the layout of this masterpiece:

SmartMonitorBot/
├── core/                     # Core bot logic 💻
│   └── start.py
├── modules/                  # Notification magic ✨
│   ├── notify.py
│   └── __init__.py
├── utils/                    # Utility spells 🛠️
│   ├── event.py
│   ├── logging_setup.py
│   └── __init__.py
├── sample.env                # Env template 📜
├── app.json                  # Heroku config ⚙️
├── app.py                    # App entry point 🚪
├── config.py                 # Config wizardry 🪄
├── docker-compose.yml        # Docker setup 🐳
├── Dockerfile                # Docker blueprint 📦
├── heroku.yml                # Heroku deployment 📡
├── main.py                   # Main bot engine 🔥
├── Procfile                  # Heroku process 📋
├── requirements.txt          # Dependencies list 📦
├── runtime.txt               # Runtime spec ⚡️
├── start.sh                  # Startup script 🏁
├── user.py                   # User client logic 👤
└── README.md                 # This epic guide 📖

• Python 3.8+ (local or VPS)
• Docker & Docker Compose (for containerized deployment)
• Telegram account with admin rights in your supergroup/channel
• API credentials from my.telegram.org
• Bot token from @BotFather

1. Clone the Repo:

   git clone https://github.com/TheSmartDevs/SmartMonitorBot.git
   cd SmartMonitorBot

2. Configure .env:

   • Copy the sample:

     cp sample.env .env

   • Add your credentials:

     API_ID=your_api_id
     API_HASH=your_api_hash
     BOT_TOKEN=your_bot_token
     SESSION_STRING=your_session_string
     OWNER_ID=your_user_id
     CHANNEL_ID=your_channel_id
     UPDATE_CHANNEL_URL=your_update_channel_url
     COMMAND_PREFIX=!|.|#|,|/
     

3. Install Dependencies:

   • Local/VPS:

     pip install -r requirements.txt

   • Docker handles this automatically.

4. Fire It Up:

   • Local/VPS:

     python main.py

   • VPS with screen (for persistent sessions):

     screen -S SmartMonitorBot
     python main.py

     Detach with Ctrl+A, then D. Reattach with:

     screen -r SmartMonitorBot

   • Docker:

     docker compose up --build --remove-orphans

     Stop it with:

     docker compose down

5. Activate the Bot:

   • Send /start to the bot, and it’ll auto-notify the owner of events. Done deal. ✅

Launch on Heroku with one click:

1. Hit the button above.
2. Fill in your .env vars in Heroku’s dashboard.
3. Deploy and start owning your channel! 👀

1. Install Python and screen:

   sudo apt update
   sudo apt install python3 python3-pip screen

2. Clone the repo and set up .env.
3. Install dependencies:

   pip install -r requirements.txt

4. Run in a screen session:

   screen -S SmartMonitorBot
   python main.py

5. Detach (Ctrl+A, D) and check back with:

   screen -r SmartMonitorBot

1. Install Docker & Docker Compose:

   sudo apt install docker.io docker-compose

2. Clone the repo and configure .env.
3. Build and run:

   docker compose up --build --remove-orphans

4. Shut it down:

   docker compose down

Want to make this bot even crazier? Fork the repo, customize, and submit PRs at GitHub. Keep the code tight, add tests, and respect the ethical warning above. Let’s build something epic together! ✅

This project is licensed under the MIT License. See the LICENSE file for details.

• Owner: @ISmartCoder 💀
• Update Channel: t.me/TheSmartDev 👀

Monitor like a boss with SmartMonitorBot! 🔥