A tool to get links from raindrop.io and create a RSS feed with the links and titles. My use case is to share links to colleagues and friends.
- Clone the repository:
git clone https://github.com/reuteras/raindrop2rss.git
cd raindrop2rss- Install using uv (recommended):
uv syncOr using pip:
pip install -e .- Copy the default configuration file:
cp default-raindrop2rss.cfg raindrop2rss.cfg- Edit
raindrop2rss.cfgwith your settings:
[raindrop]
client_secret=<your Raindrop.io API token>
raindrop_handled_collection=Done
[feed]
web_path=/feeds/
web_root=/var/www/html
filename=it.xml
author_name=Your Name
author_email=your@email.com
contact_url=https://yourwebsite.com
contact_title=Your Feed Title
feed_description=Your feed description
db_path=articles.db
language=en- Go to Raindrop.io App Settings
- Click "Create new app"
- Once created, click on your app to get the test token
- Copy the token to
client_secretin your config file
Install the required CSS, JavaScript, and SVG resources to your web directory:
uv run python raindrop2rss.py --installThis will copy the necessary files to the web_root + web_path location specified in your config.
Run the script to check for new articles in your Raindrop.io unsorted collection and generate the RSS feed:
uv run python raindrop2rss.pyThe script will:
- Connect to Raindrop.io and fetch unsorted bookmarks
- Add new bookmarks to the local SQLite database
- Generate an RSS feed at
web_root/web_path/filename - Optionally move processed bookmarks to the collection specified in
raindrop_handled_collection
-o, --stdout- Output the RSS feed to stdout (useful for testing)-i, --install- Install CSS, JavaScript, and SVG resources-a, --all- Download all raindrops from all collections (not just unsorted)-v, --verbose- Verbose output-h, --help- Show help message
Preview the feed without writing to file:
uv run python raindrop2rss.py --stdoutInitial setup or migration - download ALL raindrops from all collections:
uv run python raindrop2rss.py --allThis is useful when:
- Setting up the feed on a new server
- Rebuilding your feed database from scratch
- Migrating your RSS feed setup
Note: When using --all, items won't be moved to the "done" collection since they're already organized.
Run as a cron job to automatically update the feed:
# Add to crontab to run every hour
0 * * * * cd /path/to/raindrop2rss && uv run python raindrop2rss.pyIf you need to update the SQLite3 database you can use the following command:
uvx litecli articles.dbThe RSS feed includes a JavaScript-based renderer that makes it human-readable when viewed in a browser, while remaining fully compatible with RSS readers. Previously this used XSLT, but browser support for XSLT is being phased out. The new JavaScript approach provides the same functionality with better long-term browser support.
When you view the feed in a browser, the JavaScript transforms the XML into a styled HTML page. RSS readers ignore this and parse the feed normally.
- raindrop.io - the site I use to store links to share
- I use feedgen to create the RSS feed
- I currently use raindrop-io-py to access raindrop.io
- Tips on styling the feed from Darek Kay