NOTE: Right now the workflow does not support URLs with "#" in it.
Overview
Pinboard workflow is a front end for Pinboard that allows you:
search
filter by tags
add public bookmarks
add private bookmarks
set a new bookmark as To Read
delete a bookmark
get the selected text as the bookmark description (see Syntax)
interact with: Safari, Google Chrome, Google Chrome Canary, Chromium, Webkit and Firefox
First Run
Before running the workflow you need to set your Pinboard API Token:
To get it go to your Pinboard account and copy the API in Settings>Password.
To enter it open Alfred Preferences>Workflows then select Pinboard then, finally, click in Configure Workflow and Variables (as seen below):
Usage
If you need help show Alfred and type the keyword phelp
Search
Search will always look for URL, title, description and tags.
Basic search
show Alfred and type the keyword ps
type your query e.g. ps apple
Filtering by tags
show Alfred and type the keyword ps
type a hash sign and select a tag from the list (autocomplete) e.g. ps #tag1 #tag2 :
after the colon type your query e.g. ps #tag1 #tag2 :apple
Actions
return key: open the bookmark
option key: delete the bookmark (you may need to manually reload the local cache)
Add
Public, Private and To Read Bookmarks
The workflow will list always two options:
Add Public Bookmark to Pinboard
Add Private Bookmark to Pinboard
Holding Command key will add it as an unread bookmark.
Note: make sure your Browser is the front most window then use the keyword pa
Note: Firefox may need that you reload the page. Anyway, the workflow always show the URL so you can check if it is right or not.
Last Used
The workflow also saves the last command (Last Used item) so you can easily replicate. And with a hotkey you can add a bookmark even without any interaction at all.
Syntax
You can optionally add tags and a custom description.
To add tags simply type a hash sign and select it from the list (autocomplete) e.g. pa #tag1 #tag2 :
After the colon, as seen above, you can optionally type the bookmark description e.g. pa #tag1 #tag2 :great workflow
And in order to get the selected text as the bookmark description type enclosed brackets after the colon e.g. pa [] or pa #tag1 #tag2 :[]
To add just a description just type it after the keyword e.g. pa great workflow
Hotkeys
Search, Add and Last Used have also a hotkey that you can set in Alfred Preferences.
Local Bookmark Cache
In order to make things a bit faster, the workflow caches all your Pinboard bookmarks and tags.
However, due even Pinboard API limitations the workflow will not, for now at least, update the cache automatically.
However, if your cache is more than one day older the workflow will let you know.
Anyway, you can use the keyword preload to manually update the local cache.
Finally, the workflow has an external trigger so you can update the local cache from other application or script. Just use the code below:
tell application "Alfred 3"
run trigger "reload" in workflow "com.sztoltz.pinboard" with argument ""
end tell
Download
Version 1.5 for Alfred 3
Release date: 08 Jul 2016
Requires Alfred 3
macOS 10.11.5
Download Now
What’s New in Version 1.5 (08 Jul 2016)?
- Fixed the add new bookmark bug
What’s New in Version 1.4 (27 Jun 2016)?
- Moved workflow setting to Alfred Preferences
- Updated Help (keyword phelp)
- NOTE: you have to enter your Pinboard API token again