Tinboard
Introduction
Tinboard is a terminal-based client application for the Pinboard bookmarking service. It provides the ability to manage and search your bookmarks in the terminal.
Installing
pipx
The package can be installed using pipx:
$ pipx install tinboard
Once installed run the tinboard command.
Homebrew
The package is available via Homebrew. Use the following commands to install:
$ brew tap davep/homebrew
$ brew install tinboard
Once installed run the tinboard command.
Getting started
To use Tinboard you will need a Pinboard account (this application isn't
going to be useful to anyone who isn't a Pinboard user). Assuming you do
have a Pinboard account, you can get going by running up tinboard and
providing your API token when asked:
If you're not sure where to find your API token, just press F1,
or the Go to token button, and you'll be taken to the relevant Pinboard
page in your browser; copy the token, come back to this dialog and paste it
in.
Once done Tinboard will download your bookmarks and you're good to go!
NOTE: if it's your preference, you can set the token in an environment
variable called TINBOARD_API_TOKEN.
Using Tinboard
The best way to get to know Tinboard is to read the help screen, once in the main application you can see this by pressing F1.
Quick add on the command line
Tinboard has a (currently experimental) quick inline add feature. If you run:
$ tinboard add
an inline version of the bookmark editor will be shown in your terminal, allowing you to quickly add a bookmark and then carry on without running up the full application.
Getting help
If you need help, or have any ideas, please feel free to raise an issue or start a discussion.
TODO
Things I'm considering adding or addressing:
- Double-check the rate limits on the API calls to be sure they're correct.
- A bookmark export facility.
- A bookmark availability checker.
- Check the current bookmark.
- A mode that slowly checks all bookmarks.
- Support for Pinboard Notes.
- Optionally sort the tags by count.
Metadata
Release files for tinboard 0.15.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| tinboard-0.15.1.tar.gz | 36.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tinboard-0.15.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 86.0 kB
Release files / tinboard-0.15.1.tar.gz
| Download URL | tinboard-0.15.1.tar.gz |
|---|---|
| Size | 36.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3d5448a8a6729e1b822c9bb4bb2734ee43d191367a39df40f5c07c196ee26598
|
|
BLAKE2b-256 checksum How to use checksums |
8db84362ca8a4c3e85f3a6e8f5bb94895b13d034e810e227822414cd0e5de4be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.0 CPython/3.12.4
|
Release files / tinboard-0.15.1-py3-none-any.whl
| Download URL | tinboard-0.15.1-py3-none-any.whl |
|---|---|
| Size | 49.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b57453dd13619c7372a000a9b545710e34939d402045afb5ccd242085bbeb084
|
|
BLAKE2b-256 checksum How to use checksums |
044e8f0fec9b431d01e09ecf57c891aa38795954d44f2ef18dba6aa5cf82fb44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.0 CPython/3.12.4
|
Security for tinboard 0.15.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.