Metadata-Version: 2.1
Name: tinboard
Version: 0.14.0
Summary: A Pinboard client for the terminal
Home-page: https://github.com/davep/tinboard
Author: Dave Pearson
Author-email: davep@davep.org
Maintainer: Dave Pearson
Maintainer-email: davep@davep.org
License: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Project-URL: Documentation, https://github.com/davep/tinboard/blob/main/README.md
Project-URL: Source, https://github.com/davep/tinboard
Project-URL: Issues, https://github.com/davep/tinboard/issues
Project-URL: Discussions, https://github.com/davep/tinboard/discussions
Keywords: bookmark,pinboard,terminal
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Environment :: Console
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Education
Classifier: Topic :: Internet
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: <3.13,>=3.10
Description-Content-Type: text/markdown
Requires-Dist: textual>=0.57.0
Requires-Dist: xdg-base-dirs>=6.0.0
Requires-Dist: pytz
Requires-Dist: humanize>=4.8.0
Requires-Dist: httpx
Requires-Dist: pyperclip

# Tinboard

![Tinboard](https://raw.githubusercontent.com/davep/tinboard/main/images/tinboard.png)

## Introduction

Tinboard is a terminal-based client application for the [Pinboard
bookmarking service](https://pinboard.in/about/). It provides the ability to
manage and search your bookmarks in the terminal.

## Installing

### pipx

The package can be installed using [`pipx`](https://pypa.github.io/pipx/):

```sh
$ pipx install tinboard
```

Once installed run the `tinboard` command.

### Homebrew

The package is available via Homebrew. Use the following commands to install:

```sh
$ 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](https://raw.githubusercontent.com/davep/tinboard/main/images/token-request.png)

If you're not sure where to find your API token, just press <kbd>F1</kbd>,
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 <kbd>F1</kbd>.

![Tinboard Help](https://raw.githubusercontent.com/davep/tinboard/main/images/help.png)

### Quick add on the command line

Tinboard has a (currently experimental) quick inline add feature. If you
run:

```sh
$ 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](https://github.com/davep/tinboard/issues) or [start a
discussion](https://github.com/davep/tinboard/discussions).

## 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.
- [X] Optionally sort the tags by count.

[//]: # (README.md ends here)
