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"> <br><br> <img src="screenshots/general_settings.png" alt="General Settings"> <img src="screenshots/metrics_settings.png" alt="Metrics Settings"> <img src="screenshots/icons_settings.png" alt="Icons Settings"> </div>

Features

• Live monitoring — CPU usage, RAM, CPU temperature, GPU metrics (when available), battery status, power draw, network speed
• Display modes — Text, Icons, or Icons + Text 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, organized in 3 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

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)

curl -fsSL https://github.com/yassine20011/kvitals/releases/latest/download/install-remote.sh | bash

Quick Install (wget)

wget -qO- https://github.com/yassine20011/kvitals/releases/latest/download/install-remote.sh | bash

Manual Install

git clone https://github.com/yassine20011/kvitals.git
cd kvitals
bash install.sh

Then restart Plasma and add the widget:

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 three tabs:

• General — Display mode, icon size, font, update interval
• Metrics — Toggle CPU, RAM, Temperature, Battery, Power, Network
• Icons — Customize icons for each metric from your theme

See the full configuration reference for details.

Uninstall

rm -rf ~/.local/share/plasma/plasmoids/org.kde.plasma.kvitals

Then restart Plasma: plasmashell --replace &

Project Structure

kvitals/
├── metadata.json                   # Plasmoid metadata
├── install.sh                      # Local install script
├── install-remote.sh               # Remote install (curl/wget)
├── CHANGELOG.md                    # Version history
├── docs/                           # Documentation
│   ├── installation.md
│   ├── configuration.md
│   ├── architecture.md
│   ├── contributing.md
│   └── troubleshooting.md
└── contents/
    ├── config/
    │   ├── config.qml              # Tab registration
    │   └── main.xml                # Config schema
    └── ui/
        ├── main.qml                # Widget orchestrator
        ├── CompactView.qml         # Panel representation
        ├── FullView.qml            # Popup representation
        ├── configGeneral.qml       # General settings tab
        ├── configMetrics.qml       # Metrics settings tab
        ├── configIcons.qml         # Icons settings tab
        └── sensors/                # Sensor modules
            ├── qmldir              # QML module definition
            ├── CpuSensors.qml      # CPU usage
            ├── MemorySensors.qml   # RAM usage
            ├── TempSensors.qml     # CPU temperature
            ├── GpuSensors.qml      # GPU usage, VRAM, temp
            ├── BatterySensors.qml  # Battery & power
            ├── NetworkSensors.qml  # Network speed
            └── Utils.qml           # Shared formatting helpers

Documentation

• Installation
• Configuration
• Architecture
• Contributing
• Troubleshooting

License

By contributing, you agree that your contributions will be licensed under the GPL-3.0 License.