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

Releases

v0.5.1

Choose a tag to compare

@plexescor plexescor released this 27 Sep 13:24

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,5000

v0.5

Choose a tag to compare

@plexescor plexescor released this 21 Sep 12:54

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,5000

v0.4

Choose a tag to compare

@plexescor plexescor released this 20 Sep 09:15

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

v0.3

Choose a tag to compare

@plexescor plexescor released this 30 Aug 15:36

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,480000

v0.2

Choose a tag to compare

@plexescor plexescor released this 09 Aug 11:16

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 GetLastInputInfo API 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-v1 protocol.

⚙️ Auto-Config Initialization

  • Auto-generates idle_detection_config.csv with a default 8-minute (480000 ms) 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

Choose a tag to compare

@plexescor plexescor released this 08 Aug 11:32

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.lua and the compiled dynamic library (HPR_Idle_Detection_Extension.dll on Windows or HPR_Idle_Detection_Extension.so on Linux) must reside in the exact same folder inside your extensions directory.
  • The filename of HPR_Idle_Detection_Extension.dll / HPR_Idle_Detection_Extension.so must 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

  1. Initialization: On startup, idle_detection.lua resolves its absolute directory via HPR.getExtensionAbsoluteDir(), then dynamically loads HPR_Idle_Detection_Extension.dll (or .so) using package.loadlib() to expose native system idle detection (getIdleStatus).
  2. Config Management: Reads idle_detection_config.csv for idle-threshold (defaulting to 8 minutes / 480000 ms if missing).
  3. System Monitoring: On every tick (onTick), it checks user idle time against the configured threshold.
  4. 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().

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.