monitorify 1.0.0__py3-none-any.whl

monitorify-1.0.0.dist-info/METADATA

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: monitorify
+Version: 1.0.0
+Summary: A lightweight Linux terminal system monitor built with Textual
+Author: Leon
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: textual>=0.80.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: rich>=13.0.0
+
+# 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](https://github.com/Textualize/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
+
+```bash
+# 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](INSTALL.md)**.
+
+---
+
+## Usage
+
+### Dashboard
+
+```bash
+monitorify
+```
+
+| Key | Action |
+|-----|--------|
+| `m` | Open settings menu (toggle widgets, set intervals, change history window) |
+| `q` / `c` | Quit |
+
+### Standalone Background Daemon
+
+```bash
+monitorify-daemon
+```
+
+Metrics are written to `~/.local/share/monitorify/monitorify.db` continuously.
+
+---
+
+## Configuration & Paths
+
+Monitorify follows XDG base directory conventions:
+
+| Purpose | Default Path | Environment Variable |
+|---|---|---|
+| **Database** | `~/.local/share/monitorify/monitorify.db` | `MONITORIFY_DB_PATH` |
+| **Daemon PID** | `/run/user/<uid>/monitorify/daemon.pid` | `MONITORIFY_PID_PATH` |
+| **Interval** | `1.0` seconds | `MONITORIFY_INTERVAL` |
+| **Retention** | `604800` seconds (7 days) | `MONITORIFY_RETENTION` |
+
+---
+
+## 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

monitorify-1.0.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+monitorify/__init__.py,sha256=psHkEBeeNO6jwcBz7lS3gl2AJgnSTYJqNxJHzCrCKhA,87
+monitorify/__main__.py,sha256=bKJzxXT3Yn6rVYu7gSSRdTzuAR2hlgFSJhEfJ0DnvYU,70
+monitorify/config.py,sha256=1026EW5U2SIACu9e66cqN9qjA2UY905zfwd6lVcD4O0,896
+monitorify/daemon.py,sha256=O89f2mcKLLcdIXSaxEAvuDquXyja8QpsTgOFQBOS4lQ,820
+monitorify/main.py,sha256=sDXQfogIyNlsyxtRBVpkrMXcaIgXVgo5QVGPwODUTNg,1466
+monitorify/collector/__init__.py,sha256=pt5NziT2A1Gx-_pBEq9UR90hqBgy1h-VIrta_eNnMKE,176
+monitorify/collector/manager.py,sha256=qf78Fkfct4MrDYq2x7B26IBW-6AOUJFXG5J9CJtcHKQ,1327
+monitorify/collector/schema.py,sha256=nLwMAKCW-Mzms9eCDPkVUu9uYREJwlj6AVJJFoCe2F4,543
+monitorify/collector/worker.py,sha256=YdP79N_CzlVpJJ4YeNG39_codaqtv1erjEummE8SSqs,1468
+monitorify/stats/DiskStats.py,sha256=O6N5pH8LjhdH83lLiJJs0Q4Bh3EkzC7ezxlgOgXsCS0,3427
+monitorify/stats/__init__.py,sha256=1bT6VPgszr0gnPJGrDPFwN_2ZH74btZqwbiQTzrd9js,15
+monitorify/stats/cpuStats.py,sha256=N_syGNntv9B6x7sYeftHO3NSeqTj6a69idedDAt8qi4,1526
+monitorify/stats/networkStats.py,sha256=Htz04mO7TZze2gkExCcAYRfFKcaBk3aA6lX3m-ZTZmM,1851
+monitorify/stats/programmList.py,sha256=xQhhqhoLOIX8jstN8VbgB-CBvV3aoLuz8i7wlrBOfJw,8512
+monitorify/stats/ramStats.py,sha256=CeyQm-aglBe_k349YUPDdX6Jy8EfJqHBTKC1bN4KTG4,680
+monitorify/storage/__init__.py,sha256=chS3ql6Pxt2o4ClboFIv2wghMzW6Xkp5RVNV760Q2Hk,49
+monitorify/storage/db.py,sha256=Ryvy6uuUiolbDn9O8wjhCjQhcwZfocPt_lUpr878oXA,5862
+monitorify/ui/__init__.py,sha256=1bT6VPgszr0gnPJGrDPFwN_2ZH74btZqwbiQTzrd9js,15
+monitorify/ui/tui/__init__.py,sha256=1bT6VPgszr0gnPJGrDPFwN_2ZH74btZqwbiQTzrd9js,15
+monitorify/ui/tui/tui.py,sha256=ZhWU3SfGpb3lhwkmt7rjcnus_etnL7mCYkWjQaRS-Lo,6838
+monitorify/ui/tui/components/menu.py,sha256=Jp2Lx0HY-JoIKCTosL_FxfYjIwQc5MkR73T0P-hJshg,7107
+monitorify/ui/tui/components/widgetManager.py,sha256=7vIyMlNR_Cu_NsZAZDskmTsMX935KsCae06gmlDAC2o,1463
+monitorify/ui/tui/css/tui.css,sha256=NtsRUKcKmg1GnPW2nP6vJk6MvaHOqo6fvHxYYqu6Tac,2585
+monitorify/ui/tui/widgets/__init__.py,sha256=ODVJfnqyITKxADGgw965AVRkvmYhQjmt67rWOElgsSY,60
+monitorify/ui/tui/widgets/brailleGraph.py,sha256=CM7fjsLGQMcJiqhAG3pM8PjidTllSBoNhvKx60X4yPc,9747
+monitorify/ui/tui/widgets/cpuWidget.py,sha256=FnDurECbZE_Yp12eVzYaY8oc_GAEH7glLQvQYxo15Dc,1817
+monitorify/ui/tui/widgets/diskWidget.py,sha256=6tvdgT7KUXKLxyCADqab4d-BQ34Jwnnb9h9klzuort4,7889
+monitorify/ui/tui/widgets/networkWidget.py,sha256=CbtVMYzd3rX1zEtLunFsIqc4zlotRYZ1cj2fPhLaZ_s,3583
+monitorify/ui/tui/widgets/procInfoWidget.py,sha256=HpFx3RF1CbLylu7cQi68wXJL6T_n2uFWuSgtMtVDifE,1477
+monitorify/ui/tui/widgets/programmListWidget.py,sha256=Ixpr0f8rIiYmVt9TcKT4nv1oq0Lpyh4G_thWvmi9P5I,7693
+monitorify/ui/tui/widgets/ramWidget.py,sha256=oBAzUwoZxuehzz7uSxxiddbw6UK8E2FDU9OcEOHB_qM,1348
+monitorify/ui/tui/widgets/statusWidget.py,sha256=tS53_NjtcGMpsC6ObzYyXxju9qqPHmX9UzRJOLj9INg,1323
+monitorify-1.0.0.dist-info/METADATA,sha256=fanFc-m0hNmLlEH8SNk6UbC1V2Imp4uG0KOaNz7RMQA,5546
+monitorify-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+monitorify-1.0.0.dist-info/entry_points.txt,sha256=NlD0O3HWpLLLyEtfpfKtuIEslOIAoRRLYVcmOuXkq2I,94
+monitorify-1.0.0.dist-info/top_level.txt,sha256=Jxgi5DbtU9-ZYlCCHlR312EkxZNmt7QstM9_I9DJKqM,11
+monitorify-1.0.0.dist-info/RECORD,,

monitorify-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

monitorify-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+monitorify = monitorify.main:cli
+monitorify-daemon = monitorify.daemon:main

monitorify-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+monitorify