LibreWatch

LibreWatch, a free software, allows you to monitor various computer components such as temperature sensors, fan speeds, voltages, load, and clock speeds.

Visual Release

In mid February i'll start working on an Visual Release for LibreWatch

System Requirements

• OS: Linux (kernel 2.6+)
• Compiler: GCC/Clang with C++17 support
• Dependencies: pthread (usually pre-installed)
• Architecture: x86_64, ARM, ARM64

What features does it include?

CPU Monitoring

• Real-time usage percentage with color-coded indicators
• Core count detection
• Temperature reading from thermal sensors (when available)
• Updates every second

Memory (RAM) Monitoring

• Total memory capacity
• Used memory with percentage
• Available memory tracking
• Visual progress bars with status colors

Disk Monitoring

• Monitors all mounted partitions (ext4, ext3, xfs, btrfs, ntfs)
• Shows total, used, and free space
• Usage percentage for each partition
• Disk temperature monitoring (when supported by hardware)
• Automatic detection of mount points

Network Monitoring

• Tracks active network interface (eth0, wlan0, etc.)
• Real-time download speed (bytes/sec)
• Real-time upload speed (bytes/sec)
• Total received bytes since boot
• Total sent bytes since boot

Process Monitoring

• Displays top 15 processes by memory usage
• Shows PID (Process ID)
• Process name truncation for long names
• Memory consumption per process
• User ownership for each process

Installation

Prerequisites

# Debian/Ubuntu
sudo apt-get install build-essential

# Fedora/RHEL
sudo dnf install gcc-c++ make

# Arch Linux
sudo pacman -S base-devel

Build from Source

# Clone or download the project
cd librewatch

# Compile
make

# Run
./librewatch

System-Wide Installation

sudo make install
# Installs to /usr/local/bin/librewatch

# Then run from anywhere:
librewatch

Uninstall

sudo make uninstall

Usage

Quick Start

./librewatch

Troubleshooting

"Permission denied" for temperature sensors

sudo ./librewatch  # Run with elevated privileges

"No such file or directory" errors

• Ensure /proc and /sys are mounted
• Check if running in a container (may have limited access)

Future Enhancements

Potential features for future versions:

• Historical data logging
• Configurable alert thresholds
• Custom configuration file support
• GPU monitoring (NVIDIA/AMD)
• Battery status for laptops
• Network bandwidth graphs
• Per-process CPU tracking
• Remote monitoring capabilities
• Plugin system for extensions

Keyboard Controls

Key	Action
o	Switch to Overview mode
p	Switch to Process mode
d	Switch to Detailed mode
e	Open Export menu
q	Quit application

Known Limitations

• Linux only - Does not support Windows or macOS
• No history - Only real-time data (no graphs or trends)
• No alerts - No notifications for critical thresholds
• No configuration file - All settings are hardcoded
• Local only - Cannot monitor remote systems
• Temperature sensors - May not be available on all hardware
• Process CPU usage - Currently simplified (not per-process tracking

License

LibreWatch is licensed under the nLicensing B License, meaning it can be redistributed on approval