Simple command line pinboard client.
ISC License
A simple command line pinboard client.
You can add, delete, and list your bookmarks right in your terminal. Incredible.
Usage: pin
pin rm URL
pin add URL [OPTION]
pin ls [OPTION]
Options:
-title title of bookmark being added
-tag space delimited tags
-private mark bookmark as private
-readlater mark bookmark as read later
-text longer description of bookmark
-l long format for ls
go get -u github.com/imwally/pin
Before running pin
you must first create a .pinboard
configuration
file in your home directory that contains your authentication
token. This token can be found on the password tab of the settings
page.
Adding a bookmark is done by using the add
subcommand. It requires
one argument -- the page you want to bookmark. The title is
automatically copied from the page so there's no need to supply one.
$ pin add http://www.sweetwebsite.com
However, if you prefer to supply your own title you can use the
-title
flag.
$ pin add http://www.sweetwebsite.com -title "One Sweet Site"
Of course you can tag your bookmark as well. Use the -tag
flag with space
delimited terms.
$ pin add http://www.sweetwebsite.com -title "One Sweet Site" -tag "sweet site cool"
Need even more context for your bookmark? Use the -text
flag.
$ pin add http://www.sweetwebsite.com -title "One Sweet Site" \
-tag "sweet site cool" \
-text "I think this is one sweet site so I'm bookmarking it."
You can also specify the private -private
or read later -readlater
flags.
The only requirement to delete a bookmark is the URL.
$ pin rm http://www.sweetwebsite.com
If you made a mistake or changed your mind about a recent bookmark you can quickly remove the last bookmark added with the help of pipes (thanks, Douglas McIlroy).
$ pin ls | head -1 | pin rm
You can list the most recent bookmarks.
$ pin ls
If you want more information use the long format -l
flag. The
private [*]
and readlater [#]
markers will appear next to the
title.
$ pin ls -l
Bookmarks can be filtered by specifying some tags.
$ pin ls -tag "programming unix"
Bookmarks flagged for readlater can also be filtered.
$ pin ls -readlater