~/vimma $ less docs/bookmarks.md

page 2/5 · docs/bookmarks

Bookmarks

Vimma uses Firefox's own bookmarks, the ones you imported, synced or see in the Library, and gives them keys: one to file a page, one to open a panel where you find it again. Each workspace has its own folder of them.

Bookmark a page

  1. Press ctrl+b a. A prompt opens at the bottom of the window with the page's title in it.
  2. It goes in the current workspace's folder: Bookmarks Toolbar → work when you are in work. To file it in folders there, type them in front of the title, separated by /: docs/My page. Missing folders are made; Tab completes a folder name. @shop/deals/Cart files it in another workspace's folder.
  3. Press Enter to save, or Esc to cancel.

A page that is already bookmarked shows where it is; edit the path to move or rename it. Renaming a workspace renames its folder; deleting one asks whether to keep, move or delete its bookmarks.

Find a bookmark

ctrl+b shift+b opens the current workspace's bookmarks as a tree on the left of the window, and follows you when you switch workspace ([bookmarks] root in config.toml shows the whole toolbar, or every bookmark). The quickest way in is /: type a few letters of a title, address or folder.

ToPress
Move down / upj / k
Open a folder / close itl / h
Open the bookmark here and close the panelEnter
Open it in a new background tabt
Open it in a split right / belows / S
Filter everything/
Close the panelEsc

Tidy up from the panel

ToPress
Add this page in the highlighted foldera
Add a folderA
Rename / move / deleter / m / d
Copy the bookmark's addressy

All the keys for this page

The default bindings, as Vimma's own ctrl+b ? overlay lists them. Name is the action's name, which you use to remap it or to run it as a : command. Every key is on the keys page.

Bookmarks (14)

ActionKeysName
Open / close the bookmarks panelctrl+b shift+btoggle_bookmarks
Bookmark this page (folders/title files it in folders)ctrl+b aadd_bookmark
Bookmarks: close the folder, or go to its parenthpanelbookmarks_collapse
Bookmarks: open the folder or the bookmarklpanelbookmarks_expand
Bookmarks: open in a new background tabtpanelbookmarks_open_tab
Bookmarks: open in a split rightspanelbookmarks_vsplit
Bookmarks: open in a split belowSpanelbookmarks_hsplit
Bookmarks: add this page here (a/b/ makes folders)apanelbookmarks_add
Bookmarks: add a folder hereApanelbookmarks_folder
Bookmarks: renamerpanelbookmarks_rename
Bookmarks: move to a foldermpanelbookmarks_move
Bookmarks: delete (asks y/N)dpanelbookmarks_delete
Bookmarks: copy the URLypanelbookmarks_yank
Bookmarks: filter/panelbookmarks_filter

Details

Everything below is Vimma's own user guide for this topic, in full: every edge case and exception. You do not need it to get started.

Vimma's bookmarks are Firefox's: what you imported, what Sync brings and what the Library shows. Vimma keeps no list of its own; it gives you keys to reach them.

One folder per workspace. Each workspace owns a folder in the Bookmarks Toolbar, named after it: work's bookmarks live in Bookmarks Toolbar → work. The folder is made when you add the workspace's first bookmark, or adopted when a toolbar folder of that name is already there. Vimma remembers it by its id, not only its name: renaming the workspace (:wsrename) renames the folder, and a folder renamed in the Library stays the workspace's. A workspace from config.toml and one made with :wsnew work the same.

Bookmark a page from anywhere: ctrl+b a (or :bookmark). A prompt opens at the foot of the window with the page's title and the cursor before it, in the current workspace's folder. Type folders in front of the title, separated by /: in work, docs/My page files the page in Bookmarks Toolbar → work → docs, and makes the folders that are not there yet. Tab completes a folder name (again: the next match). Enter saves, Esc cancels. A path ending in / files the page in that folder under its title. :bookmark docs/My page saves at once, without the prompt. Start a path with @name/ for another workspace's folder: @shop/deals/Cart; Tab after @ completes workspace names.

If the page is bookmarked already, Vimma says where (already bookmarked: docs/My page, or @shop/deals/Cart in another workspace) and the prompt changes to move/rename: with that path: edit it and press Enter to move or rename the bookmark, or Esc to leave it. A bookmark outside every workspace folder (in the Menu, Other Bookmarks or loose in the toolbar) is named by its path from the Menu, and the prompt offers its title alone: Enter moves it into this workspace. Only http, https, file and about: pages can be bookmarked this way.

The bookmarks panel: ctrl+b shift+b or :bookmarks opens your bookmarks on the left, where the side panel opens; one of the two shows at a time. It works like neo-tree over the current workspace's folder: its bookmarks and subfolders are the top level, with no folder row around them, and the header shows the workspace's name. Switch workspace and the panel follows. An empty folder shows a note saying what the panel shows, that a adds the current page, and how to see the rest.

Bookmarks outside workspace folders (loose in the toolbar, in the Menu or in Other Bookmarks) do not show in a workspace's panel. To see them, set root in config.toml:

schema = 2

[bookmarks]
root = "toolbar"    # the whole Bookmarks Toolbar; "all": every bookmark; default "workspace"

With "toolbar" the panel is the toolbar's contents, workspace folders and loose bookmarks alike, and paths count from the toolbar. With "all" it is the Bookmarks Menu's folders and bookmarks, with toolbar and other (and mobile, when you have some) as the first folders, and paths count from the Menu (start one with toolbar/ or other/ for those). A private window, which has no workspaces, shows the toolbar.

Deleting a workspace (:wsdelete, ctrl+b shift+d) asks y/N as before; when the workspace has bookmarks, a second question asks what becomes of them: k (or Enter) keeps its folder in the toolbar, no longer linked to a workspace; m moves them into another workspace's folder (it names which); d deletes them. Esc or any other key closes nothing. Nothing is deleted unless you press d.

KeyWhat it does
j / kMove down / up.
lOpen the folder (again: go into it). On a bookmark: open it in this tab.
hClose the folder; inside one, go to its folder and close that.
EnterOpen the bookmark in this tab and close the panel; on a folder, open or close it.
tOpen the bookmark in a new tab behind this one; the panel stays open for more.
s / SOpen it in a new pane right / below (as ctrl+b v / -, at most 4 panes).
aAdd this page in the highlighted folder, as a path. As in neo-tree, a/b/ makes folders.
AAdd a folder there.
rRename.
mMove to a folder: type its path (Tab completes); @name/… is another workspace's.
dDelete, after y/N. A folder says how many items go with it.
yCopy the bookmark's address.
/Filter every bookmark by title, address or folder, letters in order. Enter keeps it.
IClose the panel and focus the address bar.
Esc, ctrl+b shift+bClose the panel. With a filter, Esc clears it first.

A bookmark opens in your current workspace's container, and in a private window it stays private. javascript: and data: bookmarks (bookmarklets) are listed but do not open from Vimma: it says so instead, since they would run code in the page. Changes made elsewhere (the Library, Sync, another window) show in the panel at once. With root = "all", the four top folders cannot be renamed, moved or deleted. The panel remembers which folders you opened until Vimma quits.

Known limits

Vimma is pre-alpha. What does not work yet, or works with a catch, is listed on the known limits page:

The guide at the top is written for this site; the details are built from Vimma's docs/guide.md and bindings.md at 1050bcc (2026-10-10).

Keys on this site

Keyboard shortcuts for this website
j kscroll down, up
d uhalf a page down, up
gg Gtop, bottom
/search the docs, or filter the keys
] [next, previous docs page
g hgo home
g dgo to the docs
g kgo to keys
g igo to install
g ago to about
?this help; Esc closes it

In Vimma, ctrl+b ? lists every binding.