Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zoni/pingrep
Pingrep is a command-line tool designed to quickly and easily search through your Pinboard bookmarks locally.
https://github.com/zoni/pingrep
bookmarks cli-app pinboard pinboard-bookmarks
Last synced: 4 months ago
JSON representation
Pingrep is a command-line tool designed to quickly and easily search through your Pinboard bookmarks locally.
- Host: GitHub
- URL: https://github.com/zoni/pingrep
- Owner: zoni
- License: other
- Created: 2023-09-09T10:41:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-05T16:23:52.000Z (10 months ago)
- Last Synced: 2024-04-14T02:43:06.692Z (9 months ago)
- Topics: bookmarks, cli-app, pinboard, pinboard-bookmarks
- Language: Rust
- Homepage:
- Size: 357 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pingrep
`pingrep` is a command-line tool designed to quickly and easily search through your [Pinboard] bookmarks locally.
## Usage
pingrep provides several commands to help you manage and search your Pinboard bookmarks.
Here's a brief overview of the most important commands:
### `pingrep login`
Before using pingrep, you need to configure it with your Pinboard API token using:
```sh
pingrep login
```
Pingrep will securely store this token in the system keyring.
### `pingrep fzf`
This command opens an interactive search interface using [`fzf`][fzf], allowing you to search and filter your Pinboard bookmarks easily.
#### Keybindings
- `enter`: Open the selected bookmark in a browser, then exit.
- `ctrl+o`: Open the selected bookmark in a browser, don't exit.
- `ctrl+e`: Open the selected bookmark on [pinboard.in][pinboard].
- `ctrl-y`: Copy the URL of the selected bookmark to the clipboard (requires [cbcopy]).
### `pingrep search ...`
> [!IMPORTANT]
> This command has not been implemented yet.
Search for bookmarks using one or more search queries.
Replace `` with your search terms.
You can use multiple queries to narrow down your search.
### `pingrep show `
View detailed information about a specific bookmark by providing its URL as an argument.
### `pingrep update`
Update the local cache of your Pinboard bookmarks to ensure you have the latest data.
Linux users may want to refer to these examples to automate this using a systemd timer:
- [pingrep-update.service]
- [pingrep-update.timer]
### Additional Information
For more information and detailed usage instructions, refer to the built-in help documentation:
```sh
pingrep --help
```
## License
Pingrep is open-source software released under the [BSD-2-Clause Plus Patent License].
This license is designed to provide: a) a simple permissive license; b) that is compatible with the GNU General Public License (GPL), version 2; and c) which also has an express patent grant included.
Please review the [LICENSE] file for the full text of the license.
[BSD-2-Clause Plus Patent License]: https://spdx.org/licenses/BSD-2-Clause-Patent.html
[LICENSE]: LICENSE
[cbcopy]: https://github.com/zoni/dotfiles/blob/f724b16f85649786d393119500033455f21b42ab/src/.local/bin/cbcopy
[install-go]: https://go.dev/doc/install
[fzf]: https://github.com/junegunn/fzf
[pinboard]: https://pinboard.in
[pingrep-update.service]: https://github.com/zoni/dotfiles/blob/main/src/.config/systemd/user/pingrep-update.service
[pingrep-update.timer]: https://github.com/zoni/dotfiles/blob/main/src/.config/systemd/user/pingrep-update.timer