Version 2.0

📦 Release v2.0 – Major Refactor & Feature Expansion

Date: 2025-07-08

A major update of the Raspberry Pi Telegram Bot with a modular codebase, enhanced security, system monitoring, and robust remote command support.

---

✨ Features

• 🔒 Secure Command Execution
  Whitelisted command execution with validation, pattern checks, and sandboxing.

• 🌡️ Temperature Monitoring
  Real-time CPU temperature display with alert capability.

• 📊 System Monitoring
  View CPU, memory, and disk usage via /system and /status.

• 💻 Remote Shell Execution
  Run allowed commands on your Pi from Telegram using /cmd <command>.

• 🤖 PTB v20+ Support
  Upgraded to python-telegram-bot v20 with ApplicationBuilder and JobQueue.

• 🗂️ Modular Structure
  Code split into config/, modules/, and clean main.py entry point.

---

🧭 Setup Instructions

📄 Key files and documentation:

• README.md – Full usage, commands, and structure
• docs/installation_guide.md – Step-by-step setup
• docs/initial_setup.txt – What you need before installation
• docs/troubleshooting.md – Common errors and fixes

---

🛡 Security Improvements

• ✅ Only safe, whitelisted commands can run
• ❌ Blocks dangerous patterns like rm -rf /, mkfs, dd, etc.
• ⏱ Built-in timeout handling and safe working directory

---

📁 Project Structure

raspberrypi-telegram-bot/
├── config/
│ └── config.py
├── docs/
│ ├── installation_guide.md
│ ├── initial_setup.txt
│ └── troubleshooting.md
├── logs/
│ └── bot.log
├── modules/
│ ├── command_executor.py
│ ├── system_monitor.py
│ └── temp_monitor.py
├── .gitignore
├── CHANGELOG.md
├── main.py
└── pi-telegram-bot.service

---

💬 Commands

• /temp – Show temperature
• /system – System resource summary
• /cmd <command> – Run a safe command
• /help – List available commands

---

⚠ Known Notes

• Bot has a slight startup delay (~30–60 seconds) after reboot for network readiness

---

📥 Feedback & Issues

Have questions, feature ideas, or bugs to report?
👉 Open an issue on GitHub