📊 Perfmon
A modern, lightweight, and customizable TUI performance monitor for your terminal.
Features • Installation • Usage • Configuration • Contributing
💡 Why Perfmon?
Traditional performance monitors often overwhelm users with information or lack the flexibility to show exactly what you need. Perfmon solves this by providing:
- Consolidation: View output from multiple diagnostic tools (like
top,vmstat,netstat) in one place. - Focus: A clean, tabbed interface lets you switch between different metrics without terminal clutter.
- Visibility: Real-time sparklines provide an immediate "at-a-glance" health check of your system's core resources.
- Flexibility: Don't like the defaults? Bring your own shell commands via a simple TOML file.
✨ Features
- 🚀 Blazing Fast: Written in Go with minimal CPU and memory overhead.
- 📂 Tabbed Navigation: Organize your monitoring tools into logical, navigable views.
- 📈 Live Sparklines: Visual summaries for Load, CPU, Memory, and Network.
- 🎨 Adaptive Themes: Seamlessly toggle between Light and Dark modes.
- ⚙️ Deeply Configurable: Custom commands, refresh intervals, and environment-specific settings.
- 🐧 Cross-Platform: Intelligent defaults for both Linux and macOS.
📸 Screenshots
Dark Mode (Default)
Light Mode
🚀 Installation
📦 Pre-built Binaries
Download the latest pre-compiled binaries from the Releases page.
🛠️ Using go install
go install github.com/sumant1122/Perfmon@latest
🔨 From Source
git clone https://github.com/sumant1122/Perfmon.git
cd Perfmon
make build
# Binary will be in the project root
📖 Usage
Simply run the command to start monitoring with default system tools:
perfmon
⌨️ Key Bindings
| Key | Action |
|---|---|
Tab / Shift+Tab |
Next / Previous Tab |
j / k (or ↓/↑) |
Scroll through command output |
t |
Toggle Light/Dark theme |
v |
Display version information |
q / Esc / Ctrl+C |
Exit Perfmon |
⚙️ Configuration
Perfmon is designed to be personalized. It looks for perfmon.toml in:
$PERFMON_CONFIG~/.config/perfmon/config.toml- Current working directory
📝 Configuration Schema
# Interval for updating the sparklines and default tabs
global_refresh_interval = "5s"
[[tab]]
title = "Process Explorer"
cmd = ["top", "-b", "-n", "1"]
refresh_interval = "2s" # Specific interval for this tab
[[tab]]
title = "Network Connections"
cmd = ["ss", "-tulpn"]
🛠 Development
We utilize a simple Makefile for a streamlined development experience:
make run: Start the application in development mode.make build: Compile the binary.make test: Execute the test suite.make lint: Run the golangci-lint (if installed).
🤝 Contributing
We love contributions! Whether it's a bug report, a new feature idea, or a documentation improvement, please feel free to:
- Check out the Contributing Guidelines.
- Open an Issue.
- Submit a Pull Request.
📜 License
Distributed under the MIT License. See LICENSE for details.