Skip to content

Cross-platform CLI system monitoring tool with color-coded health indicators, watch mode, and process ranking. Written in Rust.

License

Notifications You must be signed in to change notification settings

SoftDryzz/system_monitor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

25 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

System Monitor ๐Ÿ“Š

Rust License Version

System Monitor is a lightweight, cross-platform CLI tool for real-time system monitoring with intelligent scaling and color-coded feedback. Built with Rust for maximum performance and minimal resource usage.

English | Espaรฑol


โœจ Features

  • ๐Ÿ–ฅ๏ธ CPU Monitoring - Intelligent display with compact/detailed modes
  • ๐Ÿ’พ Memory Tracking - RAM usage with visual indicators
  • ๐Ÿ’ฝ Disk Usage - Space usage for all mounted drives
  • ๐Ÿ“Š Process Monitoring - Top processes by CPU and memory
  • ๐ŸŒ Network Statistics - Real-time download/upload speeds
  • ๐ŸŽจ Color-Coded UI - Green/Yellow/Red based on usage levels
  • โฑ๏ธ System Uptime - Track system runtime
  • ๐Ÿ”„ Watch Mode - Continuous real-time updates
  • ๐Ÿš€ Blazing Fast - Native Rust performance
  • ๐ŸŒ Cross-Platform - Windows, Linux, and macOS

๐Ÿš€ Quick Start

Installation

# Clone and build
git clone https://github.com/SoftDryzz/system_monitor.git
cd system_monitor
cargo build --release

# Run
./target/release/sysmon

Or download pre-compiled binaries from Releases.

Basic Usage

# Single snapshot with colors
sysmon

# Detailed view (all CPU cores, more processes)
sysmon --detailed

# Watch mode (continuous updates)
sysmon --watch

# Watch mode with details and custom interval
sysmon --watch --detailed --interval 2

๐Ÿ“Š Example Output

โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚   System Monitor v0.4.0                                 โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

CPU:  34.5% (8 cores)  [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘]    โ† Yellow (moderate)
  Top 3: Core 0 (52%) Core 4 (48%) Core 7 (46%)

Memory:  8.34/16.00 GB (52.1%)  [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘]  โ† Yellow

Disk Usage:
  C:\       450.0/1000.0 GB ( 45.0%)  [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘]  โ† Yellow
  D:\       200.0/ 500.0 GB ( 40.0%)  [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘]  โ† Yellow

Network:
  โ†“ Download: 5.2 MB/s     โ† Green (active)
  โ†‘ Upload:   1.3 MB/s     โ† Green (active)
  Total RX:   2.5 GB
  Total TX:   850 MB

Top 5 Processes (by CPU):
   1. firefox.exe        PID  1234   25.2%    2.5 GB  โ† Red (high CPU)
   2. chrome.exe         PID  5678   15.1%    1.8 GB
   3. Code.exe           PID  9012   10.4%    1.2 GB

Top 3 Processes (by Memory):
   1. chrome.exe         PID  5678   15.1%    2.8 GB  โ† Red (high memory)
   2. firefox.exe        PID  1234   25.2%    2.5 GB

Uptime: 2 days, 0 hours, 32 minutes

๐ŸŽจ Color Coding

Color Usage Level Meaning
๐ŸŸข Green 0-30% Healthy, low usage
๐ŸŸก Yellow 30-70% Normal, moderate usage
๐Ÿ”ด Red 70-100% High usage, attention needed

Applied to: CPU, Memory, Disk, and Process metrics


๐Ÿ’ป Commands

Command Description
sysmon Compact view with colors
sysmon --detailed Detailed view (all cores)
sysmon --watch Continuous updates
sysmon -w -d -i 3 Watch detailed, 3s interval
sysmon --help Show help
sysmon --version Show version

๐Ÿ“ฆ What's New in v0.4.0

๐ŸŒ Network Statistics

  • Real-time download/upload speeds
  • Automatic unit conversion (B/s โ†’ GB/s)
  • Total bytes received/transmitted

๐ŸŽจ Color-Coded UI

  • Visual health indicators throughout
  • Instant feedback on system status
  • Professional terminal appearance

Full Changelog | User Guide


๐Ÿ—บ๏ธ Version History

Version Features
v0.4.0 Network stats, Color-coded UI
v0.3.0 Process monitoring, Intelligent scaling
v0.2.1 Disk usage monitoring
v0.2.0 Watch mode, Continuous updates
v0.1.0 Initial release

๐Ÿ› ๏ธ Development

Build

cargo build --release

Test

cargo test
cargo clippy
cargo fmt

Project Structure

src/
โ”œโ”€โ”€ main.rs              # Entry point
โ”œโ”€โ”€ cli.rs               # CLI parsing
โ”œโ”€โ”€ monitor/
โ”‚   โ”œโ”€โ”€ cpu.rs           # CPU monitoring
โ”‚   โ”œโ”€โ”€ memory.rs        # Memory monitoring
โ”‚   โ”œโ”€โ”€ disk.rs          # Disk monitoring
โ”‚   โ”œโ”€โ”€ network.rs       # Network monitoring
โ”‚   โ”œโ”€โ”€ process.rs       # Process monitoring
โ”‚   โ””โ”€โ”€ system.rs        # System facade
โ””โ”€โ”€ display/
    โ””โ”€โ”€ formatter.rs     # Output formatting + colors

๐Ÿค Contributing

Contributions welcome! See USER_GUIDE.md for details.

  1. Fork the repository
  2. Create feature branch: git checkout -b feature/amazing
  3. Commit changes: git commit -m 'feat: add amazing feature'
  4. Push and create Pull Request

๐Ÿ“„ License

MIT License - see LICENSE file.


๐Ÿ‘ค Author

SoftDryzz


๐Ÿ™ Acknowledgments


โญ Star this project if you find it useful!

About

Cross-platform CLI system monitoring tool with color-coded health indicators, watch mode, and process ranking. Written in Rust.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages