1# Configuration
2
3NeferWL reads `~/.config/neferwl/config` (or `$XDG_CONFIG_HOME/neferwl/config`). Changes apply when you save, except `startup` and `xwayland`, which apply at the next start.
4
5```sh
6neferwl --config <path>            # use another file
7neferwl validate-config [path]     # check a file
8```
9
10Missing keys use defaults. Empty keyboard values use the system setting. No startup commands or named workspaces are configured by default. The log lists changed keys after a reload.
11
12## Format
13
14- One `key = value` per line. `#` starts a comment.
15- Lists are comma-separated; booleans are `on` / `off`.
16- An invalid line logs a warning and keeps the default. If a key appears twice, the last one wins.
17
18See [examples/config](../examples/config) for every key with its default.
19
20## Keys
21
22| Key | Default | Meaning |
23|---|---|---|
24| `keyboard.layout`, `.variant`, `.options` | empty | xkb names, e.g. `fr`, `caps:escape` |
25| `keyboard.repeat-rate` / `.repeat-delay` | `25` / `600` | Repeats per second / delay in ms |
26| `keyboard.cmd` | `super` | Modifier meant by `cmd` in binds: `super`, `alt` or `ctrl` |
27| `terminal` | `$TERMINAL` or `foot` | Terminal command |
28| `terminal.auto-open` | `first` | Open a terminal on the first workspace (`first`), on every empty one (`all`), or never (`off`) |
29| `startup` | none | Commands run at session start, separated by `;` |
30| `xwayland` | `xwayland-satellite` | X11 support; `off` disables it |
31| `background` | `#111111` | Background color |
32| `border.radius` | `0` | Corner radius in logical pixels, `0` to `64`; floats always, tiles only with gaps |
33| `border.width` | `2` | Border width in pixels; `0` hides borders |
34| `border.active` / `.inactive` | `#808080` / `#111111` | Border colors of the focused / other windows |
35| `floating.dim` | `0.3` | Darkening behind floating windows and the overview, 0 to 1 |
36| `layout.gaps` | `0` | Space between windows |
37| `layout.max-columns` | `2` | Columns that share the screen |
38| `layout.overflow` | `cascade` | What happens past `max-columns`: [`cascade`](#cascade) into bands below, `scroll` right, or `fixed` spiral split |
39| `layout.<output>.max-columns`, `.overflow` | layout values | Per-output layout |
40| `stash.width` | `80` | Width of the selected [stashed](#stash) window, in % of the screen (10–90) |
41| `stash.gap` | `2` | Gap around the selected stashed window, in % (0–10) |
42| `stash.dim` | `0.5` | Darkening of the stash neighbors, 0 to 1 |
43| `stash.capture` | `on` | A window opened while the stash shows joins the stash |
44| `stash.spawn-terminal` | `on` | `toggle-stash-visible` on an empty stash opens `terminal` in it |
45| `touchpad.natural-scroll` | `off` | Content follows the fingers |
46| `touchpad.tap` | `on` | Tap to click |
47| `touchpad.accel-speed` | `0` | Pointer speed, `-1` to `1` |
48| `touchpad.accel-profile` | `adaptive` | `adaptive` or `flat` |
49| `touchpad.left-handed` | `off` | Swap left and right buttons |
50| `touchpad.scroll-factor` | `1` | Scroll speed multiplier, up to `10` |
51| `mouse.natural-scroll`, `.accel-speed`, `.accel-profile`, `.left-handed` | as touchpad | Same, for mice, trackballs and trackpoints |
52| `cursor.hide-after` | `5s` | Hide the cursor after this long without motion, or `off` |
53| `animations` | `off` | **Experimental.** Animate layout changes and make swipes follow the fingers |
54| `animations.speed` | `normal` | `slow`, `normal`, `fast`, or a factor from `0.1` to `10` |
55| `focus.follow-move` | `off` | Follow a column moved to another workspace |
56| `focus.position-hint` | `on` | Show workspace/band dots near the output bottom for 600ms after a position change, then fade for 150ms (no fade with animations off); hidden in overview, fullscreen and session lock; never captured |
57| `focus.flash` | `on` | Briefly draw an inner border, inside the window border, on the window, column or output an action changed |
58| `focus.flash-width` | `2` | Flash border width in logical pixels, `1` to `8` |
59| `focus.flash-opacity` | `0.6` | Starting opacity of the flash, `0.1` to `1` |
60| `focus.flash-duration` | `200ms` | Fade duration, `50ms` to `1s`; not scaled by `animations.speed` |
61| `focus.flash-color` | `border.active` | Flash color `#rrggbb`; empty uses `border.active` |
62| `hint.enable` | `off` | Turn on the experimental [hint mode](#hint-mode) (restart required) |
63| `hint.targets` | `clickable` | What [hint mode](#hint-mode) labels: `clickable` (links, URLs and buttons) or `links` (links and URLs only) |
64| `hint.text-click` | `ctrl+shift` | Modifiers held for clicks on links found by OCR (terminals open links on a modified click); `none` sends a plain click |
65| `hint.capture` | `off` | Show hint labels in captures requested by Wayland clients (screenshots, screencasts); the compositor's own hint scans never see them; applies on reload |
66| `hint.size` | `auto` | Label text size in logical pixels (6 to 72), or `auto` for screen pixel density |
67| `hint.background` | empty | Label background (`#rrggbb`); empty uses `border.active` |
68| `hint.foreground` | empty | Label text (`#rrggbb`); empty chooses a contrasting colour |
69| `workspace.<name>.monitor` | focused output | Home monitor of a named workspace |
70| `workspace.<name>.size` | `inherit` | [Smaller viewport](#workspace-size), e.g. `1920x1080` |
71| `workspace.<name>.max-columns`, `.overflow` | output values | Per-workspace layout |
72| `workspace.<name>.column.<N>` | none | Column slot: `<cells>, <command>` |
73| `rule.<name>.*` | none | [Window rules](#window-rules) |
74| `output.<name>` | `preferred` | `WxH`, `WxH@Hz`, `preferred` or `off` |
75| `output.<name>.scale` | `1` | 1 to 4, e.g. `1.5` or `4/3` |
76| `output.<name>.transform` | `normal` | `90`, `180`, `270`, `flipped`, `flipped-90`, … |
77| `output.<name>.primary` | `off` | Focused at startup |
78| `output.<name>.right-of`, `.left-of`, `.above`, `.below`, `.offset` | automatic | [Output placement](#output-placement) |
79| `output.<name>.hdr` | `off` | [HDR](#hdr) on capable displays |
80| `output.<name>.sdr-brightness` | `203` | Brightness of SDR content in HDR, in nits (80–1000) |
81| `render.direct-scanout` | `on` | Send fullscreen windows straight to the display |
82| `render.tearing` | `on` | Allow tearing for fullscreen games |
83| `render.vrr` | `on` | Variable refresh rate for fullscreen windows |
84| `render.vrr-flip-gap` | `1ms` | See [Performance](performance.md#vrr) |
85| `performance.realtime` | `on` | Real-time scheduling |
86| `log.level` / `log.debug` | `info` / empty | Log level / debug categories or `all` |
87| `bind.<keys>` | see [Default binds](#default-binds) | [Binds](#binds) |
88
89With `layout.gaps = 0`, borders are tmux-style lines between tiles. With gaps, every tile gets a full border, even alone. `border.radius` rounds floating windows always and tiles with gaps; fullscreen windows, popups and layers stay square.
90
91`<output>` is a connector such as `DP-2`, or a monitor key (`make model serial`).
92
93The position hint follows actual workspace/band changes and monitor focus, regardless
94of input method. It lists all ext-workspace entries in monitor order: numbered
95workspaces (including the empty spare), then configured hidden named workspaces,
96even when empty. Cascade workspaces use top-aligned band columns; scroll/fixed
97workspaces use one vertical workspace column. Large lists show at most 16 entries
98with the active entry kept visible; band rows are capped at 16.
99
100The focus flash marks the window, column or output an action changes with a brief
101inner border. When a flash-triggering action crosses screens, it marks the whole
102destination output, even if that output has no windows. Same-screen workspace
103switches and mouse focus do not trigger a flash.
104It runs when `animations = on`.
105
106## Automatic terminal
107
108The command comes from `terminal`, then `$TERMINAL`, then `foot`.
109
110| `terminal.auto-open` | Behaviour |
111| --- | --- |
112| `first` | Open once on the initial numbered workspace |
113| `all` | Open on each visible empty workspace without predefined slots |
114| `off` | Do not open automatically |
115
116`--no-terminal` disables automatic opening for one run; `spawn-terminal` still works. Launched programs inherit `$SHELL`, `$EDITOR` and `$VISUAL`.
117
118## Per-output defaults
119
120Per-output defaults (replace `<name>` with a connector such as `DP-1`):
121
122```text
123output.<name> = preferred
124output.<name>.scale = 1
125output.<name>.transform = normal
126output.<name>.primary = off
127output.<name>.offset = 0
128output.<name>.hdr = off
129output.<name>.sdr-brightness = 203
130```
131
132Outputs are arranged automatically unless `.right-of`, `.left-of`, `.above` or `.below` is set. Per-output layouts inherit `layout.*`; named workspaces inherit their output's layout and size, use the focused output unless `.monitor` is set, and have no predefined columns. Media keys have no default bindings.
133
134## Window rules
135
136Rules place an app's windows when they first open.
137
138| Key | Meaning |
139|---|---|
140| `rule.<name>.app-id` | Required. [Regular expression](https://pkg.go.dev/regexp/syntax) matching the whole app ID |
141| `rule.<name>.floating` | `on` to float, `off` to tile |
142| `rule.<name>.workspace` | Workspace number or name |
143| `rule.<name>.monitor` | Output |
144| `rule.<name>.width` | Column width in [cells](#column-widths), 1 to 16 |
145
146```ini
147rule.games.app-id = steam_app_.*
148rule.games.workspace = 3
149rule.chat.app-id = discord|org\.telegram\..*
150rule.chat.workspace = chat
151rule.chat.width = 1
152rule.calc.app-id = org\.gnome\.Calculator
153rule.calc.floating = on
154```
155
156- Every matching rule applies, in file order; later rules win.
157- A rule never moves your focus or view.
158- To find an app ID: `neferwl state | jq '.windows[].app_id'`.
159
160## Output placement
161
162By default, outputs sit left to right in config order. Place one against another, and use `offset` (logical pixels) to align the edges:
163
164```ini
165output.DP-2.right-of = DP-1
166output.DP-2.offset = 360    # DP-2 starts 360 px lower than DP-1
167```
168
169```
170┌────────────┐
171│            │┌─────────┐
172│    DP-1    ││  DP-2   │
173│ 2560x1440  ││1920x1080│
174│            │└─────────┘
175└────────────┘
176```
177
178`offset` moves down for `right-of`/`left-of`, and right for `above`/`below`. kanshi, wdisplays and wlr-randr override these settings until the next reload.
179
180## Workspace size
181
182`workspace.<name>.size` gives a named workspace a smaller centered viewport, for example to present at 1080p on a 4K screen:
183
184```ini
185workspace.presentation.size = 1920x1080
186bind.cmd+p = workspace presentation
187```
188
189## Touchpad
190
191| Gesture | Action |
192|---|---|
193| Three fingers left/right | Scroll columns (switch workspace in cascade) |
194| Three fingers up/down | Switch workspace (scroll bands in cascade) |
195| Four fingers up | Open the overview, or hide the stash |
196| Four fingers down | Close the overview, or show/hide the stash |
197
198A swipe moves one step at most. Other gestures (pinch, hold, two-finger scroll) go to the app under the pointer.
199
200## HDR
201
202`output.<name>.hdr = on` sends HDR10 to displays that support it. If the display, driver or GPU cannot, NeferWL falls back to SDR and logs why. NVIDIA is not supported yet.
203
204- HDR-aware apps (games, browsers, video players) can show HDR content. Some need HDR turned on in their own settings. X11 apps stay SDR.
205- The desktop stays SDR, shown at `sdr-brightness` nits.
206- Fullscreen HDR windows go straight to the display.
207- Screenshots and captures are SDR (tone-mapped).
208- If NeferWL crashes, the next compositor may show distorted colours until it sets its own colour pipeline.
209
210## Binds
211
212`bind.<keys> = <action>`. Modifiers: `cmd` (see `keyboard.cmd`), `shift`, `ctrl`, `alt`, `super`.
213
214- Keys are what your layout prints: `cmd+é` on AZERTY. Write `=`, `#` and space by name: `cmd+equal`, `cmd+numbersign`, `cmd+space`.
215- `code:N` is a physical key, the same on every layout: `code:2` to `code:10` are the digits 1 to 9.
216- Other keys use their xkb name (`wev` shows it).
217- `none` removes a default bind.
218- `spawn <command>` runs a program without a shell. See [Running commands](desktop.md#running-commands).
219- Holding a move bind repeats it: focus, move, resize and workspace steps, first after 250 ms, then 8 times a second. Toggles, spawns and closes run once. The overview's arrows and `h/j/k/l` repeat the same way.
220
221```ini
222bind.XF86AudioRaiseVolume = spawn wpctl set-volume -l 1.0 @DEFAULT_AUDIO_SINK@ 5%+
223bind.XF86AudioLowerVolume = spawn wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-
224bind.XF86AudioMute = spawn wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle
225bind.XF86MonBrightnessUp = spawn brightnessctl set +5%
226bind.XF86MonBrightnessDown = spawn brightnessctl set 5%-
227```
228
229### Actions
230
231| Action | Effect |
232|---|---|
233| `spawn <command>` | Run a program |
234| `spawn-terminal` | Run `terminal` |
235| `stash <command>` | Run a program and open its window in the [stash](#stash) |
236| `close-window` | Close the focused window |
237| `toggle-fullscreen` | Fullscreen the focused window. Nothing shows above it except its own dialogs |
238| `toggle-floating` | Make the focused window [float](#free-floating-windows), or put it back in its column |
239| `toggle-window-stash` | Move the focused window to the [stash](#stash), or back to its column |
240| `toggle-stash-visible` | Show or hide the stash |
241| `toggle-overview` | Open or close the [overview](#overview) |
242| `hint` | Label the links and buttons on the focused screen, then click the one you type ([hint mode](#hint-mode)) |
243| `switch-column-next` / `-prev` | Switch to the previously used column. Hold `cmd` and press again to go further back |
244| `maximize-column` | Toggle full width for the focused column |
245| `cycle-column-width` | Grow the focused column by one [cell](#column-widths), then back to equal widths |
246| `set-column-width <+N\|-N>` | Widen or narrow the focused column by N cells |
247| `set-window-height <+N%\|-N%>` | Change the focused window's share of its column |
248| `focus-column-left/right` | Focus the neighbor column, then the neighbor monitor |
249| `focus-window-up/down` | Focus the neighbor window in the column, then the neighbor workspace (band in cascade) |
250| `move-column-left/right` | Move the focused column, then to the neighbor monitor |
251| `move-window-up/down` | Move the focused window in its column |
252| `consume-or-expel-window-left/right` | Join the neighbor column, or leave the current one |
253| `focus-workspace <N>` / `-prev/-next` | Show a workspace |
254| `workspace <name>` | Show or hide a named workspace |
255| `move-column-to-workspace <N>` / `-prev/-next` | Move the focused column to a workspace |
256| `move-window-to-workspace <N>` / `-prev/-next` | Move the focused window to a workspace |
257| `move-workspace-prev/next` | Swap the workspace with its neighbor |
258| `focus-monitor-left/right/up/down` | Focus the neighbor monitor |
259| `move-workspace-to-monitor-left/right/up/down` | Move the workspace to the neighbor monitor |
260| `scale-up` / `scale-down` | Zoom the display; the scale is saved to the config |
261| `quit` | Exit NeferWL |
262
263### Default binds
264
265| Keys | Action |
266|---|---|
267| `cmd+return` | `spawn-terminal` |
268| `ctrl+cmd+space` | `spawn fuzzel` |
269| `cmd+q` | `close-window` |
270| `cmd+left/right`, `cmd+h/l` | `focus-column-left/right` |
271| `cmd+up/down`, `cmd+k/j` | `focus-window-up/down` |
272| `cmd+shift+left/right`, `cmd+shift+h/l` | `move-column-left/right` |
273| `cmd+shift+up/down`, `cmd+shift+k/j` | `move-window-up/down` |
274| `cmd+bracketleft/bracketright` | `consume-or-expel-window-left/right` |
275| `cmd+alt+left/right`, `cmd+alt+h/l` | `set-column-width -1/+1` |
276| `cmd+alt+up/down`, `cmd+alt+k/j` | `set-window-height -10%/+10%` |
277| `cmd+r` | `cycle-column-width` |
278| `cmd+f` | `maximize-column` |
279| `cmd+shift+f` | `toggle-fullscreen` |
280| `cmd+shift+space` | `toggle-floating` |
281| `cmd+s` | `toggle-stash-visible` |
282| `cmd+shift+s` | `toggle-window-stash` |
283| `cmd+o` | `toggle-overview` |
284| `cmd+tab` / `cmd+shift+tab` | `switch-column-next/prev` |
285| `cmd+1`…`9` (`code:2`…`10`) | `focus-workspace 1`…`9` |
286| `cmd+shift+1`…`9` | `move-column-to-workspace 1`…`9` |
287| `cmd+pageup/pagedown` | `focus-workspace-prev/next` |
288| `cmd+shift+pageup/pagedown` | `move-column-to-workspace-prev/next` |
289| `cmd+ctrl+arrows`, `cmd+ctrl+h/j/k/l` | `focus-monitor-*` |
290| `cmd+ctrl+shift+left/right`, `cmd+ctrl+shift+h/l` | `move-workspace-to-monitor-left/right` |
291| `cmd+ctrl+shift+up/down`, `cmd+ctrl+shift+k/j` | `move-workspace-prev/next` |
292| `cmd+code:12` / `cmd+code:13` (`-` / `=` on US) | `scale-down` / `scale-up` |
293| `ctrl+alt+backspace` | `quit` |
294
295With `keyboard.cmd = alt` or `ctrl`, the defaults that would combine `cmd` with that same modifier are dropped. Bind those actions to other keys.
296
297## Layout
298
299### Cascade
300
301The default layout. Columns sit side by side in bands of up to `max-columns`, stacked one below the other. Each band fills the screen height and keeps its columns until you move them.
302
303- Left/right focus moves within a band, then to the neighbor monitor, then to the neighbor workspace.
304- `move-column-left/right` stays in the band; at its edge the column goes to the neighbor monitor, if any.
305- Up/down moves through the windows of a column, then to the band above or below.
306- `move-window-up/down` past the column's top or bottom sends the whole column to the band above or below. It joins that band when it has room, else it gets a new band between the two.
307- A new window joins the focused band when it has room, else it gets a new band right below.
308- `cycle-column-width` in a full band makes room: the rightmost column goes to the band below (from the last column, the leftmost goes to the band above). The end of the cycle brings it back.
309- `maximize-column` gives the column a band of its own: the columns on its left go to the band above, the ones on its right to the band below. Maximizing again forms the band back.
310- A band left empty goes away. A smaller `max-columns` moves the extra columns of a band to a new band below it.
311
312### Column widths
313
314A cell is `1/max-columns` of the screen width. A column is 1 to 16 cells wide. Columns without a set width share the space equally.
315
316### Stash
317
318Each workspace has a stash: a strip of windows set aside with `toggle-window-stash`. The selected one shows centered over your columns, with its neighbors dimmed on the sides. `focus-column-left/right` or a three-finger swipe browse it. `toggle-stash-visible` or a four-finger swipe hides it.
319
320`stash <command>` runs a program and opens its window straight in the stash of the workspace you were on, selected and focused, even if you switch workspace before it appears. With `stash.spawn-terminal`, `toggle-stash-visible` or the four-finger swipe down on an empty stash does the same with `terminal`.
321
322```ini
323bind.cmd+shift+f = stash firefox
324```
325
326The window must appear within 5 seconds, otherwise it opens normally. Apps that hand a launch to an already running instance (single-instance browsers, `footclient`) open their window normally.
327
328### Free floating windows
329
330`toggle-floating` turns the focused window into a floating window that stays where you put it. On a floating window, move binds move it by 50 pixels and resize binds resize it.
331
332### Moving windows with the pointer
333
334- `cmd` + left drag moves a window. Drop it on the top or bottom of another window to stack it there, or in the middle to swap.
335- `cmd` + right drag resizes a floating window.
336- `cmd` + right drag on the line between two columns or two stacked windows resizes them.
337- `cmd` + double right-click on that line resets the lane's column widths or the column's row heights. Column widths reset when a column enters or leaves the lane.
338- `Escape` cancels the drag and restores the previous sizes.
339
340### Overview
341
342`toggle-overview` (or a four-finger swipe up) shows previews of your workspaces. Arrows, `h/j/k/l` or three-finger swipes move the selection; `Return` or a click opens it; `Escape` goes back. `close-window` and the move-to-workspace binds work on the selected preview.
343
344A workspace's stash shows as a pile of cards. Selecting the pile unfolds it into a carousel of every stashed window: a row under the workspace with `layout.overflow = cascade`, a column on its left otherwise. The selected card stays in the middle, the earlier cards before it and the later ones after it, wrapping round; a wider gap separates the newest card from the oldest. Moves along the carousel pick a card. With fewer than three cards, or on a workspace holding only stashed windows, it does not wrap round. Leaving it folds it again. Moving to another workspace selects its windows rather than a carousel that wraps round, even when its stash has the focus, so browsing workspaces never stops on one.
345
346With `layout.overflow = cascade`, workspaces sit side by side, each band of columns is a lane, and the stash sits under the lanes. Down (or fingers down on the touchpad, with natural scroll off) moves to the lane below; past the last lane it unfolds the stash. Left/right walk the cards; where the carousel does not wrap round, they go to the neighbor workspace past either end. Up leaves the stash for the last lane, at the column you came from.
347
348Otherwise, left from the first column unfolds the stash. Up/down walk the cards, the focus-workspace binds change workspace, and right goes back to the columns.
349
350## Hint mode
351
352Hint mode is experimental and off by default: set `hint.enable = on` and restart NeferWL.
353While it is off, nothing of hint mode runs or uses memory, and the `hint` bind
354logs a notice once and does nothing. A reload does not change it.
355
356`hint` labels the links and buttons on the focused output. Type a label to
357click its target; BackSpace erases a letter, Escape cancels. No bind is set
358by default; for example `bind.cmd+g = hint`.
359
360Labels use the `border.active` colour with a contrasting text colour, and
361their size follows the screen's pixel density. Each label sits just outside
362the top-left corner of its target. Links found by OCR (terminal text) are
363clicked with the `hint.text-click` modifiers held, which is how terminals open
364a link; accessibility targets get a plain click.
365
366Labels are not part of screenshots and screencasts by default. With
367`hint.capture = on` they appear in the captures that Wayland clients request
368(including Exclude captures); NeferWL's own text recognition never sees them.
369The capture indicator and the position hint stay out of every capture.
370A reload applies `hint.capture` to the next frame.
371
372### Where targets come from
373
374| Source | Apps | Accuracy | Speed |
375|---|---|---|---|
376| Accessibility tree (AT-SPI) | Firefox, Chromium, GTK, Qt, Electron | Exact: the app reports its own links and buttons | A few milliseconds |
377| Text recognition (OCR) | Everything else: terminals, apps without accessibility | Best effort: URLs, domains and underlined text written on screen | 150 ms or more, more on large screens |
378
379NeferWL asks the accessibility tree first. Windows it does not cover are read
380with OCR, which finds visible URLs, domains, email addresses and underlined
381text. Underlined words get a plain click, and the words of one continuous
382underline form one target; URLs keep the `hint.text-click` modifiers. OCR
383cannot see a link whose address is hidden behind plain text, and it can misread
384small or low-contrast text.
385
386### Requirements
387
388- Accessibility: NeferWL enables it lazily on the first hint scan that queries
389  app windows. Apps started before then may need restarting. Some apps need a flag:
390  - Chromium: `--force-renderer-accessibility`
391  - Electron: `ACCESSIBILITY_ENABLED=1`
392  - Qt: `QT_LINUX_ACCESSIBILITY_ALWAYS_ON=1`
393- OCR: `tesseract` and `tesseract-data-eng`. Without tesseract, OCR is off
394  and hint mode labels only apps that expose the accessibility tree.
395
396### Debugging hint mode
397
398With `hint.enable = on` and `NEFERWL_HINT_DEBUG=1` set when NeferWL starts (for example `NEFERWL_HINT_DEBUG=1 make tty`, or the variable in the launch environment), every successful scan writes three files to `$XDG_STATE_HOME/neferwl/hints/` (`~/.local/state/neferwl/hints/` when unset): `<time>-<output>.png`, the frame as scanned; `<time>-<output>.annotated.png`, the same with each target outlined (OCR links green, accessibility targets magenta, OCR window crops grey); and `<time>-<output>.json`, the targets (with their `source`, `atspi` or `ocr`) and timings. NeferWL keeps the 50 most recent scans and logs a warning at startup. The files contain the screen in clear: delete them after use.