This repository was archived by the owner on Oct 26, 2026. It is now read-only.
Repository navigation
v0.2
HPR Idle Detection Extension v0.2
Hey everyone! π We're excited to release v0.2 of the HPR Idle Detection Extension!
This release brings full cross-platform support (adding native Windows support alongside Linux), expanded Linux desktop environment compatibility (including Cinnamon), and cleaner configuration handling.
π What's New in v0.2
πͺ Full Windows Support Added
- Windows support is now fully live! Uses Win32's
GetLastInputInfoAPI to track system idle time accurately across all Windows versions.
π§ Expanded Linux Support
- GNOME & Cinnamon: Native support via Mutter/Muffin D-Bus idle interfaces.
- Wayland Compositors: Full support for Hyprland, niri, Sway, and any Wayland compositor supporting the standard
ext-idle-notify-v1protocol.
βοΈ Auto-Config Initialization
- Auto-generates
idle_detection_config.csvwith a default 8-minute (480000ms) threshold if the config file is missing on first launch.
π₯οΈ 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 (Hyprland / niri / Sway) | β Supported | Wayland ext-idle-notify-v1 protocol |
| Linux (KDE Plasma) | β Not Supported Currently | β |
β οΈ Note on KDE & X11: KDE Plasma is currently not supported. Only Wayland (Hyprland, niri, Sway) and GNOME/Cinnamon desktop environments are supported on Linux. X11 non-GNOME sessions (e.g. i3, Openbox on X11) will load but idle detection will default to "active".
π¦ 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/
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 the extension directory:
idle-threshold,480000