KRaidMonitor Plasmoid

KRaidMonitor is a KDE Plasma widget that monitors the status of RAID arrays on your system. It provides a quick and easy way to check the health of your RAID setup directly from your desktop.

Note: All code in this project was generated using AI assistance as a personal experiment.

Screenshots

Healthy	Degraded	Syncing

Hovering the widget adds a tooltip naming each member disk and its state, which is what identifies which disk dropped out of a degraded array.

Features

• Automatically detects RAID arrays on your system
• Displays the current status of the selected RAID array
• Signals the state with a colour-coded emblem (OK, Syncing, Degraded, Error)
• Shows the RAID level and the number of working disks
• Shows progress, transfer rate and an estimated time remaining while an array is rebuilding
• Lists every member disk and its state in the tooltip
• Sends a desktop notification when the array state changes (can be turned off)
• Works on the desktop and in a panel
• Configurable update interval, and a picker when several arrays are present
• Translated into French; other languages welcome

Requirements

• KDE Plasma 6 or higher
• Qt 6.5 or higher
• KDE Frameworks 6 or higher
• CMake 3.16 or higher
• Extra CMake Modules (ECM)

Installation

Option 1: Install from Debian Package (Recommended)

1. Download the latest .deb package from the releases page

2. Install the package:

   sudo dpkg -i plasma-kraidmonitor_*.deb
   sudo apt-get install -f  # Install any missing dependencies

3. Restart the Plasma shell:

   kquitapp6 plasmashell && kstart plasmashell

Option 2: Build and Install from Source

1. Make sure you have the required dependencies installed. On Debian/Ubuntu, you can install them with:

   sudo apt install cmake extra-cmake-modules plasma-sdk qt6-base-dev qt6-declarative-dev qt6-tools-dev libplasma-dev libkf6i18n-dev libkf6service-dev libkf6package-dev plasma-workspace-dev qt6-base-private-dev qt6-declarative-private-dev

2. Clone the repository:

   git clone https://github.com/hleroy/plasma-kraidmonitor.git
   cd plasma-kraidmonitor

3. Create a build directory and run CMake:

   mkdir build
   cd build
   cmake ..

4. Build the plasmoid:

   make

5. Install the plasmoid:

   sudo make install

6. Restart the Plasma shell:

   kquitapp6 plasmashell && kstart plasmashell

Usage

1. Right-click on your desktop or panel and select "Add Widgets"

2. Search for "RAID Monitor" and add it to your desktop or panel

3. The widget will automatically detect and monitor your RAID arrays To configure the update interval:

• Right-click on the widget and select "Configure RAID Monitor"
• Adjust the "Update interval" setting as desired
• Untick "Notify when the array state changes" to silence notifications, or fine-tune each event (degraded, error, syncing, healthy) in System Settings → Notifications

Troubleshooting

To see errors in the console, use the plasmoid viewer. Run it from the root of the repo to load the widget straight from the source tree, without installing it:

plasmoidviewer -a ./package

To check the installed copy instead, pass the plugin id — useful when the widget works from source but fails after installation:

plasmoidviewer -a org.kde.plasma.kraidmonitor

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is dedicated to the public domain under the Creative Commons CC0 1.0 Universal (CC0 1.0) Public Domain Dedication.

You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.

For more information about CC0, visit: https://creativecommons.org/publicdomain/zero/1.0/