pinboard.el
Commentary:
pinboard.el is an Emacs client for Pinboard.
To get started, visit your password settings
page on Pinboard and get the API
token that's displayed there. Then edit ~/.authinfo and add a line like
this:
machine api.pinboard.in password foo:8ar8a5w188l3
Once done, you can M-x pinboard RET and browse your pins. Current commands available include:
| Command | Key | Description |
|---|---|---|
pinboard-add |
n | Add a new pin |
pinboard-delete |
d | Delete the current pin |
pinboard-edit |
e | Edit the current pin |
pinboard-kill-url |
k | Add pin's URL to the kill-ring. |
pinboard-open |
RET | Open the pin's URL in a web browser |
pinboard-private |
P | Show only private pins in the list |
pinboard-public |
p | Show only public pins in the list |
pinboard-read |
r | Show only read pins in the list |
pinboard-refresh |
g | Refresh the list, showing all pins |
pinboard-search |
/ | Show only pins that contain the search text |
pinboard-extend-tagged |
t | Add a tag to the current tag filter |
pinboard-tagged |
T | Show only pins with a given tag |
pinboard-toggle-read |
R | Toggle the read/unread status of the pin |
pinboard-unread |
u | Show only unread pins in the list |
pinboard-untagged |
T | Show only pins that have no tag |
pinboard-view |
SPC | View the data for a pin in a window |
pinboard-visit-pinboard |
v | Visit the Pinboard website |
Commands available that aren't part of the pin list, and that you might want to bind to keys, include:
| Command | Description |
|---|---|
pinboard |
Open the Pinboard pin list |
pinboard-add |
Add a new pin to Pinboard |
pinboard-add-for-later |
Prompt for a URL and add it for later |
Org support
Konrad Hinsen has written a handy little
add-on that connects
pinboard with org-mode, by providing an easy method of pulling a link
out of pinboard and getting it into org-mode. See the gist he wrote for
the code.
Troubleshooting
pinboard.el doesn't find API token despite it being set in .authinfo
Check the variable auth-sources to ensure that Emacs is looking for
.authinfo. Some Emacs-frameworks set their own default (typically
enforcing gpg encryption).
If you're using use-package, you can append the ~/.authinfo file to
the auth-sources list like this:
(use-package pinboard :config (add-to-list 'auth-sources "~/.authinfo" t))TODO
Please see the GitHub issues list for things I plan to do.