intervention / pinboard
Searchable local Pinboard mirror
Requires
- php: ^8
- guzzlehttp/guzzle: ~7.4
- illuminate/database: ^9.0
- joetannenbaum/alfred-workflow: ^0.1.2
- kijin/pinboard-api: 0.3.*
- nesbot/carbon: ~2.5
- symfony/console: ^6.0
- vlucas/phpdotenv: ^5.3
README
This packages provides a local command line interface to interact with your link collection at pinboard.in. The main reason behind this project is, to have a local mirror of all Pinboard links an a Sqlite database to be able to search the whole collection quickly with Alfred. Therefore this packages also provides an Alfred Workflow.
Installation
The best way to install this package is globally with Composer.
Require the package via Composer:
$ composer global require intervention/pinboard
After installation you will have a new pinboard executable in ~/.composer/vendor/bin. It is convenient to have this folder in your $PATH.
Setup
Next you have to configure your Pinboard credentials. To do so create ~/.pinboard your home directory and put in your username and your access token.
PINBOARD_USERNAME=myusername
PINBOARD_TOKEN=mypinboardtoken
Now you can run the application, to sync your links from your Pinboard account.
$ pinboard sync
You can automate the syncing process by calling the script regularly as a cron job.
Usage in Alfred 4
Now you have local database of all your links. To be able to search your links with Alfred, import the workflow SearchPinboard.alfredworkflow by double clicking or dragging it into the application settings.
You may need to alter the path to the php executable in the Script Filter node. Feel free to change the other settings of the workflow as you like.
Now you should be able to search your Pinboard links quickly with Alfred by typing p and your search string.
License
Intervention Pinboard is licensed under the MIT License.
Copyright 2022 Oliver Vogel