# Tinboard
## 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:
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>.
### 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)
Raw data
{
"_id": null,
"home_page": "https://github.com/davep/tinboard",
"name": "tinboard",
"maintainer": "Dave Pearson",
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": "davep@davep.org",
"keywords": "bookmark, pinboard, terminal",
"author": "Dave Pearson",
"author_email": "davep@davep.org",
"download_url": "https://files.pythonhosted.org/packages/8d/b8/4362ca8a4c3e85f3a6e8f5bb94895b13d034e810e227822414cd0e5de4be/tinboard-0.15.1.tar.gz",
"platform": null,
"description": "# Tinboard\n\n\n\n## Introduction\n\nTinboard is a terminal-based client application for the [Pinboard\nbookmarking service](https://pinboard.in/about/). It provides the ability to\nmanage and search your bookmarks in the terminal.\n\n## Installing\n\n### pipx\n\nThe package can be installed using [`pipx`](https://pypa.github.io/pipx/):\n\n```sh\n$ pipx install tinboard\n```\n\nOnce installed run the `tinboard` command.\n\n### Homebrew\n\nThe package is available via Homebrew. Use the following commands to install:\n\n```sh\n$ brew tap davep/homebrew\n$ brew install tinboard\n```\n\nOnce installed run the `tinboard` command.\n\n## Getting started\n\nTo use Tinboard you will need a Pinboard account (this application isn't\ngoing to be useful to anyone who isn't a Pinboard user). Assuming you *do*\nhave a Pinboard account, you can get going by running up `tinboard` and\nproviding your API token when asked:\n\n\n\nIf you're not sure where to find your API token, just press <kbd>F1</kbd>,\nor the `Go to token` button, and you'll be taken to the relevant Pinboard\npage in your browser; copy the token, come back to this dialog and paste it\nin.\n\nOnce done Tinboard will download your bookmarks and you're good to go!\n\n*NOTE: if it's your preference, you can set the token in an environment\nvariable called `TINBOARD_API_TOKEN`.*\n\n## Using Tinboard\n\nThe best way to get to know Tinboard is to read the help screen, once in the\nmain application you can see this by pressing <kbd>F1</kbd>.\n\n\n\n### Quick add on the command line\n\nTinboard has a (currently experimental) quick inline add feature. If you\nrun:\n\n```sh\n$ tinboard add\n```\n\nan inline version of the bookmark editor will be shown in your terminal,\nallowing you to quickly add a bookmark and then carry on without running up\nthe full application.\n\n## Getting help\n\nIf you need help, or have any ideas, please feel free to [raise an\nissue](https://github.com/davep/tinboard/issues) or [start a\ndiscussion](https://github.com/davep/tinboard/discussions).\n\n## TODO\n\nThings I'm considering adding or addressing:\n\n- [ ] Double-check the rate limits on the API calls to be sure they're correct.\n- [ ] A bookmark export facility.\n- [ ] A bookmark availability checker.\n - [ ] Check the current bookmark.\n - [ ] A mode that slowly checks all bookmarks.\n- [ ] Support for Pinboard Notes.\n- [X] Optionally sort the tags by count.\n\n[//]: # (README.md ends here)\n",
"bugtrack_url": null,
"license": "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
"summary": "A Pinboard client for the terminal",
"version": "0.15.1",
"project_urls": {
"Discussions": "https://github.com/davep/tinboard/discussions",
"Documentation": "https://github.com/davep/tinboard/blob/main/README.md",
"Homepage": "https://github.com/davep/tinboard",
"Issues": "https://github.com/davep/tinboard/issues",
"Source": "https://github.com/davep/tinboard"
},
"split_keywords": [
"bookmark",
" pinboard",
" terminal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "044e8f0fec9b431d01e09ecf57c891aa38795954d44f2ef18dba6aa5cf82fb44",
"md5": "b77e546c2b1818c5cdbe39cffad21760",
"sha256": "b57453dd13619c7372a000a9b545710e34939d402045afb5ccd242085bbeb084"
},
"downloads": -1,
"filename": "tinboard-0.15.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b77e546c2b1818c5cdbe39cffad21760",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 49755,
"upload_time": "2024-06-23T20:28:50",
"upload_time_iso_8601": "2024-06-23T20:28:50.990030Z",
"url": "https://files.pythonhosted.org/packages/04/4e/8f0fec9b431d01e09ecf57c891aa38795954d44f2ef18dba6aa5cf82fb44/tinboard-0.15.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8db84362ca8a4c3e85f3a6e8f5bb94895b13d034e810e227822414cd0e5de4be",
"md5": "c517540435553202cae9ef78275a8e76",
"sha256": "3d5448a8a6729e1b822c9bb4bb2734ee43d191367a39df40f5c07c196ee26598"
},
"downloads": -1,
"filename": "tinboard-0.15.1.tar.gz",
"has_sig": false,
"md5_digest": "c517540435553202cae9ef78275a8e76",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 36226,
"upload_time": "2024-06-23T20:28:53",
"upload_time_iso_8601": "2024-06-23T20:28:53.504985Z",
"url": "https://files.pythonhosted.org/packages/8d/b8/4362ca8a4c3e85f3a6e8f5bb94895b13d034e810e227822414cd0e5de4be/tinboard-0.15.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-23 20:28:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "davep",
"github_project": "tinboard",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tinboard"
}
JSON
