Skip to content

A lightweight, terminal-based Linux Process Monitor

License

Notifications You must be signed in to change notification settings

3rr0r-505/HawkPro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HawkPro - Terminal-based Linux Process Monitor

Language Standard Build Compiler Platform Type Interface Data Source Docker

⚡ Overview

HawkPro is a lightweight, terminal-based Linux process monitoring tool built with C++ and ncurses. It delivers real-time CPU and memory insights through a clean, keyboard-driven interface while maintaining minimal system overhead.


✨ Features

  • ⚡ Real-time CPU and memory monitoring
  • 📊 Dynamic process sorting (CPU / Memory / User)
  • 🔍 Process search (Ctrl + F)
  • ⬆⬇ Arrow key navigation
  • 📖 Built-in man page
  • 🐳 Optional Docker support

🛠 Tech Stack

Component Technology
Language C++
Standard C++17
UI ncurses
Data Source Linux /proc filesystem
Build System CMake

🚀 Installation

One-Line Bootstrap (Recommended ⭐)

wget https://github.com/3rr0r-505/HawkPro/raw/main/installer.sh
chmod +x installer.sh
sudo bash installer.sh

🐳 Docker Usage

docker build --no-cache -t hawkpro .
docker run -it --rm --pid=host --net=host -v /proc:/proc hawkpro

⚠️ Docker Note: When running inside Docker, HawkPro may detect containerized system information instead of the physical host due to Linux namespace isolation. For best accuracy and performance → run natively on Linux.

🛠 Build From Source

git clone https://github.com/3rr0r-505/HawkPro.git
cd HawkPro

mkdir build && cd build
cmake ..
make

./hawkpro

🎮 Controls

Key Action
C / c Sort by CPU
M / m Sort by Memory
U / u Sort by User
Ctrl + F Search process
Arrow Keys Navigate
Q / q Quit

📄 License

This project is licensed under Apache License 2.0. Free to use, modify, and learn from.

❤️ Support

If you like this project, consider giving it a ⭐ on GitHub!