Automatically sync your X/Twitter, YouTube, Instagram, and LinkedIn saves to Raindrop.io in real-time
- 🐦 X (Twitter): Automatically saves any tweet bookmarked on x.com to your
Twitter Bookmarkscollection. - 🎥 YouTube: Automatically saves videos you Like or save to Watch Later / Playlists to your
YouTube Liked & Savedcollection. - 📸 Instagram: Automatically saves posts and reels when clicking the bookmark Save ribbon to your
Instagram Savedcollection. - 💼 LinkedIn: Automatically saves posts when choosing Save from the post action menu to your
LinkedIn Savedcollection.
✨ Real-time Sync - Automatically syncs bookmarks as you save them across X, YouTube, Instagram & LinkedIn
📁 Multi-Collection Routing - Automatically creates and routes each platform to its own dedicated Raindrop collection
🍪 Sweet Cookie Storage - Captures, normalizes, and stores session cookies formatted with @steipete/sweet-cookie schema for external tools/automation
📦 Bulk Sync (X/Twitter) - Import all existing bookmarks at once
🔄 Queue System - Reliable sync with automatic retry on failures and exponential backoff
⚡ Rate Limiting - Smart delays to respect Raindrop API limits
🎨 Clean UI - In-page confirmation toasts, popup status monitor, and options interface
🔒 Privacy First - Your data stays entirely between your browser and your Raindrop.io account
-
Clone the repository
git clone https://github.com/weppami/rainsync.git cd rainsync -
Install dependencies
npm install
-
Build the extension
npm run build
-
Load in Chrome
- Open Chrome and go to
chrome://extensions - Enable "Developer mode" (toggle in top-right)
- Click "Load unpacked"
- Select the
distfolder from the project
- Open Chrome and go to
Status: Ready for submission
The extension is ready for Chrome Web Store publication. See CHROME_STORE_SUBMISSION.md for submission details.
Once published, install directly from the Chrome Web Store: [Link will be added after publication]
- Go to Raindrop.io Settings → Integrations
- Click "Create new app"
- Create a test token
- Copy the token (you'll need it in the next step)
- Click the RainSync extension icon in Chrome
- Click "Settings"
- Paste your Raindrop.io test token
- The extension will validate your token automatically
- Click "Save Settings"
That's it! RainSync is now active and will sync your Twitter bookmarks automatically.
Simply bookmark tweets on Twitter/X as you normally would. RainSync will:
- Detect the bookmark action
- Extract tweet metadata
- Add it to the sync queue
- Upload to your "Twitter Bookmarks" collection in Raindrop.io
To import all your existing bookmarks:
- Open RainSync Settings
- Scroll to the "Bulk Sync" section
- Click "Start Bulk Sync"
- A new tab will open to
twitter.com/i/bookmarks - The extension will automatically scroll and extract all bookmarks
- Wait for the completion notification
⏱️ Important: Sync Timing
- Bulk sync queues bookmarks quickly (30-60 seconds for scrolling)
- Bookmarks are synced gradually with rate limiting delays
- 500ms delay between each sync to respect API limits
- Large collections take time: 100 bookmarks ≈ 1-2 minutes, 500 bookmarks ≈ 5-10 minutes
- Check the popup to monitor queue progress
- Bookmarks appear in Raindrop.io as they're synced, not all at once
- You can close the tab - syncing continues in the background
Click the RainSync extension icon to see:
- Current sync status (Active/Syncing/Error/Disabled)
- Total bookmarks synced
- Last sync time
- Queue length (if any pending)
RainSync integrates with @steipete/sweet-cookie to capture, normalize, and store session cookies for X, YouTube, Instagram, and LinkedIn.
In the Extension:
- Open RainSync Options / Settings
- Scroll to the Sweet Cookie Session Storage section
- Click Capture Cookies Now to grab active cookies directly from Chrome's cookie store
- View cookie counts, Copy JSON to clipboard, or Download JSON
Via CLI Script: You can also extract cookies from your local browser database directly using the sweet-cookie CLI tool:
npm run cookiesThis reads your local browser sessions, filters partitioned cookies according to the sweet-cookie specification, and saves them to cookies-export.json (git-ignored).
┌─────────────┐ ┌──────────────┐ ┌─────────────┐
│ Twitter │─────▶│ RainSync │─────▶│ Raindrop.io │
│ (Bookmark) │ │ (Extension) │ │ (Archive) │
└─────────────┘ └──────────────┘ └─────────────┘
│
▼
┌──────────────┐
│ Sync Queue │
│ • Retry │
│ • Persist │
│ • Rate Limit │
└──────────────┘
- Content Script - Detects bookmark actions using MutationObserver
- Background Service Worker - Manages queue and API communication
- Raindrop API Client - Handles authentication and bookmark creation
- Sync Manager - Queue processing with exponential backoff retry
- Collection Manager - Finds or creates "Twitter Bookmarks" collection
Removing a bookmark on X does not delete it from Raindrop.io; RainSync only adds.
Each synced bookmark includes:
- Title: First 100 characters of the tweet
- URL: Direct link to the tweet
- Tags: Simple tags (
twitter,tweet-deletedif unavailable,retweetif applicable) - Description:
- Full tweet text
- Quoted tweet (if applicable)
- Author info
- Bookmark timestamp
- Retweet indicator (if applicable)
- Deletion warning (if tweet was unavailable)
Title: [DELETED] This is an example tweet that was deleted
URL: https://x.com/username/status/1234567890
Tags: twitter, tweet-deleted
Description:
This is an example tweet that was deleted
Quoted tweet from @another:
This is the quoted content
Author: Example User (@username)
Bookmarked: 2026-01-04T12:00:00.000Z
⚠️ Note: This tweet was unavailable or deleted at the time of archiving.
The content preserved here may be incomplete or represent a placeholder.
rainsync/
├── src/
│ ├── background/ # Service worker
│ │ ├── index.ts # Main service worker
│ │ ├── raindrop-api.ts # API client
│ │ ├── sync-manager.ts # Queue & sync logic
│ │ ├── retry-handler.ts # Exponential backoff
│ │ └── collection-manager.ts
│ ├── content/ # Content scripts
│ │ ├── twitter.ts # Main content script
│ │ ├── bookmark-detector.ts
│ │ ├── tweet-extractor.ts
│ │ └── dom-selectors.ts
│ ├── popup/ # Extension popup
│ │ ├── Popup.tsx
│ │ └── styles.css
│ ├── options/ # Settings page
│ │ ├── Options.tsx
│ │ └── styles.css
│ └── shared/ # Shared utilities
│ ├── types/ # TypeScript types
│ ├── utils/ # Utilities
│ └── constants/ # Constants
├── tests/ # Test files
├── public/icons/ # Extension icons
├── store/ # Chrome Web Store screenshots and promo tile
├── docs/privacy.md # Privacy policy (GitHub Pages)
├── manifest.json # Extension manifest
└── dist/ # Build output
# Development build with watch mode
npm run dev
# Production build
npm run build
# Chrome Web Store package (rainsync-v<version>.zip)
npm run build:release
# Run tests
npm test
# Type checking
npm run type-check
# Linting
npm run lint
# Format code
npm run format- TypeScript 5.9 - Type-safe development
- React 18 - UI components
- Vite 8 + @crxjs/vite-plugin - Build tooling
- Vitest 5 - Testing framework
- Chrome Manifest V3 - Latest extension standard
- Raindrop.io API - Bookmark storage
RainSync includes comprehensive error handling:
- Network Errors: Detects connection issues and retries automatically
- Rate Limits: Respects API rate limits with smart delays
- Authentication Errors: Clear messages if token is invalid
- Duplicate Detection: Skips bookmarks that already exist
- Retry Logic: Exponential backoff (1s, 2s, 4s, 8s, 16s) up to 5 attempts
- User-Friendly Messages: Technical errors are translated to readable messages
- No tracking - RainSync doesn't collect any analytics or usage data
- Local storage - Settings and queue stored locally in your browser
- Direct sync - Data flows directly from Twitter to Raindrop.io
- Token security - Your Raindrop token is stored securely in Chrome's encrypted storage
- Open source - Full transparency of what the code does
- Check that sync is enabled in Settings
- Verify your Raindrop.io token is valid
- Look for error messages in the popup
- Check browser console for detailed logs
This happens when the extension is reloaded while Twitter is open:
- A blue notification will appear in the top-right
- Simply refresh the Twitter tab
- Syncing will resume normally
If you just ran bulk sync:
- Be patient! Bookmarks sync gradually, not all at once
- Click the RainSync popup to check queue status
- Wait for "Queue: 0" - this means all bookmarks are synced
- Refresh Raindrop.io to see newly synced bookmarks
If sync is stuck:
- Check the "Twitter Bookmarks" collection in Raindrop.io
- Verify sync status in the popup
- Look for error messages
- Check the queue length - if it's not decreasing, there may be an error
If you see "Rate limit reached" errors:
- This is normal for bulk operations
- The extension will automatically retry
- Wait a minute and syncing will resume
✅ Phase 1: Foundation - Complete ✅ Phase 2: Raindrop.io Integration - Complete ✅ Phase 3: Twitter Bookmark Detection - Complete ✅ Phase 4: Sync Manager & Service Worker - Complete ✅ Phase 5: User Interface Enhancement - Complete ✅ Phase 6: Bulk Sync & Edge Cases - Complete ✅ Phase 7: Testing & Documentation - Complete 🚀 Phase 8: Chrome Web Store Release - Ready for Submission
- Privacy policy created
- Store listing content prepared
- Comprehensive tests (67 tests, all passing)
- Production build script
- Manifest updated for production
- Documentation complete
- Extension icons created
- Screenshots captured (
store/screenshots/) - Privacy policy hosted (weppami.github.io/rainsync/privacy)
- Chrome Web Store submission
See CHROME_STORE_SUBMISSION.md for complete submission guide.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Chrome Web Store release
- Support for Twitter threads (save entire thread)
- Custom collection selection
- Export data to JSON
- Support for Edge and Brave browsers
- Background auto-sync for all bookmarks
- Selective sync (filter by author, keywords)
- Two-way sync (Raindrop → Twitter)
MIT License - see LICENSE file for details
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Built with Anthropic Claude
- Powered by Raindrop.io API
- Uses @crxjs/vite-plugin
Made with ❤️ by the RainSync team