1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
# hyprland
Two settings pages, under Hyprland in the settings window.
## Keyboard shortcuts
Every bind Hyprland has loaded, from `hyprctl binds -j`, joined to the
`hl.bind` call in `~/.config/hypr` (`hyprland.lua` and `sections/*.lua`)
that made it: by description, then by combo, then, for a bind built in a
loop, by the longest literal head of its description. hyprctl reports every
Lua action as an opaque `__lua` number, so the action shown is the source's.
List shows the combo, the description and action, and the file:line. Source
shows the files holding binds, line-numbered. Clashes lists combos bound
more than once in the same submap.
Clicking a row opens its combo for editing when the source writes it as a
plain string, or one built from file-level string locals (`mainMod .. " +
w"`). Save asks Hyprland first, by `hyprctl eval` of a do-nothing bind on the
new combo, which fails on an unknown modifier or keysym. Then the first
argument of that call is replaced with the combo as a string literal, and
Hyprland's autoreload picks up the file. An edit is refused if the call is
no longer where it was parsed. A bind built at run time says where to change
it instead.
## Options
All of Hyprland's options from `hyprctl descriptions -j`, with values from
one batched `getoption`, filtered by everything, set in the config, or
changed from the default. Values differing from the default are in the
accent, gradients show their colours.
A change is one line in `sections/keystone.lua`, which `hyprland.lua`
requires last, so it wins over the hand-written sections without editing
them:
hl.config({ general = { border_size = 4 } }) -- keystone: general:border_size
The line is run through `hyprctl eval` first, which refuses an unknown key or
a value of the wrong shape and changes nothing; one that passes applies at
once and is then written. Booleans and enums are picked from their choices,
everything else is typed as a Lua expression, started from the current value
(`{ top = 8, right = 8, bottom = 8, left = 8 }` for gaps, `{ colors = {
"rgba(...)" }, angle = 45 }` for a gradient). Reset drops the line, and the
reload brings back what the other sections, or the default, give it.
Not handled: an option a hand-written section sets is shadowed, not edited
there; and the two options `getoption` cannot read show as unreadable and
cannot be edited.
## Check
node desktop/modules/hyprland/test_hypr.js
It also checks every live bind finds its source, when `~/.config/hypr` is
there.
|
