Skip to content

docs(readme): add Hyprland column to the DE support table - #149

Merged
mmaher88 merged 2 commits into
masterfrom
docs-readme-hyprland
Jul 28, 2026
Merged

docs(readme): add Hyprland column to the DE support table#149
mmaher88 merged 2 commits into
masterfrom
docs-readme-hyprland

Conversation

@mmaher88

Copy link
Copy Markdown
Owner

Follow-up to #117, which added Hyprland support but didn't touch README.md.

The DE table listed only KDE / GNOME / Other DEs, so Hyprland fell into "Other DEs" — which marks per-app profiles and auto profile switching as unsupported. That understated the feature: Hyprland's focus tracking is implemented over the compositor event socket (activeWindowChanged is emitted), so both work.

Column values verified against the merged implementation, not assumed:

Row Hyprland Why
Per-app profiles / auto switching event-socket focus tracking emits activeWindowChanged
Block shortcuts during capture blockGlobalShortcuts is a documented no-op — Hyprland has no stable compositor-wide shortcut-block API
Everything else pure HID++ over hidraw, DE-independent

The note below the table now also mentions the event-socket mechanism alongside the KWin script and GNOME Shell extension, and spells out the shortcut-blocking consequence (capture works; global bindings may still fire).

Docs only — no code change. generate-readme-devices.py --check and generate_package_deps.py --check both pass, and the full suite ran clean via the pre-push gate.

mmaher88 added 2 commits July 28, 2026 02:10
Hyprland support landed in #117 but the README table still listed only
KDE/GNOME/Other, so Hyprland fell under "Other DEs" — which shows per-app
profiles and auto-switching as unsupported, understating what it does.

Focus tracking is implemented over the compositor event socket, so per-app
profiles and auto profile switching are supported. blockGlobalShortcuts is a
documented no-op (Hyprland has no stable compositor-wide shortcut-block API),
so that row is marked unsupported and the note explains the consequence.
@mmaher88
mmaher88 merged commit dec275b into master Jul 28, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant