Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Keyboard shortcuts

Burrow is keyboard-first. Every toolbar button’s tooltip shows its key, and blygger +list-keybinds prints this list from the app itself.

On Windows, read every ⌘ as Ctrl (⌘⏎ is Ctrl+Enter, ⇧⌘, is Ctrl+Shift+,), with two exceptions: Versions is Ctrl+Shift+Y, because Ctrl+Y is Redo there, and Discard changes has no key (Ctrl+Alt+Z is AltGr+Z, which types a letter on some layouts): use Menu › Post › Discard Changes… or the toolbar. The app’s tooltips, menu and +list-keybinds show the Windows keys.

⌥⌘R, ⌥⌘Q and ⌥⌘L (Reply · new stub, Quote into a thread, Link post) act on the post in front of you: in Reading the open post, else the selected one; in Posts your own published post.

The main table

This part is generated from the app’s key table (crates/blyg-app/src/keymap.rs), the one that binds the keys and builds the menus and toolbar buttons.

Anywhere

KeyWhat it doesMenu
⌘,SettingsBurrow › Settings…
⇧⌘,Reload the config fileBurrow › Reload Config
⌘<Reload the config file
⌘QQuitBurrow › Quit Burrow
⌘DMake draft (a scratch note → a draft on the blyg)Post › Make Draft
⌘SQuick capture: keep it (scratch, or a draft per capture-default)

In the main window

KeyWhat it doesMenu
⌘LSearch / the omnibarPost › Find…
⌘NNew postPost › New Post
⌘⏎Publish… (focus outside a text field)
⌘TFragment ⇄ threadPost › Fragment ⇄ Thread
⌘EPreview on/off, in placeView › Preview
⌘OOpen the post on the webPost › Open on the Web
⌘=Bigger textView › Bigger
⌘+Bigger text
⌘-Smaller textView › Smaller
⌘0Actual sizeView › Actual Size
⌘1Write: list + editorView › Write
⌘2List + editor + previewView › List + Editor + Preview
⌘3Full editor: editor + previewView › Full Editor
⌘GGenerate: fill the [TK] under the caret, or open the AI helpersPost › Generate (TK)
⇧⌘GShorten to fit 1000 (AI; you accept or reject)Post › Shorten to Fit 1000
⌘RReading list (again: back to posts)Blyg › Reading
⇧⌘MMentions & responsesBlyg › Mentions
⇧⌘SSubscriptionsBlyg › Subscriptions
⌘YVersions of this postPost › Versions…
⌘JLineage: what this post draws on and what draws on itPost › Lineage…
⌘KQuote a post in this threadPost › Quote…
⌥⌘RReply · new stub: a thread of yours that’s a stub of this post (yours too)Post › Reply · New Stub
⌥⌘QQuote this post into a thread (![[…]]; the draft open, or a new one)Post › Quote into a Thread
⌥⌘LLink post · new fragment: [[…]] to this post, no stub_ofPost › Link Post · New Fragment
⌥⌘1Reading as a stream (the default)Blyg › Stream
⌥⌘2Reading as a list with the post beside itBlyg › Reader
⌥⌘SShow or hide the Reader’s sources pane (smart feeds, folders)Blyg › Sources Pane
⇧⌘RCheck all feeds now (your blyg polls every subscription)Blyg › Check All Feeds Now
⇧⌘⌫Delete this draft or scratch note (asks first)Post › Delete Draft…
⌥⌘ZDiscard unpublished changes: back to the published version (asks first) (no key on Windows, where it would be AltGr+Z)Post › Discard Changes…
⌘IProfile of this post’s author (yours on your own post); again closes itBlyg › Profile
⇧⌘OOpen a profile: paste a blyg, a post or a feedBlyg › Open Profile…
⌥⌘→Tutorial: next step
⌥⌘←Tutorial: previous step
⇧⌘BBrowser pane: close it, or bring back the last page (none yet: open it to type an address)View › Show/Hide Browser Pane
⇧⌘NNotes drawer: open or close it (quotes a selected passage)View › Notes
⇧⌘DQuote the highlighted passage (a page, a post or your notes) in the draftPost › Quote Selection in Draft
⇧⌘PExtensions: run an extension’s command, browse its notes, manage themPost › Extensions…

While typing in the editor or a text field

KeyWhat it doesMenu
⌘⏎Publish…Post › Publish…

In the browser pane

KeyWhat it doesMenu
⌘[Browser pane: back
⌘]Browser pane: forward
⌘RBrowser pane: reload (or stop)
⌘LBrowser pane: edit the address
⇧⌘CBrowser pane: clip the page (or the passage selected on it) into the draftPost › Clip Page to Draft

On a browser macro’s Preview and Post sheets

KeyWhat it doesMenu
⌘⏎Macro Preview sheet: continue
⏎Macro Post sheet: post
escMacro Preview or Post sheet: cancel

In the menus, without a key

What it doesMenu
Check spelling while typing (on/off; the spellcheck config key)Edit › Spelling › Check Spelling While Typing
Disconnect from this blygBurrow › Disconnect…
Open the config fileBurrow › Open Config File
Check for a new release now (whatever auto-update says)Burrow › Check for Updates…
Quick capture (the global hotkey, capture-hotkey)Burrow › Quick Capture
Subscribe to a blyg or feedBlyg › Subscribe…
Import subscriptions from another reader’s OPML fileBlyg › Import Subscriptions from OPML…
Save every subscription as an OPML fileBlyg › Export Subscriptions as OPML…
The blyg’s site settings (title, bio, links)Blyg › Site Settings…
A new folder for your subscriptions (on this Mac only)Blyg › New Folder…
Withdraw this published post (asks first; permanent and visible)Post › Withdraw…
Your own profile, as visitors see itBlyg › My Profile
The interactive tutorial (on sample data)Help › Burrow Tutorial
Version, build, updates and connection infoBurrow › About Burrow
Version, build, updates and connection infoHelp › About Burrow
Browser pane: open it with the address field ready (macOS)View › Open Browser…

Keys in context

These belong to one screen or sheet, so they aren’t in the table above.

The omnibar and the editor

KeyWhat it does
↑ / ↓Move through the posts, previewing each one
⏎Open the selected post, or start a draft when nothing matches
escClear the search; from the editor, back to the omnibar
⌃⌥BQuick capture, from any app (capture-hotkey)
⌘K, or ![[ at the start of a lineQuote a post (threads only); ⏎ inserts ![[… | note]] on its own line
[[Link a post; ⏎ inserts [[… | label]]
@Mention a blyg

Quick capture and the notes drawer

KeyWhat it does
esc, ⌘SKeep it (a scratch note, or a draft with capture-default = draft)
⌘DMake it a draft on your blyg
⌘⏎Publish it (from the notes drawer: open it in the editor to publish)

Reading

KeyWhat it does
j / k, ↑ / ↓Next / previous post
⏎, SpaceOpen the post (stream); Space pages through it, then the next unread one (Reader)
⌘-click, ⇧-click, ⌘APick posts in the Reader’s list (esc lets go)
r / uMark the picked posts, or the open one, read / unread
← / →Move between the Reader’s panes
[ / ]Step through a post’s versions (current and pinned)
⌘F, /Search what you’re reading
escClose the post or the search

Sheets

KeyWhat it does
⏎Confirm (publish, delete, discard changes, accept)
escCancel or close
1 / 2 / 3In a conflict: keep mine, take the server’s, keep both
⇥, F, ←In a profile: switch tabs, follow the selected entry, go back