Files

T

kanataandGitHub 2dd05ef8bc feat: add hypr-submap plugin (#101 )

* feat: add hypr-submap plugin

* fix(hypr-submap): add description key and glyph default value

* fix(hypr-submap): update dependencies and fix glyph default value in README

- Add stdbuf and hyprctl to the dependencies list in `README.md` and `plugin.toml`.
- Correct the documented default value of glyph to match the actual implementation.

2026-07-26 08:37:37 -04:00

1013 B

Raw Blame History

Hyprland Submap

Add simple bar widget to show Hyprland's current submap.

Plugin

Field	Value
ID	`k4n4t4/hypr-submap`
Entries	Bar widget: `hypr-submap`

Requirements

The following utilities must be installed and available on PATH:

socat
stdbuf
hyprctl Execution within a Hyprland environment is required.

Usage

Add the widget to the bar via the Noctalia Settings. Clicking the widget executes hyprctl dispatch 'hl.dsp.submap("reset")'.

Settings

Setting	Type	Default	Description
`hide_when_default`	`bool`	`false`	Hides the bar widget when the current submap is default.
`prefix`	`string`	`""`	Add the prefix text to the submap name displayed on the widget.
`glyph`	`glyph`	`"keyboard"`	Specifies the glyph displayed on the widget.

Notes

This plugin continuously runs a background subprocess using socat and stdbuf to monitor Hyprland's IPC socket for submap changes.

1013 B Raw Blame History