Manage, post and preview your bookmarks on Pinboard right from within Alfred app.
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:
toread
setting momentarily.shared
setting momentarily.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:
http://example.com/list.html
https://example.com/list.html
http://example.com/list.html#fragment
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 pset url_tag
:
You can hold down modifiers to enable different behavior:
⌥
and pressing enter will open the bookmark in Pinboard's website.Either use pind
while the bookmark you want to delete is currently on your active browrser.
Or use the Delete Pinboard Bookmark
action on a bookmark item anywhere in this Workflow or on any url entered in Alfred's window:
To delete a bookmark, just make sure it is opened in your current browser's window. Then use pind
.
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.
Use pr
to search for old tags, select the desired one from Alfred and hit enter. You will be prompted to enter a new tag name. You can either choose from your current tags or enter a new one.
Additonally you can Action on a tag item anywhere in this Workflow and use the Rename Pinboard Tag
action to achieve the same thing. (Requires Alfred 4.5+)
Note: See known issues for some limitations caused by Pinboard's API issues.
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 subtitlesTo manually update the cache, you need to issue the pu
command:
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:
pcheck
.
pind
won't work when Firefox is your active browser. Reason: Firefox does not properly support interacting with it programatically. As a workaround you can install the alfred-firefox workflow. You will not be using that workflow directly, this workflow will use one of alfred-firefox
functions to work around the mentioned issue.cannot be opened because the developer cannot be verified.
error, check out this issue as well as the post on Alfred forumold_tag
is not in your tag collection!!! It basically says success
even though no renaming was done!0.16.12
(or 0.16.7
and before), you may have to directly download latest version and then open it in FinderI 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.