v0.9.0
guide / Configuration reference

Configuration reference

Every key of ~/.config/wr/config.toml, with its default. Anything missing uses

v0.9.0 18 / 21 2 min read docs/GUIDE.md

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.

KeyDefaultValuesMeaning
width1000 or 40–400max width of the reading column; 0 = full width
centertrueboolcenter the column in the terminal
spacing10 1 2blank lines between blocks: compact, normal, airy
heading_rulestrueboola rule under level 1 and 2 headings
code_frametrueboolthe label and frame around code blocks
guess_code_langtrueboolinfer the language of unlabeled code when wr is sure (shown as (guessed))
links"footnotes"footnotes inline hiddenhow link addresses are shown
brailletrueboolbraille decoration (marks, bars, spinner)
accent"blue"8 ANSI colors + 6 presetsthe color of the UI chrome
scrollbartrueboolthe scrollbar on the right
footertrueboolthe footer row
footer_ruletrueboolthe thin rule above the footer
footer_hintstrueboolthe shortcut hints on the left of the footer
footer_progress"both"both percent bar offwhat the footer shows on the right
footer_chipstrueboolthe small notes: bookmark star, update available, search count
mousetrueboolwheel scrolling, clicking links, drag to select
copy_on_selecttrueboolcopy as soon as the mouse is released
wheel_lines31–20lines per wheel notch
animationstrueboolmaster switch for every animation
anim_scrolltrueboolsmooth (spring) scrolling
anim_revealtrueboolthe page wiping in when it loads
anim_panelstrueboolpanels opening like a shutter
anim_loadingtrueboolthe braille wave while a page downloads
anim_noticestrueboolnotices typing themselves out
scroll_speed"normal"slow normal fasthow quickly scrolling catches up
search_engine"duckduckgo"duckduckgo wikipedia github, or a URL with %swhere plain words go
homepage""an address or a filewhat wr opens with no address; "" = the start page
render_jstrueboolrender pages drawn by JavaScript with an installed Chromium/Chrome
update_checktrueboollook for a newer wr in the background (at most every 12 hours)
whats_newfalseboolshow the release notes in a small window when there is an update, and after you update
historytrueboolremember the pages you visit
history_limit100050–20000how many visits to keep
background_refreshtrueboolrefresh a cached page while you read it, and tell you if it changed
cachetrueboolkeep pages on disk
cache_days301–3650days 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.