0.14.14and before), you may have to directly download latest version and then open it in Finder
Pinboard is a great and reliable bookmarking service. Its front page sums it all: "Social Bookmarking for Introverts. Pinboard is a fast, no-nonsense bookmarking site."
This plugin will let you:
After initial setup:
For posting you just need to enter the Workflow's keyword (
p ) into Alfred's window and follow it with couple of tags and an optional description. The workflow will then post a bookmark for the window/tab of the active browser to Pinboard.
For searching, use (
ps ) and then type the search keywords.
After downloading the latest version of the workflow and installing it in Alfred, you need to do a one-time setup to authenticate the Workflow. This Workflow only uses username/token method so you won't need to enter your password. (This is the suggested way of using Pinboard's API). If you don't have a token, get one from Pinbaord's setting's page.
Then invoke Alfred and enter your username:token after the "pa" keyword:
This workflow will keep a local cache of the tags and bookmarks that you have in Pinboard, and, by default, automatically update the cache. (See manual updates )
The syntax to post a bookmark to Pinboard is :
p tag1 tag2 tag3 ; some optional note (semi-colon & note are optional)
The workflow will show a list of your current tags as you are typing:
The number below each tag shows how many times you have used it in Pinboard bookmarks. You can move Alfred's highlighter to the desired tag and hit 'Tab' to autocomplete it.
To finish the process just press Enter.
If tag suggestion feature is enabled (see
pset suggest_tags), 3 popular tags based on current active webpage will be added to the list of your tags. The list is fetched from Pinboard's API and is often helpful. However this feature will add a 1 second delay to showing the tag list after first keystroke. This delay is disabled for consequent keystrokes as the fetched popular tags are cached.
You can hold down modifiers to one-time change some of your settings:
After entering last desired tag, you can hit enter to post the bookmark. If you want to add extra description to the bookmark you can add it after a semi-colon:
If the current page is already saved, you will be notified. However the workflow assumes that:
are all different bookmarks and will not notify you about duplication!
Searching your bookmarks is easy.
ps query1 query2 query3 ...
Workflow will use the text you enter in Alfred and show list of bookmarks that contain all of the search keywords in any of the bookmarks information (Description of bookmark, its tags, its url and its extended notes). However, these search fields can be adjusted, see settings.
So the more search keywords you enter the less results will be displayed as it tries to find the bookmarks that contain all of the keywords.
The search result is ordered in descending order of dates they were posted to your Pinboard account.
To show tags (instead of URLs) in search results subtitles, use
You can hold down modifiers to enable different behavior:
⌥and pressing enter will open the bookmark in Pinboard's website.
To delete a bookmark, just make sure it is opened in your current browser's window. Then use
Proposed workflow for deleting a bookmark is to first open it in browser (search for it using this workflow's keyword
ps, and hit enter) and then use
pind keyword followed by enter.
pr old_tag new_tag
Note: Pinboard tag renaming API lacks providing error message if
old_tag is not in your tag collection!!! It basically says
success even though no renaming was done!
You can configure the behavior of workflow by entering
pconf in Alfred:
Selecting each setting and hitting ⏎ (Enter) will let you adjust it:
On top of using
pconf, you can directly type following commands to also adjust the settings:
pset fuzzy: Enable/disable fuzzy search.
pset suggest_tags: When posting a new bookmark, list popular tags for the active page. Note that this information is fetched from Pinboard and sometimes is not very accurate.
pset shared: Mark all new bookmarks as shared.
pset toread: Mark all new bookmarks as toread.
pset check_bookmarked: Notify if active page is already bookmarked.
pset tagonly: Only search within tag field while doing any look-up.
pset auto: After posting a new bookmark, automatically update the local cache.
pset tags: Set number of tags to show:
pset tags 25
pset bookmarks: Set number of bookmarks to show:
pset bookmarks 12
pset url_tag: Show either URLs or tags in search results subtitles
To manually update the cache, you need to issue the
Most of configuration settings are self-explanatory. However
fuzzy search may need a demo.
When fuzzy search is enabled, the tags/bookmarks that contain the query letters in the given order are displayed:
Otherwise, normal search will search for consecutive characters in query:
pindwon't work when Firefox is your active browser. Reason: Firefox does not properly support interacting with it programatically.
cannot be opened because the developer cannot be verified.error, check out this issue as well as the post on Alfred forum
I wish to add the following in the coming releases:
This is my first non-trivial project using Rust language so so your feedback or bug reports are greatly appreciated.
This open source software is licensed under MIT License.