v0.9.0
guide / Make it yours

Make it yours

Press , (or open the menu with m and choose Settings). You get a list of

v0.9.0 10 / 21 3 min read docs/GUIDE.md
Key (in Settings)What it does
↑ ↓ (or k j)move
PgUp PgDnmove six at a time
Home End (or g G)first / last
← →, Enter or Spacechange the value
d or Backspaceput this option back to its default
Esc or qclose

Every change applies immediately and is saved to the config file.

Finding an option

The menu, Settings, the keyboard shortcuts and the section index (t) all have the same filter. Press / and type: only the entries that mention every word you typed stay, in any order and ignoring case. Settings looks at the name, the group and the help text (cache, braille, scroll, update), the menu at the name, shortcuts at the action and its keys, the index at the heading.

KeyWhat it does
/start filtering (again, to edit what you typed)
typingnarrows the list; ↑ ↓ move among the matches, Backspace deletes
Enterin the menu and the index: do it (open the entry, jump to the section). In Settings and shortcuts: keep the results so you can change the value you found, then ← → or Enter act on it
Escclears the filter (a second Esc closes the panel)

The footer shows the keys that apply at each moment. Everything you type goes into the filter, so q, j or a digit are letters there, not commands. When you are changing a key binding, / is a key like any other and can be bound.

GroupOptions (exact panel names)
LayoutReading width, Center the column, Spacing, Heading rules, Code frames, Guess code language, Links, Braille decoration, Accent color
Footer and scrollbarScrollbar, Footer, Footer rule, Shortcut hints, Reading progress, Footer notes
MouseMouse support, Copy on select, Wheel lines
MotionAnimations (master switch), Smooth scrolling, Scroll speed, Page reveal, Panel animation, Loading wave, Typewriter notices
BrowsingSearch engine, Start page, Render JavaScript pages, Check for updates, Show what’s new, Remember history, History size, Refresh in the background
CacheCache pages, Keep pages for
OtherKeyboard shortcuts…, Reset all settings…

Three ready-made setups, straight into ~/.config/wr/config.toml:

# Distraction-free: just the text, centered, no chrome but the scrollbar
width = 80
center = true
spacing = 1
footer = false
footer_rule = false
scrollbar = false
animations = false
braille = false
heading_rules = false
# A terminal-native look: your 16 colors only, links inline, quiet motion
accent = "green"
links = "inline"
anim_reveal = false
anim_panels = false
anim_notices = false
scroll_speed = "fast"
wheel_lines = 5
# Minimal disk footprint: cache off, history off
cache = false
history = false
# Nothing but the pages you open: no update check, no scripts run on your behalf
update_check = false
render_js = false
# Know what changed: the notes window opens by itself when wr has an update
update_check = true
whats_new = true

The whole configuration lives in one file, ~/.config/wr/config.toml. wr --config creates it if missing and prints its path. You can edit it by hand with anything — including from inside wr: the menu has Edit the config file…, which opens $VISUAL or $EDITOR (default vi) and reloads the settings when you close it. The panel and the file edit the same thing. One caveat: saving from the Settings panel rewrites the whole file, so comments you added by hand are not kept.

wr -L URL hides links for that session only, without changing your saved setting; wr --fresh URL ignores the cache once.