Buchen

Buchen is a bookmark manager. Protocol Launcher allows you to generate Buchen URL scheme links.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

Notes

Buchen's official support page documents exactly these URL scheme forms:

• buchen://add-tag?name=<tag name>
• buchen://add?name=<bookmark name>&url=<url>&browser=<browser ?>
• buchen://go-bookmarks
• buchen://go-tags
• buchen://go-folders

The official page says any parameter block containing ? is optional, and any URL passed as a value must be URL encoded. addBookmark() percent-encodes the bookmark URL as a query value. The optional browser value is limited to the official names: safari, edge, icab mobile, opera, brave, chrome, firefox, firefox focus, duckduckgo, quiche, and jayson.

Buchen documents safari as another name for the default browser, and says browser values are referenced everywhere with these names, including Buchen JSON export files.

Add Tag

On-Demand

import { addTag } from 'protocol-launcher/buchen'

const url = addTag({
  name: 'reading list',
})

Add Tag in Buchen

Add Bookmark

On-Demand

import { addBookmark } from 'protocol-launcher/buchen'

const url = addBookmark({
  name: 'Protocol Launcher',
  url: 'https://www.example.com/',
})

Add Bookmark in Buchen

Add Bookmark with Browser

On-Demand

import { addBookmark } from 'protocol-launcher/buchen'

const url = addBookmark({
  name: 'Protocol Launcher',
  url: 'https://www.example.com/search?q=url scheme',
  browser: 'firefox focus',
})

Add Bookmark with Browser in Buchen

Go to Bookmarks

On-Demand

import { goBookmarks } from 'protocol-launcher/buchen'

const url = goBookmarks()

Go to Buchen Bookmarks

Go to Tags

On-Demand

import { goTags } from 'protocol-launcher/buchen'

const url = goTags()

Go to Buchen Tags

Go to Folders

On-Demand

import { goFolders } from 'protocol-launcher/buchen'

const url = goFolders()

Go to Buchen Folders

Generated URLs

addTag({
  name: 'reading list',
})
// => 'buchen://add-tag?name=reading%20list'

addBookmark({
  name: 'Protocol Launcher',
  url: 'https://www.example.com/',
})
// => 'buchen://add?name=Protocol%20Launcher&url=https%3A%2F%2Fwww.example.com%2F'

addBookmark({
  name: 'Protocol Launcher',
  url: 'https://www.example.com/search?q=url scheme',
  browser: 'firefox focus',
})
// => 'buchen://add?name=Protocol%20Launcher&url=https%3A%2F%2Fwww.example.com%2Fsearch%3Fq%3Durl%20scheme&browser=firefox%20focus'

goBookmarks()
// => 'buchen://go-bookmarks'

goTags()
// => 'buchen://go-tags'

goFolders()
// => 'buchen://go-folders'

Official Documentation

• Buchen Supported URL Schemes