Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Cleod9/syncmarx-webext
Web extension to sync bookmarks between browsers to the cloud file host of your choice
https://github.com/Cleod9/syncmarx-webext
box chrome-extension dropbox firefox google-drive javascript webextension
Last synced: 11 days ago
JSON representation
Web extension to sync bookmarks between browsers to the cloud file host of your choice
- Host: GitHub
- URL: https://github.com/Cleod9/syncmarx-webext
- Owner: Cleod9
- License: mit
- Created: 2019-02-08T21:22:19.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-06-13T01:43:11.000Z (5 months ago)
- Last Synced: 2024-08-01T16:44:44.177Z (3 months ago)
- Topics: box, chrome-extension, dropbox, firefox, google-drive, javascript, webextension
- Language: JavaScript
- Homepage: https://syncmarx.com/
- Size: 970 KB
- Stars: 104
- Watchers: 6
- Forks: 13
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# syncmarx
## What it does
A web extension to synchronize bookmarks between browsers. Supports the following features:
* Sync bookmarks as a single backup file to Dropbox, Google Drive, or Box
* Works in Firefox, Google Chrome, Vivaldi, and Brave desktop browsers
* Configurable automatic sync
Note that this extension talks to a companion backend app required for initial handshakes to third-party APIs called [syncmarx-api](https://github.com/Cleod9/syncmarx-api). This backend is hosted for you for free, but it may be possible in the future to configure the extension for self-hosting.
## How to Build
First make sure you have the latest version of [Node.js](https://nodejs.org/en/) installed. Then follow the instructions below from within the project directory.
### Development
```bash
npm install
npm run dev
# Or to auto-rebuild on file changes:
npm run dev-watch
```
### Production
```bash
npm install
npm run prod
# Or to auto-rebuild on file changes:
npm run prod-watch
```
## How to Test
You have two options for testing. The first is to simply build the app, and load the directory as an unpacked extension directly from within your browser.
The other way is to run `npm run dev-web-ext-firefox` (or `prod-web-ext-firefox` depending on target environment). This will load the extension into a temporary instance of Firefox for testing. Note that `dev-web-ext` and `prod-web-ext` scripts exist as well, but they are not fully supported by Firefox at this time due to the lack of service worker support ([see here](https://blog.mozilla.org/addons/2024/03/13/manifest-v3-manifest-v2-march-2024-update/)). The hope is to eventually remove those commands in favor of the service worker approach.
## How to Configure Syncmarx
Follow the on-screen instructions. The app will walk you through the authentication process for a third-party cloud file host (currently Dropbox, Google Drive, or Box). Copy and paste the provided token into the app, and you can start syncing bookmarks.
## Known Issues:
* Currently may not be able to reconcile/sort duplicates within the same folder
* Will not manage browser-specific bookmark functionality due to Web Extension spec limitations (e.g. Seperators, tags, keywords, description, favicons, etc.)
* Will not track Firefox's "Other Bookmarks" folder (a.k.a. "Unorganized" bookmarks)
* Still overall alpha in general so it is recommended to create a backup of your bookmarks before using