docs(config): describe density-aware hint label styling

commit: 072073e1b9ce05692ae8a51e426e295bc48110f9
author: brice · 3d ago · 2026-10-19 13:26 UTC
parent: 7b9b265
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +5 -0

M docs/config.md +5 -0


@@ -56,6 +56,9 @@ See [examples/config](../examples/config) for every key with its default.
56	56		\| `focus.flash-duration` \| `200ms` \| Fade duration, `50ms` to `1s`; not scaled by `animations.speed` \|
57	57		\| `focus.flash-color` \| `border.active` \| Flash color `#rrggbb`; empty uses `border.active` \|
58	58		\| `hint.targets` \| `clickable` \| What [hint mode](#hint-mode) labels: `clickable` (links, URLs and buttons) or `links` (links and URLs only) \|
	59	+	\| `hint.size` \| `auto` \| Label text size in logical pixels (positive number), or `auto` for screen pixel density \|
	60	+	\| `hint.background` \| empty \| Label background (`#rrggbb`); empty uses `border.active` \|
	61	+	\| `hint.foreground` \| empty \| Label text (`#rrggbb`); empty chooses a contrasting colour \|
59	62		\| `workspace.<name>.monitor` \| focused output \| Home monitor of a named workspace \|
60	63		\| `workspace.<name>.size` \| `inherit` \| [Smaller viewport](#workspace-size), e.g. `1920x1080` \|
61	64		\| `workspace.<name>.max-columns`, `.overflow` \| output values \| Per-workspace layout \|

@@ -300,6 +303,8 @@ Otherwise, left from the first column unfolds the stash. Up/down walk the cards,
300	303
301	304		### Hint mode
302	305
	306	+	Labels use the `border.active` colour with a contrasting text colour, and their size follows the screen's pixel density.
	307	+
303	308		`hint` labels the links, URLs and buttons visible on the focused screen, so you can click one from the keyboard. Targets come from the accessibility tree when the app exposes it, and from the pixels of the screen otherwise. No bind is set by default; for example `bind.cmd+g = hint`.
304	309
305	310		- Each target gets a label of lowercase letters. With up to 26 targets the labels are one letter, with more they are two.


@@ -56,6 +56,9 @@ See [examples/config](../examples/config) for every key with its default.
56	\| `focus.flash-duration` \| `200ms` \| Fade duration, `50ms` to `1s`; not scaled by `animations.speed` \|	56		\| `focus.flash-duration` \| `200ms` \| Fade duration, `50ms` to `1s`; not scaled by `animations.speed` \|
57	\| `focus.flash-color` \| `border.active` \| Flash color `#rrggbb`; empty uses `border.active` \|	57		\| `focus.flash-color` \| `border.active` \| Flash color `#rrggbb`; empty uses `border.active` \|
58	\| `hint.targets` \| `clickable` \| What [hint mode](#hint-mode) labels: `clickable` (links, URLs and buttons) or `links` (links and URLs only) \|	58		\| `hint.targets` \| `clickable` \| What [hint mode](#hint-mode) labels: `clickable` (links, URLs and buttons) or `links` (links and URLs only) \|
		59	+	\| `hint.size` \| `auto` \| Label text size in logical pixels (positive number), or `auto` for screen pixel density \|
		60	+	\| `hint.background` \| empty \| Label background (`#rrggbb`); empty uses `border.active` \|
		61	+	\| `hint.foreground` \| empty \| Label text (`#rrggbb`); empty chooses a contrasting colour \|
59	\| `workspace.<name>.monitor` \| focused output \| Home monitor of a named workspace \|	62		\| `workspace.<name>.monitor` \| focused output \| Home monitor of a named workspace \|
60	\| `workspace.<name>.size` \| `inherit` \| [Smaller viewport](#workspace-size), e.g. `1920x1080` \|	63		\| `workspace.<name>.size` \| `inherit` \| [Smaller viewport](#workspace-size), e.g. `1920x1080` \|
61	\| `workspace.<name>.max-columns`, `.overflow` \| output values \| Per-workspace layout \|	64		\| `workspace.<name>.max-columns`, `.overflow` \| output values \| Per-workspace layout \|

@@ -300,6 +303,8 @@ Otherwise, left from the first column unfolds the stash. Up/down walk the cards,
300		303
301	### Hint mode	304		### Hint mode
302		305
		306	+	Labels use the `border.active` colour with a contrasting text colour, and their size follows the screen's pixel density.
		307	+
303	`hint` labels the links, URLs and buttons visible on the focused screen, so you can click one from the keyboard. Targets come from the accessibility tree when the app exposes it, and from the pixels of the screen otherwise. No bind is set by default; for example `bind.cmd+g = hint`.	308		`hint` labels the links, URLs and buttons visible on the focused screen, so you can click one from the keyboard. Targets come from the accessibility tree when the app exposes it, and from the pixels of the screen otherwise. No bind is set by default; for example `bind.cmd+g = hint`.
304		309
305	- Each target gets a label of lowercase letters. With up to 26 targets the labels are one letter, with more they are two.	310		- Each target gets a label of lowercase letters. With up to 26 targets the labels are one letter, with more they are two.