Back to plugins
Retro HDD LED
v1.0.0 dMopp

About

Retro HDD LED

The HDD light from the front of old PC cases, in your bar: a small LED that blinks while your disks read or write. Use one LED for all disks or one per disk, each either shared for reading and writing or split into a read and a write LED. Hover it to see the current rate per disk.

Bar widget with one read and one write LED per disk

Plugin

Field Value
ID dmopp/retro-hdd-led
Entries Bar widget: led

Usage

Add the bar widget dmopp/retro-hdd-led:led in Settings → Bar, or in your configuration:

[widget.hdd_led]
type = "dmopp/retro-hdd-led:led"

Then put hdd_led into one of the bar's start, center or end lists.

An LED lights for one poll interval whenever its disks read or write, and dims again when they are idle. Hovering the widget shows the read and write rate of each watched disk, averaged over the last second.

Settings

All settings belong to the widget instance.

Setting Type Default Description
mode select combined combined: one shared LED for reading and writing. split: a read LED and a write LED.
per_disk bool false One LED (or read/write pair) for every watched disk instead of one for all of them, in the order of disks, or of disk_order followed by the other disks sorted by name.
disks string_list [] Device names as listed in /proc/diskstats, for example nvme0n1, sda or a partition such as sda1. Empty watches every physical disk.
disk_order string_list [] Disks to show first, in this order, for example nvme1n1 to put that disk before nvme0n1. All other physical disks follow sorted by name, including drives plugged in later. Not used when disks is set.
read_color color primary Color of the shared LED, or of the read LED. A palette role or a #RRGGBB value.
auto_write_color bool true In split mode, color the write LED with a variant of the LED color, mixed toward on_surface: lighter on dark themes, darker on light ones.
write_color color primary Write LED color when auto_write_color is off.
disk_colors string_map {} Colors per disk with per_disk: the disk name maps to one color (read or shared LED) or read,write, for example primary,#FF8800. A disk with only its own read color gets the variant of it as write color.
size int 8 LED diameter in pixels (4-24).
off_brightness int 20 Brightness of an idle LED in percent. 0 hides it until there is activity; its space stays reserved.
glow bool true Soft edge on a lit LED.
poll_ms int 100 How often activity is checked, in milliseconds (30-1000, advanced). Lower values catch shorter bursts.

Notes

  • The widget reads /proc/diskstats once per poll interval and lists /sys/block every 10 seconds to pick up hot-plugged drives. It writes no files, starts no processes and makes no network requests.
  • "Physical disk" means a block device with a backing device (/sys/block/<name>/device). Partitions, loop, zram and device-mapper devices are skipped by default, so the same I/O is not counted twice. Name them in disks to watch them anyway.
  • Cost: one read of /proc/diskstats per poll interval for all disks together, so the number of disks hardly matters. Measured on a desktop at the default 100 ms, the shell used about 2 ms of CPU time per second more with the widget than without it (about 0.2% of one core); parsing takes about 30 µs per poll.
  • Derived colors follow theme changes on the next poll.
  • Kernel names such as nvme0n1 are not guaranteed to stay the same across reboots, so disks, disk_order and disk_colors can point at another drive after a restart. Check the hover tooltip if the LEDs look swapped.
  • The kernel only updates the counters when a request completes, so very short bursts between two polls show as one blink.

Versions

VersionPlugin APIUpdated
v1.0.0 latest31Nov 19, 2026

Older versions stay installable on a Noctalia release whose plugin API is below the latest version's.