{"id":13397557,"url":"https://github.com/spamwax/alfred-pinboard","last_synced_at":"2025-03-14T00:32:27.300Z","repository":{"id":12531403,"uuid":"15201355","full_name":"spamwax/alfred-pinboard","owner":"spamwax","description":"Alfred Workflow for Pinboard (written in Go (golang))","archived":true,"fork":false,"pushed_at":"2018-03-15T09:59:28.000Z","size":113,"stargazers_count":145,"open_issues_count":2,"forks_count":11,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-07-31T18:20:48.554Z","etag":null,"topics":["alfred","alfred-workflow","bookmark","go","pinboard"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spamwax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-15T10:17:19.000Z","updated_at":"2024-04-02T17:41:25.000Z","dependencies_parsed_at":"2022-09-16T23:41:04.720Z","dependency_job_id":null,"html_url":"https://github.com/spamwax/alfred-pinboard","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spamwax%2Falfred-pinboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spamwax%2Falfred-pinboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spamwax%2Falfred-pinboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spamwax%2Falfred-pinboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spamwax","download_url":"https://codeload.github.com/spamwax/alfred-pinboard/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243504802,"owners_count":20301507,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alfred","alfred-workflow","bookmark","go","pinboard"],"created_at":"2024-07-30T18:01:30.902Z","updated_at":"2025-03-14T00:32:26.929Z","avatar_url":"https://github.com/spamwax.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"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)\nRust-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.\n\n# Alfred Workflow for Pinboard\n\nThere are probably similar [Alfred](http://www.alfredapp.com/) Workflows out there but my main motivation for writing this was to learn the Go language.\n\n(Alfred forum's post for this workflow: [http://goo.gl/zVgTFW](http://goo.gl/zVgTFW))\n\n## Features\nPinboard is a great and reliable bookmarking service. Its [front page](https://pinboard.in) sums it all:\n\"**Social Bookmarking for Introverts. Pinboard is a fast, no-nonsense bookmarking site.**\"\n\nThis plugin will let you:\n\n- _**post**_ a bookmark to Pinboard right from Alfred. It has 'tag' autocomplete feature that will help you in selecting proper tags for the bookmark.\n- _**search**_ your current bookmarks\n\nFor posting you just need to enter the Workflow's keyword ( \u003ckbd\u003ep\u003c/kbd\u003e ) 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.\n\n### Supported Browsers:\n- Chrome\n- Chromium\n- Firefox\n- Safari\n- Vivaldi\n- Firefox Dev. Edition\n- Safari Tech. Preview\n\nFor searching, use ( \u003ckbd\u003eps\u003c/kbd\u003e ) and then type the search keywords.\n\n## Installation\nAfter [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).\nIf you don't have a token, get one from Pinbaord's [settings page](https://pinboard.in/settings/password).\n\nThen invoke Alfred and enter your username:token after the ***\"pa\"*** keyword:\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/authentication.png)\n\nThis 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:\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/update.png)\n\nUse this command once in while to keep the local cache up-to-date.\n\n## Usage (post a bookmark):\nThe syntax to post a bookmark to Pinboard is :\n\n```\np tag1 tag2 tag3 ; some optional note\n```\n\nThe workflow will show a list of your current tags as you enter the command:\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/tag-suggestion-1.png)\n\nThe number below each tag shows how many times you have used it in your Pinboard service.\nYou can move Alfred's highlighter to the desired tag and hit '**Tab**' to autocomplete it.\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/tag-suggestion-2.png)\n\nTo finish the process just press Enter.\nIf you want to add extra description to the bookmark you can add it after the semi-colon:\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/adding-notes.png)\n\n**Extra:** Adding *toread* anywhere after semi-colon will set the `toread` flag on bookmark.\n\n![toread](https://bitbucket.org/repo/4RyXyx/images/651058289-Screen%20Shot%202017-12-08%20at%203.24.22%20AM.png)\n\n\n## Usage (search bookmarks):\nSearching your bookmarks is easy.\n\n```\nps search1 search2 search3\n```\n\nWorkflow 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.\n\nThe search result is ordered in descending order of dates they were posted to your Pinboard account.\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/bookmarks-search-results.png)\n\n## Additional Settings\n\n- To enable/disable fuzzy search of tags/bookmarks, use:\n```pset fuzzy``` and then select one of the options.\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/set-fuzzy.png)\n\nWhen fuzzy search is enabled, the tags/bookmarks that contain the query letters in the given order are displayed:\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/fuzzy-search-tags.png)\n\n- If you only want to search tags (using ```ps tag_name``` command), set the options like this:\n\t- ```pset tagonly```\n\n\t![image](https://bitbucket.org/listboss/go-pinboard/wiki/tag_only.png)\n\n- To enable/disable sharing the bookmarks, use:\n\t- ```pset shared```\n\n\t![image](https://bitbucket.org/listboss/go-pinboard/wiki/shared.png)\n\n- 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:\n\t- ```pset auto```\n\n\t![image](https://bitbucket.org/listboss/go-pinboard/wiki/auto_update.png)\n\n\n- You can set the max. number of tags or bookmarks that you want to be displayed using these two keywords:\n\t- ```pset tags```\n\t- ```pset bmarks```\n\n\t![image](https://bitbucket.org/listboss/go-pinboard/wiki/set-max-tags.png)\n\t![image](https://bitbucket.org/listboss/go-pinboard/wiki/set-max-bmarks.png)\n\n- You can show the current settings value using:\n```pset show```\n\n\tHitting enter on each item will let you set that option.\n\n![image](https://bitbucket.org/listboss/go-pinboard/wiki/set-show.png)\n\n## Alfred Helper for Go\nIn 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:\n\n[https://bitbucket.org/listboss/go-alfred](https://bitbucket.org/listboss/go-alfred)\n\n## TODO / Missing features\n\nI wish to add the following in the coming releases:\n\n- ~~Add capability to search the bookmark within Alfred~~\n- Add popular (public) tags to the tag suggestion list.\n- ~~Add support for [Delicious](https://delicious.com/) API.~~ (Pinboard bought Deliciout and closed it off! :relieved:)\n\n\n## Feedback / Bugs\nThis is my first non-trivial project using Go language so so your [feedback or bug](https://bitbucket.org/listboss/go-pinboard/issues?status=new\u0026status=open) reports are greatly appreciated.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspamwax%2Falfred-pinboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspamwax%2Falfred-pinboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspamwax%2Falfred-pinboard/lists"}