Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lasuillard/raindrop-sync-chrome
Chrome browser extension for syncing bookmarks with Raindrop.
https://github.com/lasuillard/raindrop-sync-chrome
chrome-extension raindrop-io sveltejs tailwindcss typescript
Last synced: 3 months ago
JSON representation
Chrome browser extension for syncing bookmarks with Raindrop.
- Host: GitHub
- URL: https://github.com/lasuillard/raindrop-sync-chrome
- Owner: lasuillard
- License: gpl-3.0
- Created: 2023-10-08T06:09:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-27T14:57:54.000Z (3 months ago)
- Last Synced: 2024-09-29T11:54:06.110Z (3 months ago)
- Topics: chrome-extension, raindrop-io, sveltejs, tailwindcss, typescript
- Language: TypeScript
- Homepage:
- Size: 1.32 MB
- Stars: 15
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Raindrop Sync for Chrome
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![CI](https://github.com/lasuillard/raindrop-sync-chrome/actions/workflows/ci.yaml/badge.svg)](https://github.com/lasuillard/raindrop-sync-chrome/actions/workflows/ci.yaml)
[![codecov](https://codecov.io/gh/lasuillard/raindrop-sync-chrome/graph/badge.svg?token=52rvoFBAEb)](https://codecov.io/gh/lasuillard/raindrop-sync-chrome)
![GitHub Release](https://img.shields.io/github/v/release/lasuillard/raindrop-sync-chrome)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](https://github.com/lasuillard/raindrop-sync-chrome/releases).
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](/docs/images/chrome-manage-extensions.png)
5. **Load the Unpacked Extension**
Click the **Load Unpacked** button and select the directory where you unzipped the extension.
![Chrome Load Unpacked Extension](/docs/images/chrome-load-unpacked-extension.png)
6. **Verify Installation**
You should now see the extension listed among your installed extensions.
![Chrome Extension Installed](/docs/images/chrome-extension-installed.png)
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](/docs/images/raindrop-app-installation.png)
> **Note:** The extension identifier in the URL (`https://.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](/docs/images/rsfc-register-app.png)
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.