https://github.com/itsalexik/corewatch
Real-time Raspberry Pi system stats in Discord via embeds – CPU, RAM, disk, uptime & more.
https://github.com/itsalexik/corewatch
discord-bot discordjs hardware-monitoring linux-monitoring nodejs performance-monitor raspberry-pi real-time-status system-monitoring systeminformation
Last synced: 4 months ago
JSON representation
Real-time Raspberry Pi system stats in Discord via embeds – CPU, RAM, disk, uptime & more.
- Host: GitHub
- URL: https://github.com/itsalexik/corewatch
- Owner: ItsAlexIK
- License: mit
- Created: 2025-06-02T13:44:54.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-09-06T19:53:27.000Z (5 months ago)
- Last Synced: 2025-09-06T21:35:16.727Z (5 months ago)
- Topics: discord-bot, discordjs, hardware-monitoring, linux-monitoring, nodejs, performance-monitor, raspberry-pi, real-time-status, system-monitoring, systeminformation
- Language: JavaScript
- Homepage:
- Size: 221 KB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🖥️ Discord System Monitor Bot
[](LICENSE)
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.
## ✨ Features
- Live system stats updated in real time
- Details include:
- 🧠 RAM usage
- 🔥 CPU temperature
- ⚙️ CPU usage
- 💾 Disk space used
- ⏱️ System uptime
- `/htop` command to display an interactive process list directly in Discord (like the Linux `htop`)
## 💻 `/htop` Command
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
## 🛡️ Permission Restriction for `/htop` Command
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`](./src/commands/htop.js).
To customize which user can execute the command, update the `ALLOWED_USER_ID` constant in the command's code:
```js
const ALLOWED_USER_ID = "123456789012345678"; // REPLACE WITH YOUR USER ID
```
## 📦 Requirements
- Node.js 18 or higher
- A Discord bot token
- A Raspberry Pi 5 (or any Linux system with `/proc` access)
## 🔧 Setup
1. Clone the repository:
```
git clone https://github.com/ItsAlexIK/CoreWatch.git
cd CoreWatch
npm install
```
2. Create a `.env` file 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
```
3. Run the bot:
```
node index.js
```
## 🚀 Auto-run at Startup (systemd)
Set the bot to start automatically on boot.
1. Create the service file
```
sudo nano /etc/systemd/system/corewatch.service
```
2. 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
```
3. Enable and start the service
```
sudo systemctl daemon-reload
sudo systemctl enable corewatch.service
sudo systemctl start corewatch.service
```
4. Verify it is running
```
systemctl status corewatch.service
```
5. 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
```
## 📬 Connect
- [Discord](https://discord.com/users/551023598203043840)
- [GitHub](https://github.com/ItsAlexIK)
---
> Made with ❤️ by ItsAlexIK