🖥️ System Monitor - Python Engine

A lightweight, real-time system monitoring dashboard written in Python. Displays network information, system resources, and uptime in a colorful, animated terminal interface.

No dependencies beyond Python 3 and standard Unix tools. Cross-platform (Linux).

---

📋 Features

• Real-time Dashboard - Live system information with 2-second refresh intervals
• Geolocation - Display public IP, city, country, and ISP
• Resource Monitoring - Memory usage, disk space, system uptime
• Beautiful UI - ANSI colors, ASCII art, animated banner
• Lightweight - No external Python dependencies, uses stdlib only
• Configurable - Environment variables for cycles, interval, offline mode
• Secure - Safe subprocess execution, JSON validation, error handling

---

🚀 Quick Start

⚡ One-Liner Install

For Linux users who want to test immediately:

curl -sSL https://raw.githubusercontent.com/RafaelBatistaDev/neofetch-python-engine/main/install.sh | bash && source ~/.bashrc && monitor

Standard Installation

```bash

Clone the repository

git clone https://github.com/RafaelBatistaDev/neofetch-python-engine.git cd neofetch-python-engine

Run the installer (requires: python3, curl, free, df, uptime, ip, tput)

bash install.sh

Reload your shell

source ~/.bashrc

Run the monitor

monitor ```

Usage

```bash

Default: infinite cycles, 2-second refresh

monitor

Run 10 cycles

MONITOR_CYCLES=10 monitor

Update every 3 seconds

MONITOR_INTERVAL=3 monitor

Offline mode (no geolocation lookup)

MONITOR_OFFLINE=1 monitor

Debug output

MONITOR_DEBUG=1 monitor

Stop anytime

Ctrl+C ```

---

📋 Requirements

• Python 3.6+
• Linux (tested on Fedora, Ubuntu, Debian)
• Standard tools:
  • `curl` - Geolocation API calls
  • `free` - Memory info
  • `df` - Disk usage
  • `uptime` - System uptime
  • `ip` - Network interface detection
  • `tput` - Terminal dimensions

Install Dependencies

Ubuntu/Debian: ```bash sudo apt install curl net-tools bsdmainutils ```

Fedora/RHEL: ```bash sudo dnf install curl net-tools procps-ng ```

Arch Linux: ```bash sudo pacman -S curl net-tools procps-ng ```

---

🔧 Configuration

Environment variables control behavior:

Variable	Default	Description
`MONITOR_CYCLES`	`0` (infinite)	Number of cycles to run
`MONITOR_INTERVAL`	`2`	Refresh interval in seconds
`MONITOR_TIMEOUT`	`2`	API timeout in seconds
`MONITOR_OFFLINE`	`0`	Disable geolocation lookup (1=enabled)
`MONITOR_DEBUG`	`0`	Enable debug logging (1=enabled)
`INSTALL_DIR`	`~/.local/bin`	Custom installation directory

Example: ```bash MONITOR_CYCLES=5 MONITOR_INTERVAL=3 monitor ```

---

🔒 Privacy & Security

Geolocation Data

By default, this tool queries your public IP address to determine location. This request is sent to ip-api.com.

What we send:

• Your public IP address only

What we receive:

• Country, city, ISP information

Privacy Control: ```bash MONITOR_OFFLINE=1 monitor ``` This disables geolocation and shows "Unknown" for location data.

For details, see PRIVACY.md.

Security Notes

• Uses safe subprocess execution (no shell injection)
• Validates all external API responses (JSON schema checking)
• Proper error handling and logging
• No credentials stored or transmitted
• MIT licensed - fully auditable code

---

📂 Project Structure

``` neofetch-python-engine/ ├── src/ │ └── monitor.py # Main Python script ├── tests/ │ └── (test files) ├── install.sh # Installation script ├── README.md # This file ├── CONTRIBUTING.md # Contributing guidelines ├── PRIVACY.md # Privacy policy ├── LICENSE # MIT License ├── requirements.txt # Python dependencies (none) └── .gitignore # Git ignore rules ```

---

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Quick Contribute:

1. Fork the repository
2. Create a feature branch: `git checkout -b feature/my-feature`
3. Commit your changes: `git commit -m "Add my feature"`
4. Test your changes
5. Push to your fork: `git push origin feature/my-feature`
6. Submit a pull request

---

🐛 Known Limitations

• Linux only - Windows/macOS not supported (PRs welcome!)
• Requires shell - Must be bash, zsh, or compatible
• External API - Geolocation requires internet connection
• Terminal width - Requires at least 40 character wide terminal

---

�️ Roadmap

Version 1.x (Current)

• ✅ Real-time system dashboard
• ✅ Geolocation with privacy controls
• ✅ Resource monitoring (CPU, memory, disk)

Version 2.0 (Planned)

• 🔶 Extended system metrics (network I/O, process list)
• 🔶 Configuration file support
• 🔶 Multiple dashboard themes
• 🔶 Historical data logging

Version 3.0+ (Future Vision)

• 📍 C#/.NET Integration - Web dashboard for remote server monitoring
  • Real-time dashboards via ASP.NET Core
  • Multi-server centralized monitoring
  • RESTful API for data integration
  • Windows Server support
  • Cloud provider compatibility (Azure, AWS)

---

�📄 License

This project is licensed under the MIT License - see LICENSE for details.

---

📮 Support

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discussions

---

🙋 Author

Rafael Batista - @RafaelBatistaDev

---

⭐ If you found this useful, please star the repository!