Metadata-Version: 2.4
Name: pulse-monitor
Version: 0.3.2
Summary: A cinematic terminal-based system monitor with Direct OS optimization
Project-URL: Homepage, https://github.com/Fatin-Ishraq/Pulse
Project-URL: Repository, https://github.com/Fatin-Ishraq/Pulse.git
Author-email: Fatin Ishraq <dev@pulse-monitor.io>
License: MIT
License-File: LICENSE
Keywords: cinematic,system-monitor,telemetry,terminal,tui
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Requires-Dist: docker>=6.0.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=2.0.0
Requires-Dist: tomli-w>=1.0.0
Requires-Dist: tomli>=2.0.0; python_version < '3.11'
Provides-Extra: test
Requires-Dist: pytest-asyncio>=0.20.0; extra == 'test'
Requires-Dist: pytest>=7.0.0; extra == 'test'
Description-Content-Type: text/markdown

# ⚡ P U L S E

> *"Not a dashboard. An instrument panel."*

**Pulse** is a cinematic, terminal-based system monitor built for enthusiasts who crave high-density telemetry with a premium aesthetic. Every panel animates; nothing is static. 

Built with the **Direct OS Engine**, Pulse communicates directly with your kernel for high-performance metrics with near-zero overhead.

---

## ✨ Features

- **Direct OS Engine**: High-performance architecture using native OS APIs. No Rust, no complex build tools—just pure, optimized Python.
- **Transcendence mode**: Hit `X` on any focused subsystem to enter an immersive, high-detail view.
- **Neural Insight Engine**: Real-time heuristic analysis of system bottlenecks and resource leaks.
- **Cinematic UI**: Smooth animations, glassmorphism-inspired transparency, and curated color palettes.
- **High-Precision Pulse**: Configurable sampling rates down to 0.2s for micro-stutter detection.

---

## 🚀 Installation

Install directly from PyPI:

```bash
pip install pulse-monitor
```

Then launch from anywhere:

```bash
pulse
```

---

## 🎮 Navigation & Tactical Controls

| Key | Tactical Action |
| --- | --- |
| `Q` | Kill Application Interlock |
| `T` | Cycle UI Theme Palettes |
| `Tab` | Shift Tactical Focus (Forward) |
| `Shift+Tab`| Shift Tactical Focus (Backward) |
| `Arrow Keys`| Spatial Navigation Grid |
| `X` | Enter/Exit **Transcendence View** |
| `F` | Toggle **Data Freeze** (Cryo-lock) |
| `?` / `H` | Toggle Tactical Overlay (Help) |

### 🌀 Transcendence Interaction
When inside a full-screen panel:
- `M` — Toggle **View Mode** (Cinematic vs. Developer)
- `R` — Toggle **Sampling Rate** (Precision Pulse)
- `S` — Cycle **Scaling Mode** (Absolute vs. Auto)
- `Esc` — Return to Master View

---

## 💎 Theming
Pulse comes with 6 curated high-contrast themes to match your terminal's vibe:
`Nord` • `Dracula` • `Monokai` • `Dark` • `Solarized` • `Gruvbox`

---

## 📜 License
MIT © [Fatin Ishraq](https://github.com/Fatin-Ishraq)
