Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spamwax/alfred-pinboard
Alfred Workflow for Pinboard (written in Go (golang))
https://github.com/spamwax/alfred-pinboard
alfred alfred-workflow bookmark go pinboard
Last synced: about 1 month ago
JSON representation
Alfred Workflow for Pinboard (written in Go (golang))
- Host: GitHub
- URL: https://github.com/spamwax/alfred-pinboard
- Owner: spamwax
- Archived: true
- Created: 2013-12-15T10:17:19.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-03-15T09:59:28.000Z (over 6 years ago)
- Last Synced: 2024-06-20T12:43:07.909Z (3 months ago)
- Topics: alfred, alfred-workflow, bookmark, go, pinboard
- Language: Go
- Size: 110 KB
- Stars: 145
- Watchers: 9
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-starred-test - spamwax/alfred-pinboard - Alfred Workflow for Pinboard (written in Go (golang)) (Go)
README
# The project is in maintanance mode. An improved/feature rich alternative is now being developed using Rust: [alfred-pinboard-rs](https://github.com/spamwax/alfred-pinboard-rs)
Rust-based project is replacing this one. The new project works with Alfred 3's better and offers a range of new features such as tag suggestion, pin preview in Alfred, pin deletion, improved control over posting and better configuration option.# Alfred Workflow for Pinboard
There are probably similar [Alfred](http://www.alfredapp.com/) Workflows out there but my main motivation for writing this was to learn the Go language.
(Alfred forum's post for this workflow: [http://goo.gl/zVgTFW](http://goo.gl/zVgTFW))
## Features
Pinboard is a great and reliable bookmarking service. Its [front page](https://pinboard.in) sums it all:
"**Social Bookmarking for Introverts. Pinboard is a fast, no-nonsense bookmarking site.**"This plugin will let you:
- _**post**_ a bookmark to Pinboard right from Alfred. It has 'tag' autocomplete feature that will help you in selecting proper tags for the bookmark.
- _**search**_ your current bookmarksFor 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.
### Supported Browsers:
- Chrome
- Chromium
- Firefox
- Safari
- Vivaldi
- Firefox Dev. Edition
- Safari Tech. PreviewFor searching, use ( ps ) and then type the search keywords.
## Installation
After [downloading](https://github.com/spamwax/alfred-pinboard/releases/latest) 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 [settings page](https://pinboard.in/settings/password).Then invoke Alfred and enter your username:token after the ***"pa"*** keyword:
![image](https://bitbucket.org/listboss/go-pinboard/wiki/authentication.png)
This workflow will keep a local cache of the tags that you have in Pinboard. To update the cache, you need to issue the ***"pu"*** command:
![image](https://bitbucket.org/listboss/go-pinboard/wiki/update.png)
Use this command once in while to keep the local cache up-to-date.
## Usage (post a bookmark):
The syntax to post a bookmark to Pinboard is :```
p tag1 tag2 tag3 ; some optional note
```The workflow will show a list of your current tags as you enter the command:
![image](https://bitbucket.org/listboss/go-pinboard/wiki/tag-suggestion-1.png)
The number below each tag shows how many times you have used it in your Pinboard service.
You can move Alfred's highlighter to the desired tag and hit '**Tab**' to autocomplete it.![image](https://bitbucket.org/listboss/go-pinboard/wiki/tag-suggestion-2.png)
To finish the process just press Enter.
If you want to add extra description to the bookmark you can add it after the semi-colon:![image](https://bitbucket.org/listboss/go-pinboard/wiki/adding-notes.png)
**Extra:** Adding *toread* anywhere after semi-colon will set the `toread` flag on bookmark.
![toread](https://bitbucket.org/repo/4RyXyx/images/651058289-Screen%20Shot%202017-12-08%20at%203.24.22%20AM.png)
## Usage (search bookmarks):
Searching your bookmarks is easy.```
ps search1 search2 search3
```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 (Desrciption of bookmark, its tags and url and its extended notes). 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.
![image](https://bitbucket.org/listboss/go-pinboard/wiki/bookmarks-search-results.png)
## Additional Settings
- To enable/disable fuzzy search of tags/bookmarks, use:
```pset fuzzy``` and then select one of the options.![image](https://bitbucket.org/listboss/go-pinboard/wiki/set-fuzzy.png)
When fuzzy search is enabled, the tags/bookmarks that contain the query letters in the given order are displayed:
![image](https://bitbucket.org/listboss/go-pinboard/wiki/fuzzy-search-tags.png)
- If you only want to search tags (using ```ps tag_name``` command), set the options like this:
- ```pset tagonly```![image](https://bitbucket.org/listboss/go-pinboard/wiki/tag_only.png)
- To enable/disable sharing the bookmarks, use:
- ```pset shared```![image](https://bitbucket.org/listboss/go-pinboard/wiki/shared.png)
- To enadle/disable auto-updating of the cache that this workflow uses for searching, use the following. Note that by enabling the auto-update, workflow will fetch all your bookmarks from Pinboard after every new bookmark you create using it:
- ```pset auto```![image](https://bitbucket.org/listboss/go-pinboard/wiki/auto_update.png)
- You can set the max. number of tags or bookmarks that you want to be displayed using these two keywords:
- ```pset tags```
- ```pset bmarks```![image](https://bitbucket.org/listboss/go-pinboard/wiki/set-max-tags.png)
![image](https://bitbucket.org/listboss/go-pinboard/wiki/set-max-bmarks.png)- You can show the current settings value using:
```pset show```Hitting enter on each item will let you set that option.
![image](https://bitbucket.org/listboss/go-pinboard/wiki/set-show.png)
## Alfred Helper for Go
In the process of writing this workflow, I have written a small but full feature Go package that helps with the development of the Alfred workflows in Go. It's very similar to [other Alfred Helpers](http://dferg.us/workflows-class/) just written in Go language, you can check it out at:[https://bitbucket.org/listboss/go-alfred](https://bitbucket.org/listboss/go-alfred)
## TODO / Missing features
I wish to add the following in the coming releases:
- ~~Add capability to search the bookmark within Alfred~~
- Add popular (public) tags to the tag suggestion list.
- ~~Add support for [Delicious](https://delicious.com/) API.~~ (Pinboard bought Deliciout and closed it off! :relieved:)## Feedback / Bugs
This is my first non-trivial project using Go language so so your [feedback or bug](https://bitbucket.org/listboss/go-pinboard/issues?status=new&status=open) reports are greatly appreciated.