Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imwally/pin
Simple command line pinboard client.
https://github.com/imwally/pin
Last synced: 16 days ago
JSON representation
Simple command line pinboard client.
- Host: GitHub
- URL: https://github.com/imwally/pin
- Owner: imwally
- License: isc
- Created: 2014-10-05T03:45:42.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2020-02-03T18:33:54.000Z (almost 5 years ago)
- Last Synced: 2024-10-11T02:49:11.170Z (about 1 month ago)
- Language: Go
- Size: 24.4 KB
- Stars: 13
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pin
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
```
### Install
`go get -u github.com/imwally/pin`
### First: Setup your authentication token
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](https://pinboard.in/settings/password).
### Add a bookmark
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"`
### Tagging
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"`
### Descriptions
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."
### More Options
You can also specify the private `-private` or read later `-readlater` flags.
### Delete a bookmark
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](https://en.wikipedia.org/wiki/Douglas_McIlroy)).
`$ pin ls | head -1 | pin rm`
### Show your bookmarks
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`