chronotasker 0.1.0

Real‑time system monitor and task manager TUI

ChronoTasker

MIT License

Python 3.8+

Textual

ChronoTasker is a real‑time system monitor and task manager built with Python and Textual. It provides a beautiful TUI dashboard that displays live CPU, RAM, GPU, storage, uptime, and disk usage, along with a process manager and user‑configurable modes.

Dashboard preview showing system metrics and process monitoring [citation:5].

---

✨ Features

• Live system metrics – CPU, RAM, GPU (real utilization when vendor libraries available), storage free space, system uptime, and disk load.
• Process manager – Automatically splits processes into "Apps" (>150 MB) and "Background" (≤150 MB) with live CPU/Memory updates.
• Three configurable modes:
  • Safe Mode – Freezes data collection to save CPU.
  • Debug Mode – Shows a debug log (e.g., detected GPU name).
  • Beta Mode – Placeholder for experimental features.
• Memory cleaner – Triggers Python garbage collection; on Linux with superuser privileges, also drops kernel caches.
• Theme toggle – Switch between light and dark themes with a single key (d).
• GPU detection – Uses PyOpenCL to identify your GPU (displayed in debug log). Real utilization is attempted via gpuinfo, pynvml, or pyadl, falling back to a random placeholder.

Settings panel with mode toggles [citation:2].

---

📦 Installation

From Source

git clone https://github.com/TheLostIdea1/chronotasker.git
cd chronotasker
pip install -e .

Direct Install (once published)

pip install chronotasker

Dependencies

• Required: textual, psutil, pyopencl
• Optional (for real GPU utilization):
  • gpuinfo – NVIDIA, AMD, Intel
  • nvidia-ml-py – NVIDIA only
  • pyadl – AMD only

---

🚀 Usage

After installation, run:

chronotasker

Or from Python:

import chronotasker
chronotasker.start()

Key Bindings

Key	Action
h	Jump to Help screen
d	Toggle dark mode
q	Quit the application

---

📁 Project Structure

chronotasker/
├── chronotasker/
│   ├── __init__.py
│   └── app.py
├── tests/
│   └── test_app.py
├── LICENSE
├── README.md
└── setup.py

---

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request.

---

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

---

Made with ❤️ by TheLostIdea1