plasmoides KDE Store/GitHub (gnome-pager, kMenu, kvitals, windowtitle, claude, launchpad)

2026-07-08 20:47:59 +02:00
parent ca606377ee
commit dd3b0f6ae8
136 changed files with 20239 additions and 0 deletions
@@ -0,0 +1,105 @@
+# KVitals
+
+A lightweight KDE Plasma 6 panel widget that displays live system vitals directly in your top bar.
+
+```
+CPU: 26%  |  RAM: 8.8/39.0G  |  TEMP: 96°C  |  🔋BAT: 78%  |  PWR: +20W  |  NET: ↓82.2K ↑58.9K
+```
+
+## Screenshots
+
+<div align="center">
+  <img src="screenshots/demo.gif" alt="Demo">
+</div>
+
+## Features
+
+- **Live monitoring** — CPU usage, RAM, CPU temperature, GPU metrics (when available), battery status, power draw, network speed, disk I/O, fan speeds
+- **Display modes** — Text, Icons, Icons + Text, or None (values only) for the panel view
+- **Custom icons** — Pick any icon from your installed theme for each metric
+- **Font customization** — Choose any system font and size
+- **Configurable** — Toggle each metric, adjust refresh rate, tune colors, organized in 4 settings tabs
+- **Minimal footprint** — Native KDE KSysGuard sensors + QML, no heavy dependencies or excessive subprocesses
+- **Click to expand** — Detailed popup view with all stats
+
+## Requirements
+
+- KDE Plasma 6.0+
+
+## Installation
+
+### KDE Store (Recommended)
+
+Install directly from the KDE Store:
+
+👉 **[Get KVitals on the KDE Store](https://www.pling.com/p/2347917/)**
+
+Or from within KDE Plasma:
+
+1. Right-click on the panel → **Add Widgets...**
+2. Click **Get New Widgets...** → **Download New Plasma Widgets...**
+3. Search for **"KVitals"**
+4. Click **Install**
+
+---
+
+### Quick Install (curl)
+
+```bash
+curl -fsSL https://github.com/yassine20011/kvitals/releases/latest/download/install-remote.sh | bash
+```
+
+### Quick Install (wget)
+
+```bash
+wget -qO- https://github.com/yassine20011/kvitals/releases/latest/download/install-remote.sh | bash
+```
+
+### Manual Install
+
+```bash
+git clone https://github.com/yassine20011/kvitals.git
+cd kvitals
+bash install.sh
+```
+
+Then restart Plasma and add the widget:
+
+```bash
+plasmashell --replace &
+```
+
+1. Right-click on the panel → **Add Widgets...**
+2. Search for **KVitals**
+3. Drag it onto your panel
+
+## Configuration
+
+Right-click the widget → **Configure KVitals...** to access settings in four tabs:
+
+- **General** — Display mode, layout, icon size, font, update interval
+- **Metrics** — Toggle CPU, RAM, Temperature, GPU, Battery, Power, Network, Disk, Fan
+- **Icons** — Customize icons for each metric from your theme
+- **Colors** — Set custom font colors and optional threshold-based metric colors
+
+See the [full configuration reference](docs/configuration.md) for details.
+
+## Uninstall
+
+```bash
+rm -rf ~/.local/share/plasma/plasmoids/org.kde.plasma.kvitals
+```
+
+Then restart Plasma: `plasmashell --replace &`
+
+## Documentation
+
+- [Installation](docs/installation.md)
+- [Configuration](docs/configuration.md)
+- [Architecture](docs/architecture.md)
+- [Contributing](docs/contributing.md)
+- [Troubleshooting](docs/troubleshooting.md)
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [GPL-3.0 License](LICENSE).