docs(favorites): describe native sidebar shortcuts
- commit
- 4c9a8b75f0a1e4c8922f1788796d72d489f919d2
- author
- brice · · 2026-06-28 16:24 UTC
- parent
- 49e42b7
- signature
- GPG Verified
CD88F9E564E0102646FB6077A1A07C7C7C3E349D· arch-gpg Verified for the committer email
1 file · +8 -2
M docs/reference/keybindings.md +8 -2
| @@ -84,7 +84,8 @@ These work outside modal modes: | |||
| 84 | 84 | |--------|------| | |
| 85 | 85 | | Toggle floating pane | `Alt+F` | | |
| 86 | 86 | | Toggle History sidebar (native GTK sidebar panel only). Ctrl+H may conflict with the browser's default History shortcut; behavior can vary by browser. | `Ctrl+H` | | |
| 87 | - | | Toggle Favorites system view in right split | unbound by default | | |
| 87 | + | | Toggle Favorites sidebar (native GTK bookmarks panel) | `Ctrl+B` | | |
| 88 | + | | Toggle current page favorite/bookmark | `Ctrl+D` | | |
| 88 | 89 | | Toggle Config system view in right split | unbound by default | | |
| 89 | 90 | | Close pane (or release floating pane) | `Ctrl+W` | | |
| 90 | 91 | | Next tab | `Ctrl+Tab` | | |
| @@ -97,6 +98,8 @@ These work outside modal modes: | |||
| 97 | 98 | - `Alt+F` is the only floating-pane shortcut enabled by default. | |
| 98 | 99 | - `Alt+F` toggles floating visibility and keeps floating pane state intact. | |
| 99 | 100 | - `Ctrl+H` toggles the native GTK history sidebar. The sidebar shows browsing history grouped by day with search/filter, keyboard navigation (arrows, Home/End, Ctrl+arrows for day jumps), and activation modes (Enter to navigate while keeping the sidebar open, Ctrl+Enter to navigate while keeping the sidebar open, Shift+Enter to open in a new split). If the native sidebar is unavailable, the shortcut returns an error instead of falling back to `dumb://history`. | |
| 101 | + | - `Ctrl+B` toggles the native GTK Favorites sidebar. Search matches favorite titles, URLs, and tag names. `Tab`/`Shift+Tab` cycle sidebar zones; `Enter` and `Ctrl+Enter` open the selected favorite in the current pane while keeping the sidebar open; `Shift+Enter` opens it in a new split. Inside the sidebar, `a` adds, `e` edits, `t` opens tag mode, `s` opens shortcut mode, `Delete` starts delete confirmation, `/` focuses search, `Esc` clears/cancels/closes, `r` reloads, and `c` clears search and filters. | |
| 102 | + | - `Ctrl+D` toggles the active page as a favorite/bookmark. Favorite shortcut metadata can be assigned in the sidebar, but global `Alt+1..9` remains tab switching. | |
| 100 | 103 | - `Ctrl+W` closes the active pane; when the floating pane is active, it fully releases that floating session. | |
| 101 | 104 | - Any URL shortcut (for example `Alt+G`) must be defined explicitly in `workspace.floating_pane.profiles`. | |
| 102 | 105 | - Floating profile shortcuts support modifier combos with `ctrl`, `shift`, and `alt` (for example `ctrl+shift+y` or `ctrl+alt+m`). | |
| @@ -125,7 +128,10 @@ keys = ["alt+f"] | |||
| 125 | 128 | keys = ["ctrl+h"] | |
| 126 | 129 | ||
| 127 | 130 | [workspace.shortcuts.actions.toggle-favorites-systemview] | |
| 128 | - | keys = [] | |
| 131 | + | keys = ["ctrl+b"] | |
| 132 | + | ||
| 133 | + | [workspace.shortcuts.actions.toggle-current-page-favorite] | |
| 134 | + | keys = ["ctrl+d"] | |
| 129 | 135 | ||
| 130 | 136 | [workspace.shortcuts.actions.toggle-config-systemview] | |
| 131 | 137 | keys = [] | |
| @@ -84,7 +84,8 @@ These work outside modal modes: | |||||
| 84 | |--------|------| | 84 | |--------|------| | ||
| 85 | | Toggle floating pane | `Alt+F` | | 85 | | Toggle floating pane | `Alt+F` | | ||
| 86 | | Toggle History sidebar (native GTK sidebar panel only). Ctrl+H may conflict with the browser's default History shortcut; behavior can vary by browser. | `Ctrl+H` | | 86 | | Toggle History sidebar (native GTK sidebar panel only). Ctrl+H may conflict with the browser's default History shortcut; behavior can vary by browser. | `Ctrl+H` | | ||
| 87 | - | | Toggle Favorites system view in right split | unbound by default | | 87 | + | | Toggle Favorites sidebar (native GTK bookmarks panel) | `Ctrl+B` | |
| 88 | + | | Toggle current page favorite/bookmark | `Ctrl+D` | | |||
| 88 | | Toggle Config system view in right split | unbound by default | | 89 | | Toggle Config system view in right split | unbound by default | | ||
| 89 | | Close pane (or release floating pane) | `Ctrl+W` | | 90 | | Close pane (or release floating pane) | `Ctrl+W` | | ||
| 90 | | Next tab | `Ctrl+Tab` | | 91 | | Next tab | `Ctrl+Tab` | | ||
| @@ -97,6 +98,8 @@ These work outside modal modes: | |||||
| 97 | - `Alt+F` is the only floating-pane shortcut enabled by default. | 98 | - `Alt+F` is the only floating-pane shortcut enabled by default. | ||
| 98 | - `Alt+F` toggles floating visibility and keeps floating pane state intact. | 99 | - `Alt+F` toggles floating visibility and keeps floating pane state intact. | ||
| 99 | - `Ctrl+H` toggles the native GTK history sidebar. The sidebar shows browsing history grouped by day with search/filter, keyboard navigation (arrows, Home/End, Ctrl+arrows for day jumps), and activation modes (Enter to navigate while keeping the sidebar open, Ctrl+Enter to navigate while keeping the sidebar open, Shift+Enter to open in a new split). If the native sidebar is unavailable, the shortcut returns an error instead of falling back to `dumb://history`. | 100 | - `Ctrl+H` toggles the native GTK history sidebar. The sidebar shows browsing history grouped by day with search/filter, keyboard navigation (arrows, Home/End, Ctrl+arrows for day jumps), and activation modes (Enter to navigate while keeping the sidebar open, Ctrl+Enter to navigate while keeping the sidebar open, Shift+Enter to open in a new split). If the native sidebar is unavailable, the shortcut returns an error instead of falling back to `dumb://history`. | ||
| 101 | + | - `Ctrl+B` toggles the native GTK Favorites sidebar. Search matches favorite titles, URLs, and tag names. `Tab`/`Shift+Tab` cycle sidebar zones; `Enter` and `Ctrl+Enter` open the selected favorite in the current pane while keeping the sidebar open; `Shift+Enter` opens it in a new split. Inside the sidebar, `a` adds, `e` edits, `t` opens tag mode, `s` opens shortcut mode, `Delete` starts delete confirmation, `/` focuses search, `Esc` clears/cancels/closes, `r` reloads, and `c` clears search and filters. | |||
| 102 | + | - `Ctrl+D` toggles the active page as a favorite/bookmark. Favorite shortcut metadata can be assigned in the sidebar, but global `Alt+1..9` remains tab switching. | |||
| 100 | - `Ctrl+W` closes the active pane; when the floating pane is active, it fully releases that floating session. | 103 | - `Ctrl+W` closes the active pane; when the floating pane is active, it fully releases that floating session. | ||
| 101 | - Any URL shortcut (for example `Alt+G`) must be defined explicitly in `workspace.floating_pane.profiles`. | 104 | - Any URL shortcut (for example `Alt+G`) must be defined explicitly in `workspace.floating_pane.profiles`. | ||
| 102 | - Floating profile shortcuts support modifier combos with `ctrl`, `shift`, and `alt` (for example `ctrl+shift+y` or `ctrl+alt+m`). | 105 | - Floating profile shortcuts support modifier combos with `ctrl`, `shift`, and `alt` (for example `ctrl+shift+y` or `ctrl+alt+m`). | ||
| @@ -125,7 +128,10 @@ keys = ["alt+f"] | |||||
| 125 | keys = ["ctrl+h"] | 128 | keys = ["ctrl+h"] | ||
| 126 | 129 | ||||
| 127 | [workspace.shortcuts.actions.toggle-favorites-systemview] | 130 | [workspace.shortcuts.actions.toggle-favorites-systemview] | ||
| 128 | - | keys = [] | 131 | + | keys = ["ctrl+b"] |
| 132 | + | ||||
| 133 | + | [workspace.shortcuts.actions.toggle-current-page-favorite] | |||
| 134 | + | keys = ["ctrl+d"] | |||
| 129 | 135 | ||||
| 130 | [workspace.shortcuts.actions.toggle-config-systemview] | 136 | [workspace.shortcuts.actions.toggle-config-systemview] | ||
| 131 | keys = [] | 137 | keys = [] | ||