Skip to main content

Tinboard

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:

The Tinboard token input dialog

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.

Tinboard Help

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)

Source distribution for tinboard 0.15.1
File Size Uploaded Provenance
tinboard-0.15.1.tar.gz 36.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for tinboard 0.15.1
File Interpreter ABI Platform
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page