Plugin Release - 'Make-It-Rain' - Sync Raindrop Bookmarks & Highlights to your vault with flexible filters and organization

[frostmute]

Make It Rain

Raindrop Importer for Obsidian

Github | frostmute | make-it-rain

This is the initial release of the plugin… I will be addressing any issues found and/or requests actively. Please don’t hesitate to leave feedback and/or suggestions; I will do my best to address them!

This plugin for Obsidian allows you to fetch bookmarks from your Raindrop account and create notes in your vault based on a customizable template. Bring your web clippings, articles, and references directly into your knowledge base!

Features

• Fetch on Demand: Import Raindrops using a command palette action.
• Flexible Filtering: Choose which bookmarks to fetch per-session using the interactive modal:
  • Filter by specific Raindrop Collection IDs (comma-separated).
  • Filter by specific Raindrop Tags (comma-separated, matches items with ALL specified tags).
  • Optionally include items from subcollections when filtering by Collection ID.
• Generated notes include:
  • YAML Frontmatter: title, description (from Raindrop excerpt), source (original URL), tags (combining Raindrop tags and optionally appended tags), banner (using Raindrop cover image URL for plugins like Banner).
  • Note Body: Cover image (if available), H1 Title, H2 section for your Raindrop Note/Annotation, the Raindrop Excerpt, and a list of Highlights (including any notes on highlights).
• Configurable Filenames:
  • Choose whether to use the Raindrop title (processed via template) or the Raindrop ID for filenames.
  • Customize the filename format using a template with placeholders.
• Tag Management: Automatically append custom tags to the frontmatter of every imported note.
• Safe Import: Checks if a note with the target filename already exists in the specified destination within your vault and skips it to prevent overwriting.
• Handles Pagination: Fetches all matching bookmarks from Raindrop, respecting API limits.
• Persistent Settings: Configure your API key, default save location, and filename template preferences.

Installation

Manual Installation

1. Download the main.js, manifest.json, and styles.css files from the latest Release on GitHub.
2. In your Obsidian vault, navigate to plugins directory.
3. Create a new folder named make-it-rain.
4. Copy the downloaded main.js, manifest.json, and styles.css into this new folder.
5. Restart Obsidian.
6. Go to Settings → Community Plugins, find “Make It Rain”, and enable it.
7. Configure the required API Token in the plugin settings.

Using BRAT (Recommended for pre-release versions)

1. Install BRAT (Beta Reviewer’s Auto-update Tester) plugin via the Community Plugins browser.
2. Enable BRAT in Obsidian’s settings.
3. Go to BRAT’s settings, click “Add Beta plugin”, and enter the URL of the GitHub repository.
4. Enable the “Make It Rain” plugin in Settings → Community Plugins.
5. Configure the required API Token in the plugin settings.

Configuration

Before first use, you need to configure the plugin via Obsidian’s settings panel (Settings → Community Plugins → Make It Rain → Options (cog icon)).

1. Raindrop API Token (Required):

   • You must provide a “Test Token” from Raindrop integration settings.
   • Generate one by going to your Raindrop Apps settings page, clicking “+ Create new app”, giving it a name (e.g., “Obsidian Importer”), clicking the created app, and then clicking “Create test token”.
   • Copy this token and paste it into the settings field.

2. Default Vault Location for Notes:

   • Specify a default folder path within your vault where imported notes should be saved (e.g., Raindrops).
   • Leave this blank to save notes directly in the root of your vault.
   • This can be overridden each time you fetch using the modal.

3. File Name Template:

   • Define the structure for filenames when the “Use Raindrop Title for File Name” option is enabled in the fetch modal.
   • Uses Handlebars-like syntax with double curly braces.

Usage

1. Open the Command Palette (usually Ctrl+P or Cmd+P).
2. Search for and select the command: “Fetch Raindrops”.
3. An options modal will appear, allowing you to configure this specific fetch operation:
   • Vault Folder (Optional): Override the default save location for this fetch.
4. • Collections: Enter comma-separated Raindrop Collection IDs if you only want to fetch from specific collections. Find the ID in the URL when viewing a collection on Raindrop (e.g. collection address / 123456). Leave blank to fetch from all (unless filtered by tags).
5. • Filter by Tags: Enter comma-separated Raindrop tag names. The plugin will only fetch bookmarks that contain ALL the tags listed here. Leave blank to not filter by tags (unless filtered by collections).
6. • Include Subcollections: If filtering by Collection IDs, toggle this on to also fetch from any collections nested inside the specified ones.
7. • Append Tags to Note Frontmatter: Enter comma-separated tags that will be added to the tags: list in the YAML frontmatter of every note created during this fetch.
8. • Use Raindrop Title for File Name: Toggle this on (default) to use the File Name Template defined in settings. If off, the Raindrop bookmark ID will be used as the filename.
9. Click the “Fetch Raindrops” button in the modal.

The plugin will show notices indicating progress (“Fetching…”, “Processing…”, final summary). Check the Obsidian Developer Console (Ctrl+Shift+I or Cmd+Option+I) for detailed logs and potential errors.

[frostmute]