Skip to content

Repository files navigation

This browser extension provides a simple, private and secure bookmark up-and-down-load between chrome browsers.

Features

If you click on the extension icon, the extension offers three functions:

  • Download: Downloads all bookmarks as stored in the bookmark file on the server and merges them with the current bookmarks on the browser.
  • Upload: Uploads all bookmarks from the browser to the server.
  • List: Lists all bookmark files present on the server.
  • Clear Bookmarks: Clears all bookmarks from the browser.

Server Requirements

The extension stores the bookmark files on an S3 bucket of AWS. The user thus has to set up an S3 instance on AWS and provide the necessary access data in the option sheet of the extension. We recommend to use a separate IAM user with restricted rights on S3. The data to be entered there are as follows:

  • AWS Access Key ID
  • AWS Secret Access Key
  • AWS Default Region
  • AWS Bucket Name (such as: testing.demo.com)

The extension assumes familiarity with this process and we do not document this further.

In the option sheet you also should enter an AES Password. This is the password which is used for the end-to-end encryption of the bookmark file. The encryption is under control of the client.

The S3 bucket is assumed to be versioning. Earlier uploads are kept and all previous uploaded configurations can be restored. Downloads alway pick the most recent version.

Installation from Source

  • Clone this repository into a directory.
  • Run npm install
  • Run npm run build
  • Switch chrome browser into development mode.
  • Load unpacked extension and pick this directory.
  • Pin in the extension manager so we can access the upload / download functionality.
  • Set options in the option page.
  • To have the required data ready on other machines we recommend to store the data in password managers.

Generating a CRX package

Installation from CRX Package

Work to be done.

Installation from Chrome Store

Subscribing to the principle of open source, data sovereignty and privacy, we do not distribute this extension in the Chrome store.

Security

  • All data in the configuration is stored as part of chrome local storage.
  • No private data is used.
  • The extension claims a bit more premissions than necessary since it also is boilerplate for some other features I want to include later.

Workflow

  • Change local bookmarks.
  • Notice the badge, notification and icon change, which reminds of the necessity to upload the bookmarks.
  • Warning: Downloading several times leads to duplicated bookmarks. This is by design. No merging is done.
  • Warning: Forgetting to upload leads to lost updates. Pretty clear. By design.

Roadmap

The extension is a quick and dirty hack which I produced when xbrowsersync went out of service. it does exactly what I need it to do and I offer it here without any warranty, guarantees of whatever.

Issues and Bugs

  • Currently we cannot chose the filename on the S3 bucket, so strictly speaking it is not multi-user.
  • Issues are welcome on github.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages