lasuillard / raindrop-sync-chrome

Chrome browser extension for syncing bookmarks with Raindrop.
GNU General Public License v3.0
20 stars 1 forks source link
chrome-extension raindrop-io sveltejs tailwindcss typescript

Raindrop Sync for Chrome

License: GPL v3 CI codecov GitHub Release

Chrome browser extension for syncing bookmarks with Raindrop.

šŸš€ Getting Started

ā— Caution: This project is currently under development. Many features may be incomplete or buggy.

šŸ“¦ Installing the Extension Locally

The extension is not yet published to the Chrome Web Store. Follow the steps below to install it locally. Once the core features are implemented and stabilized, we will publish the extension to the Chrome Web Store.

  1. Download the Extension Archive

    Download the .zip file from the releases page.

  2. Unzip the Archive

    Extract the contents of the downloaded archive to your desired location, then open the Chrome browser.

  3. Access Chrome Extensions

    Navigate to chrome://extensions in your Chrome browser.

  4. Enable Developer Mode

    Toggle Developer Mode on at the top-right corner of the page.

    Chrome Manage Extensions Page

  5. Load the Unpacked Extension

    Click the Load Unpacked button and select the directory where you unzipped the extension.

    Chrome Load Unpacked Extension

  6. Verify Installation

    You should now see the extension listed among your installed extensions.

    Chrome Extension Installed

  7. Start Using the Extension

    The extension is now available for use.

ā€¼ļø Warning: This project is in the early stages of development. Many features are incomplete or buggy, and there is a risk of breaking your bookmarks due to poor implementation. We strongly recommend backing up your bookmarks before using this extension.

šŸ‘Ÿ Initializing the Application

  1. Visit the Options Page

    Open the extension's options page.

  2. Access the Settings Tab

    Navigate to the Settings tab.

  3. Create an Integration in Raindrop.io

    Go to Raindrop.io and create an integration for this extension.

    Raindrop App Installation

    Note: The extension identifier in the URL (https://<EXTENSION_ID>.chromiumapp.org/) may differ based on the location of the unpacked extension. Please replace it accordingly.

    Now, there are two methods for initializing the application:

    RSFC Register App

    1. Using a Test Token (Recommended)

      The simplest and recommended way is to use a test token that never expires. Click on Create test token in the app settings in Raindrop, then copy and paste it (no need to click Register) into the extension settings' Access Token field.

    2. Registering as an OAuth App

      Alternatively, you can register the extension as an OAuth app using a client ID and client secret. Copy and paste each value into the settings and click Register to authorize the application.