Monitorify

A lightweight system monitor that runs right in your terminal. It tracks CPU usage, memory consumption, network activity, disk metrics, and process states in real time with historical graphing — no bloated dependencies, just a clean, high-performance TUI dashboard.

Built with Python and Textual. Reads directly from /proc and /sys for lightning-fast, native performance on Linux.

Features

• CPU & System Info — Live CPU percentage, multi-timeframe braille graphing, OS kernel, hostname, and system uptime.
• Memory (RAM) — Real-time memory utilization, percentage, and historical graph.
• Network Throughput — Split-view upload/download graph with current speed, peak throughput, and total transferred bytes.
• Disk Metrics — I/O activity rates (reads/writes) and storage capacity breakdown for physical disks.
• Process Monitor — Interactive list of running processes with CPU/RAM metrics, process state, uptime, and real-time inspector.
• Background Collector Daemon — Lightweight collector logging metrics to an SQLite database (~/.local/share/monitorify/monitorify.db) with automatic pruning.
• Customizable Menu (m) — Toggle widget visibility, adjust collection frequency, and set history graph duration (1m, 5m, 10m, 30m, 1h, or custom durations like 2h, 1d).

Quick Start

# Recommended — isolated install via pipx
pipx install git+https://github.com/leonst036/Monitorify.git

# Then launch the dashboard
monitorify

For full installation options (pip, source, systemd daemon) see INSTALL.md.

Usage

Dashboard

monitorify

Standalone Background Daemon

monitorify-daemon

Metrics are written to ~/.local/share/monitorify/monitorify.db continuously.

Configuration & Paths

Monitorify follows XDG base directory conventions:

Project Structure

Monitorify/
├── pyproject.toml               # Package build configuration & entry points
├── README.md                    # This file
├── INSTALL.md                   # Full installation guide
├── main.py                      # Developer entrypoint shim
├── src/
│   └── monitorify/
│       ├── __init__.py          # Package metadata (__version__)
│       ├── __main__.py          # python -m monitorify entrypoint
│       ├── config.py            # XDG path handling & environment settings
│       ├── main.py              # Dashboard runner & daemon supervisor
│       ├── daemon.py            # Standalone metrics collector daemon
│       ├── collector/
│       │   ├── manager.py       # Worker lifecycle coordinator
│       │   ├── worker.py        # Background metric collection thread
│       │   └── schema.py        # Dataclass metric structures
│       ├── stats/
│       │   ├── cpuStats.py      # /proc/stat CPU calculator
│       │   ├── ramStats.py      # /proc/meminfo RAM calculator
│       │   ├── networkStats.py  # /proc/net/dev throughput calculator
│       │   ├── DiskStats.py     # /proc/diskstats I/O & storage parser
│       │   └── programmList.py  # /proc process parser & cache thread
│       ├── storage/
│       │   └── db.py            # SQLite metrics storage & historical queries
│       └── ui/
│           └── tui/
│               ├── tui.py       # Main Textual App
│               ├── css/
│               │   └── tui.css  # TUI styling & themes
│               ├── components/
│               │   ├── menu.py          # Settings sidebar component
│               │   └── widgetManager.py # Dynamic grid layout organizer
│               └── widgets/
│                   ├── brailleGraph.py       # High-density Unicode graph
│                   ├── cpuWidget.py          # CPU monitor widget
│                   ├── ramWidget.py          # RAM monitor widget
│                   ├── networkWidget.py      # Network monitor widget
│                   ├── diskWidget.py         # Disk I/O & storage widget
│                   ├── programmListWidget.py # Interactive process list
│                   ├── procInfoWidget.py     # Process details panel
│                   └── statusWidget.py       # Host & kernel status

Requirements

• Python: 3.10+
• OS: Linux (relies on /proc and /sys filesystems)
• Terminal: Minimum 80 columns × 24 lines recommended