A lightweight Discord bot designed to monitor system stats from a Raspberry Pi 5 (or any Linux-based machine). The bot periodically sends a live system status update to a selected Discord channel, including CPU load, memory usage, temperature, disk usage, and uptime.
- Live system stats updated in real time
- Details include:
- 🧠 RAM usage
- 🔥 CPU temperature
- ⚙️ CPU usage
- 💾 Disk space used
- ⏱️ System uptime
/htopcommand to display an interactive process list directly in Discord (like the Linuxhtop)
Use the /htop command to view a live list of the most resource-intensive processes on your machine.
- Shows unique processes sorted by CPU usage
- Displays:
- 🔹 PID
- 🖥️ CPU usage
- 📊 Memory usage
- Includes interactive buttons to navigate between pages
- Output is styled to be Discord-friendly and readable
The /htop command is restricted to a specific Discord user ID for security reasons. Only the designated user can run this command to view system processes.
The command code is located at src/commands/htop.js.
To customize which user can execute the command, update the ALLOWED_USER_ID constant in the command's code:
const ALLOWED_USER_ID = "123456789012345678"; // REPLACE WITH YOUR USER ID- Node.js 18 or higher
- A Discord bot token
- A Raspberry Pi 5 (or any Linux system with
/procaccess)
- Clone the repository:
git clone https://github.com/ItsAlexIK/CoreWatch.git
cd CoreWatch
npm install
- Create a
.envfile in the project root with the following content:
DISCORD_TOKEN=your-discord-bot-token
DISCORD_CLIENT_ID=client_id_here
DISCORD_GUILD_ID=guild_id_here
DISCORD_CHANNEL_ID=your-discord-channel-id
- Run the bot:
node index.js
Set the bot to start automatically on boot.
- Create the service file
sudo nano /etc/systemd/system/corewatch.service
- Paste and adjust (set WorkingDirectory, ExecStart path to your Node binary if different, and User)
[Unit]
Description=CoreWatch Discord Bot
After=network.target
[Service]
WorkingDirectory=/root/CoreWatch
ExecStart=/usr/bin/node index.js
Restart=always
User=root
Environment=NODE_ENV=production
[Install]
WantedBy=multi-user.target
- Enable and start the service
sudo systemctl daemon-reload
sudo systemctl enable corewatch.service
sudo systemctl start corewatch.service
- Verify it is running
systemctl status corewatch.service
- View logs (Ctrl+C to exit)
journalctl -u corewatch.service -f
To stop:
sudo systemctl stop corewatch.service
To restart after changes:
sudo systemctl restart corewatch.service
Made with ❤️ by ItsAlexIK