fzf-raindrop
fzf-raindrop copied to clipboard
Fast search through all your Raindrop bookmarks.
fzf-raindrop
Fast search through all your Raindrop bookmarks.
Features
- 🔥 Instant as-you-type fuzzy search (tested on 100,000 bookmarks): thanks to fzf.
- 🚀 Instant launch: convenient for mapping to global system shortcut.
- 🔭 Multi-field search: Search through url, tags, title, highlights, and excerpt.
- ♻️ Offline: A network request is fired only when pulling latest bookmarks.
- 🐙 Multi-select: Use
TAB
to select multiple items and open them in your browser.
Demo
Searching through 120,000 bookmarks and opening 7 of them in new tabs.
https://github.com/thenbe/fzf-raindrop/assets/33713262/599d82bc-9515-4174-88b5-63e6b8697a20
Usage
Run
fzf-raindrop
# or through nix if you prefer
nix run github:thenbe/fzf-raindrop
Pull latest bookmarks
[!NOTE] Bookmarks will be pulled automatically only when you launch
fzf-raindrop
for the first time. After that, you can pull the latest bookmarks by running the following command.
FZF_RAINDROP_COOKIE="..." fzf-raindrop update
# or using nix
FZF_RAINDROP_COOKIE="..." nix run github:thenbe/fzf-raindrop -- update
Key maps
Key | Description |
---|---|
ENTER |
open item(s) in browser |
TAB |
(un)select item |
ctrl+p |
previous query |
ctrl+n |
next query |
Advanced
-
Search syntax. If you search for
#github
you will see both (1) items that are tagged with#github
and (2) items that havegithub.com
in their URL. If you'd like to be more strict and only match the tags, search for'#github
instead. See fzf's advanced search syntax for more.
Installation
Nix
If you have nix installed, use nix run ...
to take advantage of the flake hosted in this repo. See examples above.
Manual
Clone this repo and make sure you have the required dependencies.
Configuration
Env Var | Required | Default | Example | Notes |
---|---|---|---|---|
OPENER |
no | xdg-open , open |
"mimeo" or "firefox" | Program used to launch URLs |
FZF_RAINDROP_COOKIE |
yes | "connect.sid=s%123..." | Get from browser's devtools* | |
FZF_RAINDROP_DATA_DIR |
$HOME/.local/share/fzf-raindrop |
* Unfortunately, the Raindrop API does not expose an endpoint to export all bookmarks using a bearer token. See issue.
Dependencies
Contributing
- To generate a picker with fake data, clone the repo and run
nix develop .#demo
- Embedded SQL snippets can be formatted using
sleek
(If using vim: highlight SQL string in visual mode, then:!sleek
)