12.4 The ‘roam-ref’ Protocol

This protocol finds or creates a new note with a given roam_key (see Anatomy of an Org-roam File):

To use this, create a Firefox bookmarklet as follows:

javascript:location.href =
'org-protocol://roam-ref?template=r&ref='
+ encodeURIComponent(location.href)
+ '&title='
+ encodeURIComponent(document.title)

or as a keybinding in qutebrowser in , using the config.py file (see Configuring qutebrowser):

config.bind("<Ctrl-r>", "spawn bash -c 'emacsclient \"org-protocol://roam-ref?template=r&ref={url:pretty}&title={title}\" '")

where template is the template key for a template in org-roam-capture-ref-templates (see The Templating System). These templates should contain a #+roam_key: ${ref} in it.