Repository navigation
v0.4
HPR Idle Detection Extension v0.4
Available on HPR-Store
Hey everyone! π Welcome to v0.4 of the HPR Idle Detection Extension!
This release brings full native support for KDE Plasma 6, a major architectural overhaul to Wayland idle handling to eliminate timer drift and false resumes, updated HPR version compatibility, and refined defaults.
π What's New in v0.4
π KDE Plasma 6 Support Added
KDE Plasma 6 (Wayland) is now officially supported! The extension binds directly to KWin via ext-idle-notify-v1 and integrates with KWinβs input tracking to monitor user activity cleanly and reliably.
β‘ Wayland Idle Detection Overhaul
- Direct Threshold Tracking: Instead of hardcoding a 1-second dummy interval and guessing elapsed time in client space, the extension now configures the idle threshold directly with the Wayland compositor.
- Hardware-Only Input Tracking (Version 2+): On compositors supporting protocol version 2+ (such as KWin on KDE Plasma 6), the extension now leverages
get_input_idle_notification. This tracks pure keyboard/mouse hardware input and prevents falseresumedtriggers caused by application state changes, window focus updates, or idle inhibitors. - Dynamic Configuration Updates: If you adjust
idle-thresholdinidle_detection_config.csv, the native Wayland worker thread is notified via an internal pipe to update the active threshold on the fly without needing an app restart. - Backwards Compatibility: Version 1 compositors (Hyprland, Sway, niri) continue to work smoothly with automatic fallback to standard idle notifications.
β±οΈ Updated Default Threshold & HPR Version Support
- Default idle threshold updated to 5 minutes (
300000ms) for faster out-of-the-box idle management. - Extended HPR compatibility list to support v0.9.7, v0.9.8, v0.9.9, and v0.9.10.
π₯οΈ Platform Support Matrix
| Platform / Desktop Environment | Support Status | Backend / Technology |
|---|---|---|
| Windows | β Supported | Win32 GetLastInputInfo |
| Linux (GNOME) | β Supported | Mutter D-Bus org.gnome.Mutter.IdleMonitor |
| Linux (Cinnamon) | β Supported | Muffin D-Bus org.cinnamon.Muffin.IdleMonitor |
| Linux (KDE Plasma 6) | β Supported | Wayland ext-idle-notify-v1 (v2 input notification) |
| Linux (Hyprland / niri / Sway) | β Supported | Wayland ext-idle-notify-v1 protocol |
Note
X11 non-GNOME sessions (e.g., standalone i3, Openbox on X11) will load successfully, but idle detection will default to active. Wayland sessions and GNOME/Cinnamon desktop environments are recommended on Linux.
π¦ What's in the Release Zip?
Extract HPR_Idle_Detection_Extension.zip directly into your HPR extensions directory:
- Windows:
%APPDATA%\HPR\HPR_Config\extensions\HPR_Idle_Detection_Extension\ - Linux:
~/.config/HPR/HPR_Config/extensions/HPR_Idle_Detection_Extension/(or~/.config/HPR/extensions/HPR_Idle_Detection_Extension/depending on your version)
Files Included:
idle_detection.lua(Lua entrypoint)HPR_Idle_Detection_Extension.so(Linux shared library)HPR_Idle_Detection_Extension.dll(Windows dynamic link library)idle_detection_config.csv(Configuration file)
βοΈ How to Configure Idle Timeout
Edit idle_detection_config.csv in your extension directory. Values are specified in milliseconds:
idle-threshold,300000
poll-interval,5000