Roofs The fast client for macOS


The current version is 1.10.0

When you have a subscription for the bookmarking site, this is the application you want!
Pinboard is a bookmarking service with no ads or tracking. The same goes for Roofs: no user tracking, no adds.

In this time of subscriptions and in-app purchases it is nice to know that Roofs is a one time buy.

With the Roofs application, you'll find your bookmarked sites quick and easy. You will find out, that this application revives your subscription: you're gonna use it all the time.
All bookmarks are buffered locally for an even faster experience.
A global shortcut of your choice opens the search window. Start typing and hit return to open the wanted web page. No trip to the mouse or trackpad is needed.

Features Overview

  • Fast, smart search in your bookmark collection
  • Safe, Roofs fills in your url
  • Add a new bookmark from any browser, no browser extension or - plugin needed
  • Add a bookmark to a Tab Group; all bookmarks belonging to a tab group can be opened in browser tabs with a click of a button
  • Create a new bookmark from the Status Menu or via the Dock icon
  • If a webpage provides extra information this is automatically filled in for you when you add a bookmark
  • Can run as a background application without Dock icon
  • Smart tag completion when editing bookmark settings
  • Overview by date entered, date used or most used
  • Each bookmark can open in your browser of choice
  • Set a default browser to use with bookmarks without a preferred browser
  • Indicates when a link is probably broken
  • Can show website favicons (via DuckDuckGo API)
  • Remembers last used screen position and window size
  • Customizable Space Bar action: toggle read/unread or shared/private
  • Customizable swipe actions
  • Offers option to change an insecure bookmark to a secure one with a click of the mouse
  • The Dock icon shows the total number or the to read number of bookmarks (or nothing)
  • Always keeps in sync with the bookmarks on
  • Bookmarks can be exported to a bookmarks file
  • Shortcuts for all major functionality
  • Auto dark/light mode or mode of your choice (Mojave or higher)
  • No additional recurring subscription, just a one time buy
  • Written entirely in Swift

First start

When you open the application for the first time, you will be asked for the TOKEN from your subscription. An authentication token is a short opaque identifier in the form "username:TOKEN"

When you click on the icon next to the TOKEN field, your web browser will open the page with your personal TOKEN (you have to be logged in for this).
Copy it into the token field and press the Login button.
After a short while, depending on how many bookmarks you have, the list with all your bookmarks will appear. The lastest ones you have added are on top.
If you prefer, you can show the lastest used on top.
The next time you'll activate Roofs, the overview will be there immediately.

Roofs sees the kind of sharing you use most (public of private) and will set this as your default. All the bookmarks that do not have this default value, will be marked.
Any dead link in your current bookmarks will be noticed too and marked.

Adding bookmarks

When you use Roofs for adding bookmarks, macOS needs to give permission to do that.
Here you can find some extra information on it.

Once a bookmark is added, it can be attached to a group. When you select a so called Tab Group all links will be opened simultaneously.


Searching inside all of your bookmarks is easy and fast. It will change the way you work with From now on you will really use it.

(This video uses an older version of Roofs)

Start searching by typing. The intial search is on title, description and tags.
If you start your search with T+space or U+space, the search will be on tags or urls only.
You can also change the search mode via the button on the left of the field.
The first result is selected. You can use the up- and down arrows to select another bookmark.
Press Return and the wanted page opens in your web browser (Roofs goes to the background).
When there is no hit in your bookmarks, you can continue typing to search in a Search Engine of choice.

This is all you have to know to get started.
Of course you can fine-tune most settings as desired.

Some detail

Roofs can run in the background. You can toggle between regular- and background mode via a Status menu.
When you hit the trigger key combination, the program gets active and lets you start with searching for your bookmarks.
Fast finding is the main purpose of Roofs.

There are a lot of possibilities inside the program for managing your bookmarks. Most options are available via shortcuts, such as:

  • ⇧⌃B New bookmark (can be changed)
  •   ⌘E Edit the selected bookmark
  •   ⌘1 Last added bookmarks on top
  •   ⌘2 Last used bookmarks on top
  •   ⌘3 Most used bookmarks on top
  •   ⌘, Show Settings

Every day actions are available in the Touch Bar (if your Mac has one of course).

In the New and Edit dialog you can adjust most of the bookmark properties. Typing tags is with smart auto completion.
The results are shown immediately.
Remember: all actions can be done with your keyboard (if you prefer).

In the Settings you can change the activation shortcut (default is ⇧⌘B), tell your program to launch at login, choose what is your sharing default and more.

preferences-1 preferences-2 preferences-3 preferences-1

All bookmarks that are not your sharing default will be marked in the list. So, if you have chosen for 'Private', every bookmark that is 'Public' will be marked. And vice-versa.
You can enter a new bookmark via a browser bookmarklet offered by the website or via a shortcut. Roofs takes care of up-to-date contents.

You can always go back or close a panel, by tapping the esc key.

Light-dark mode

Roofs will automatically adjust its appearance for Mojave's Light - and Dark Mode. But if you want you can change this setting to light or dark.

(Mojave or higher only)
(Mojave or higher only)


For large bookmark collections (think over 1,000), it is best practice to do all your 'bookmarking' from inside Roofs.
If changes are made on the website, Roofs will notice there were changes. But Roofs doesn't know what has changed. So the program has to reload all bookmarks and find the change(s). Depending on the speed of your network and computer, this can take some time.

On the other hand, changes made in Roofs are reflected immediately to So your collection is always up-to-date.

This application collects in no way personal data from its user.
For connecting with the Pinboard API you use a token provided by Pinboard. This enables accessing your Pinboard account without having to store a copy of your password.
A subscriber can always reset this token.