Skip to content

thenbe/fzf-raindrop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

fzf-raindrop-demo-out.mp4

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_TOKEN="..." fzf-raindrop update

# or using nix
FZF_RAINDROP_TOKEN="..." 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 have github.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_TOKEN yes "a1b2c3..." Get from Raindrop app*
FZF_RAINDROP_DATA_DIR $HOME/.local/share/fzf-raindrop

Generate a Raindrop token

A test token is sufficient for our needs. To create one:

  1. Go to the Raindrop app settings.
  2. Click Create new app. Name it fzf-raindrop.
  3. Click on the item you just created.
  4. Click on Create test token.

Dependencies

Contributing

  • To generate a picker with fake data, clone the repo, run nix develop .#demo, then follow the on-screen prompt.
  • Embedded SQL snippets can be formatted using sleek (If using vim: highlight SQL string in visual mode, then :!sleek)