Seamlessly import your Raindrop.io bookmarks into Obsidian
Transform your web clippings, articles, and research into a powerful knowledge base.
🚀 Quick Start • 📚 Features • 📖 Documentation • 🤝 Contributing • 💬 Support
Make It Rain is a powerful Obsidian plugin that brings your Raindrop.io bookmarks, highlights, and notes directly into your vault. Whether you're a researcher collecting articles, a reader saving interesting finds, or a developer curating resources, Make It Rain helps you integrate your web discoveries seamlessly into your knowledge base.
The Problem: Your bookmarks live in Raindrop.io, but your knowledge base lives in Obsidian. Keeping them in sync is tedious.
The Solution: Make It Rain automates the import process with flexible filtering, customizable templates, and smart organization.
Fully customize how your notes look with our flexible template system. Choose from pre-configured templates for different content types, or build your own with smart variables.
- Customizable templates with Handlebars-like syntax
- Pre-configured templates for articles, videos, images, links, and more
- Smart variables (formatted dates, domains, tag lists)
- One-click reset to default templates
- Per-import overrides to use different templates on demand
Import exactly what you need with granular filtering options.
- Bulk import with filtering by collections, tags, and content types
- Quick import by URL or ID for individual items
- Dynamic collection selector - browse and select from your Raindrop account
- Tag filtering with AND/OR logic
- Content type filtering (links, articles, images, videos, documents, audio, books)
- Selective sync - fetch only new items or update existing notes
Your imported notes organize themselves based on your Raindrop structure.
- Automatic folder hierarchy mirroring your collections
- Automatic Folder Notes (
FOLDER_NAME.md) generated to serve as structured indexes - Native File Downloads to directly retrieve PDFs, EPUBs, video, and audio file attachments
- Rich YAML frontmatter with comprehensive metadata
- Customizable filenames with template variables
- Auto-tagging - append custom tags to all imports
- Banner images automatically included in notes
Built to handle large Raindrop libraries with confidence.
- Smart rate limiting (120 requests/minute) with automatic retries
- Safe by default - prevents accidental overwrites
- Detailed logging for troubleshooting
- Comprehensive error handling
- Automated testing with CI/CD
Get started in 3 simple steps:
- Download
make-it-rain.zipfrom the latest release⚠️ Downloadmake-it-rain.zip, not the source code - Extract to get
main.js,manifest.json, andstyles.css - Copy these files to your vault's
.obsidian/plugins/make-it-rain/folder - Restart Obsidian
- Enable the plugin in
Settings→Community Plugins
- Go to Raindrop.io Apps settings
- Click + Create new app
- Give it a name (e.g., "Make It Rain")
- Click Create test token
- Copy the token to your clipboard
- Open Obsidian
Settings→Make It Rain - Paste your API token
- Click Verify Token to test the connection
- (Optional) Set your default import folder
- Done! Run "Fetch Raindrops" from the Command Palette to start importing
💡 New to Make It Rain? Check out the Installation Guide for detailed instructions.
Comprehensive documentation is available on our Documentation Site.
Start here based on your experience level:
| Guide | Purpose | Time |
|---|---|---|
| Quick Start | Get up and running | 5 min |
| Installation | Install and configure | 10 min |
| Configuration | Customize settings | 15 min |
| Usage Guide | Learn all features | 30 min |
| Template System | Customize note format | 45 min |
| Troubleshooting | Fix common issues | 10 min |
| FAQ | Common questions | 5 min |
Learn how to contribute to the project:
| Resource | Purpose |
|---|---|
| Developer Guide | Architecture & setup |
| Contributing Guide | How to contribute |
| Testing Guide | Write tests |
| API Reference | API documentation |
| Setting | Description | Default |
|---|---|---|
| API Token | Your Raindrop.io test token (required) | - |
| Default Vault Location | Folder path for imported notes | Vault root |
| Filename Template | Template for note filenames | {{title}} |
| Show Ribbon Icon | Display plugin icon in sidebar | Enabled |
| Banner Field Name | Frontmatter field for banner images | banner |
| Create Folder Notes | Generate index notes for each collection folder | Enabled |
| Download Files | Fetch native Raindrop upload attachments | Enabled |
Use these variables in your filename template:
{{title}}- Raindrop bookmark title{{id}}- Raindrop unique ID{{collectionTitle}}- Collection name{{date}}- Creation date (YYYY-MM-DD format)
Example: {{date}} - {{title}} produces 2024-01-15 - My Bookmark Title.md
Each imported Raindrop becomes a beautifully formatted Markdown note with YAML frontmatter.
---
title: "Understanding React Hooks"
source: https://example.com/article
type: article
created: 2024-01-15T10:30:00Z
lastupdate: 2024-01-16T14:20:00Z
id: 123456789
collectionTitle: "Web Development"
collectionPath: "Learning/Web Development"
tags:
- react
- javascript
- frontend
banner: https://example.com/cover-image.jpg
---The default template structures your notes like this:
# Understanding React Hooks
Your bookmark's description and highlights are formatted with:
- Description section
- Personal notes and annotations
- Highlights with inline comments
- Metadata and details
- Source link
All automatically organized and beautifully formatted!For complete details, see the Note Structure documentation.
- Open Command Palette (
Ctrl/Cmd+P) - Run "Fetch Raindrops"
- Select your collection from the dynamic list
- Click Fetch Raindrops
- Open Command Palette
- Run "Quick Import Raindrop by URL/ID"
- Paste the Raindrop URL or ID
- Click Fetch & Create Note
- Open "Fetch Raindrops" modal
- Configure your filters
- Enable "Override template"
- Choose your template
- Fetch!
- In settings, ensure your collection hierarchy matches your desired folder structure
- Enable "Include Subcollections" when fetching
- Notes will automatically create nested folders
For more tips and workflows, see the Usage Guide.
- Verify you've copied your token correctly
- Click "Verify Token" in settings to test the connection
- Token should start with
eyJ(JWT format)
- Check the Developer Console (
Ctrl/Cmd+Shift+I→Consoletab) - Verify collections/tags exist in your Raindrop account
- Ensure the target vault folder exists
- Check that you have bookmarks in the selected collections
- Verify the template syntax is correct
- Check the browser console for error messages
- Reset to default template to test
- See the Template System guide for syntax help
- Fetch in smaller batches using collection filters
- Import by content type to reduce load
- Enable "Fetch only new items" to skip existing notes
Still need help?
Active development focuses on these features:
- 🔄 Bi-directional sync - Keep Obsidian and Raindrop in sync
- 📌 Enhanced highlights - Better highlight handling in notes
- 💾 Saved presets - Store and reuse fetch configurations
- 🎬 Video tutorials - Learn by watching
- 📊 Archive scraping - Extended content extraction
- ↩️ Undo functionality - Recover from mistakes
See the full GitHub Issues for more planned features.
We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes Make It Rain better.
- Read our Contributing Guide
- Check the Developer Guide
- Follow our Code of Conduct
- Code - Submit pull requests with bug fixes or features
- Documentation - Improve guides or add examples
- Testing - Report bugs or test new features
- Ideas - Suggest features via GitHub Issues
- Translation - Help localize the plugin
# Install dependencies
npm install
# Run in development mode
npm run dev
# Run tests
npm test
# Build for production
npm run buildSee the Developer Guide for detailed setup instructions.
This project is licensed under the MIT License - see the LICENSE file for details.
This means you're free to use, modify, and distribute Make It Rain, provided you include the original license.
If you find Make It Rain useful and want to support its development, consider buying me a coffee! ☕
Even if you can't contribute financially, you can help by:
- ⭐ Starring the repository
- 📢 Sharing the project with friends
- 🐛 Reporting bugs
- 💡 Suggesting features
- 📚 Improving documentation
- 📖 Check the FAQ
- 💬 Ask in GitHub Discussions
- 📧 Email frostmute@gmail.com
- 🐛 Report it on GitHub Issues
- 📋 Use the bug report template for details
- 💡 Suggest it on GitHub Issues
- 📝 Use the feature request template
- 🤝 See Contributing Guide
- 👨💻 Check Developer Guide
| Aspect | Status |
|---|---|
| Build | ✅ Passing |
| Tests | ✅ Setup Complete |
| Documentation | ✅ Comprehensive |
| Community | ✅ Welcoming |
| Maintenance | ✅ Active |
📖 Documentation • 📋 Changelog • 🐛 Issues • 📦 Releases • 🤝 Contributing • 💬 Code of Conduct
Made with ❤️ by frostmute
Whether you're importing bookmarks or building features, thank you for being part of the Make It Rain community! 🌧️✨
