Roofs The fast pinboard.in client for macOS

Roofs

The current version is 1.8.3 [2019-08-10]

When you have a subscription for the Pinboard.in 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 pinboard.in 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
  • 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
  • Can grab bookmark information from any browser.
  • Indicates when a link is probably broken
  • Can show website favicons
  • 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 pinboard.in
  • Shortcuts for all major functionality
  • Auto dark/light mode or mode of your choice (Mojave)
  • 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 https://pinboard.in subscription.


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

Apple doesn't allow App Store applications to control other applications (sandbox). That's one of the reasons the Apple environment is so stable and reliable.
The downside is, Roofs cannot grab information from your browser...

However it is possible to get the url, title, description and current browser filled in automatically.
You have to tap ⌘L, ⌘C and end with your New Bookmark shortcut.
The first two key combinations store the url in the System's clipboard. That is enough for Roofs the extract the rest of the information.

Do not forget to have a look at Hint 2.

Searching

Searching inside all of your bookmarks is easy and fast. It will change the way you work with pinboard.in. 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 Pinboard.in website or via a shortcut. Roofs takes care of up-to-date contents.
Do not forget to have a look at Hint 2.

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 only)
(Mojave only)

Hint 1

For large bookmark collections (think over 1,000), it is best practice to do all your 'bookmarking' from inside Roofs.
Why?
If changes are made on the pinboard.in 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 pinboard.in. So your pinboard.in collection is always up-to-date.

Hint 2

You are a power user. So chances are that you use Keyboard Maestro. If so, you're in luck. It is an incredibly useful tool on your Mac.
With the help of Keyboard Maestro it is easy to create a new bookmark in Roofs from any webpage with just a stroke of a key.


Download this Keyboard Maestro macro.

Important: In your Roofs Settings you clear the Add Bookmark hotkey (it will default to ⌃⇧B).
Change the trigger hot key in the Keyboard Maestro macro (in my example F18) to the one you want and you're done!

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.