Skip to content
This repository was archived by the owner on Oct 26, 2026. It is now read-only.

v0.4

Choose a tag to compare

@plexescor plexescor released this 20 Sep 09:15
· 5 commits to main since this release

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 false resumed triggers caused by application state changes, window focus updates, or idle inhibitors.
  • Dynamic Configuration Updates: If you adjust idle-threshold in idle_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 (300000 ms) 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