Repository navigation
Releases
v0.5.1
HPR Idle Detection Extension v0.5
Available on HPR-Store
Hey everyone! 👋 Welcome to v0.5.1 of the HPR Idle Detection Extension!
This release brings support for HPR v0.9.12 .
🌟 What's New in v0.5.1
HPR Version Support
- Extended HPR compatibility list to support v0.9.7, v0.9.8, v0.9.9, v0.9.10, v0.9.11. v0.9.12.
🖥️ 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,5000v0.5
HPR Idle Detection Extension v0.5
Available on HPR-Store
Hey everyone! 👋 Welcome to v0.5 of the HPR Idle Detection Extension!
This release brings support for HPR v0.9.11 and action button wiring
🌟 What's New in v0.5
Action button wiring
- Now pressing the action button opens the config dir in respective file managers
HPR Version Support
- Extended HPR compatibility list to support v0.9.7, v0.9.8, v0.9.9, v0.9.10, v0.9.11.
🖥️ 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,5000v0.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,5000v0.3
HPR Idle Detection Extension v0.2
Hey everyone! 👋 Welcome to v0.3 of HPR Idle Detection Extension
Whats new?
- Nothing
- Just updated the HPR version support for v0.9.8
🖥️ 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 (it uses milliseconds so keep in mind that):
idle-threshold,480000v0.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
v0.1
HPR Idle Detection Extension
Important
- This release is linux only currently
A native C++ & Lua extension for HPR (Human Pattern Recorder) that monitors system idle status and automatically manages tracking lifecycle events.
Developed by: Plexescor
Support Matrix
| Platform / Desktop Environment | Support Status |
|---|---|
| Windows | ✅ Supported |
| Linux (GNOME) | ✅ Supported |
| Linux (KDE Plasma) | 🚧 In Progress |
| Linux (Hyprland) | ✅ Supported |
| Linux (niri) | ✅ Supported |
| Linux (Cinnamon) | 🚧 In Progress |
Structure
src/— Native C++ module source code.include/— C++ header files.external/— Embedded dependencies (sol2,lua).idle_detection.lua— Extension entry point script.
Installation & Deployment Note
Important
- Both
idle_detection.luaand the compiled dynamic library (HPR_Idle_Detection_Extension.dllon Windows orHPR_Idle_Detection_Extension.soon Linux) must reside in the exact same folder inside your extensions directory. - The filename of
HPR_Idle_Detection_Extension.dll/HPR_Idle_Detection_Extension.somust be kept exactly as named in the release without renaming.
Placement directories:
- Windows:
%APPDATA%\HPR\HPR_Config\extensions\ - Linux:
~/.config/HPR/HPR_Config/extensions/
Configuring Idle Time Threshold
Idle time is configured via idle_detection_config.csv in the extension directory alongside idle_detection.lua.
CSV File Format
HPR expects a simple key-value CSV format where the threshold value is specified in milliseconds:
idle-threshold,<time_in_milliseconds>Conversion Examples
- 1 Minute:
idle-threshold,60000 - 5 Minutes:
idle-threshold,300000 - 8 Minutes (Default):
idle-threshold,480000 - 10 Minutes:
idle-threshold,600000 - 15 Minutes:
idle-threshold,900000
Tip
If idle_detection_config.csv is missing on launch, the extension will automatically create it with the default 8-minute threshold (480000 ms).
How It Works
- Initialization: On startup,
idle_detection.luaresolves its absolute directory viaHPR.getExtensionAbsoluteDir(), then dynamically loadsHPR_Idle_Detection_Extension.dll(or.so) usingpackage.loadlib()to expose native system idle detection (getIdleStatus). - Config Management: Reads
idle_detection_config.csvforidle-threshold(defaulting to 8 minutes /480000ms if missing). - System Monitoring: On every tick (
onTick), it checks user idle time against the configured threshold. - Auto Pause & Resume:
- If idle time exceeds the threshold and the active window title is not ignored (e.g. YouTube), tracking pauses automatically via
HPR.stopTracking(). - When user activity resumes, tracking automatically starts again via
HPR.startTracking().
- If idle time exceeds the threshold and the active window title is not ignored (e.g. YouTube), tracking pauses automatically via
Idle Detection Backends
The native library selects the appropriate idle detection method at runtime based on the current platform and desktop environment:
| Platform | Backend | How it works |
|---|---|---|
| Windows | GetLastInputInfo (Win32 API) |
Queries the timestamp of the last input event directly from the OS |
| Linux — GNOME | org.gnome.Mutter.IdleMonitor (D-Bus) |
Calls the Mutter compositor's D-Bus GetIdletime method |
| Linux — other Wayland | ext-idle-notify-v1 (Wayland protocol) |
Subscribes to compositor idle/resumed events in a background thread; elapsed time since the idled event is the idle duration |
The Wayland backend works with any compositor that implements the standard ext-idle-notify-v1 protocol, including KDE/KWin, Hyprland, Sway, niri, and others.
Warning
X11 sessions are not supported. If you are running a desktop on X11 (e.g. KDE on X11, Openbox, i3 on X), the extension will load successfully but idle detection will always return "not idle" and tracking will never be paused automatically. Only Wayland sessions are supported on non-GNOME Linux desktops.