Every key of ~/.config/wr/config.toml, with its default. Anything missing uses
its default, a broken file falls back to the defaults with a notice, and most of
this can be changed live from Settings.
| Key | Default | Values | Meaning |
|---|---|---|---|
width | 100 | 0 or 40–400 | max width of the reading column; 0 = full width |
center | true | bool | center the column in the terminal |
spacing | 1 | 0 1 2 | blank lines between blocks: compact, normal, airy |
heading_rules | true | bool | a rule under level 1 and 2 headings |
code_frame | true | bool | the label and frame around code blocks |
guess_code_lang | true | bool | infer the language of unlabeled code when wr is sure (shown as (guessed)) |
links | "footnotes" | footnotes inline hidden | how link addresses are shown |
braille | true | bool | braille decoration (marks, bars, spinner) |
accent | "blue" | 8 ANSI colors + 6 presets | the color of the UI chrome |
scrollbar | true | bool | the scrollbar on the right |
footer | true | bool | the footer row |
footer_rule | true | bool | the thin rule above the footer |
footer_hints | true | bool | the shortcut hints on the left of the footer |
footer_progress | "both" | both percent bar off | what the footer shows on the right |
footer_chips | true | bool | the small notes: bookmark star, update available, search count |
mouse | true | bool | wheel scrolling, clicking links, drag to select |
copy_on_select | true | bool | copy as soon as the mouse is released |
wheel_lines | 3 | 1–20 | lines per wheel notch |
animations | true | bool | master switch for every animation |
anim_scroll | true | bool | smooth (spring) scrolling |
anim_reveal | true | bool | the page wiping in when it loads |
anim_panels | true | bool | panels opening like a shutter |
anim_loading | true | bool | the braille wave while a page downloads |
anim_notices | true | bool | notices typing themselves out |
scroll_speed | "normal" | slow normal fast | how quickly scrolling catches up |
search_engine | "duckduckgo" | duckduckgo wikipedia github, or a URL with %s | where plain words go |
homepage | "" | an address or a file | what wr opens with no address; "" = the start page |
render_js | true | bool | render pages drawn by JavaScript with an installed Chromium/Chrome |
update_check | true | bool | look for a newer wr in the background (at most every 12 hours) |
whats_new | false | bool | show the release notes in a small window when there is an update, and after you update |
history | true | bool | remember the pages you visit |
history_limit | 1000 | 50–20000 | how many visits to keep |
background_refresh | true | bool | refresh a cached page while you read it, and tell you if it changed |
cache | true | bool | keep pages on disk |
cache_days | 30 | 1–3650 | days before a cached page is forgotten |
[keys] | — | action = ["key", …] | only the bindings that differ from the defaults |
The eight ANSI accent colors (blue, cyan, green, magenta, yellow,
red, gray, white) are your terminal’s own colors, so they follow its
theme. The six presets (orange, violet, teal, pink, lime, slate)
are fixed 256-colors that look the same everywhere — pick one when your theme
lacks the color you want.