Skip to content

mendsec/xbrowsersync-app-community

 
 

Repository files navigation

xBrowserSync - Community Edition (Active Fork)

This is a community-maintained fork of the original xBrowserSync project. The main project has been discontinued, and this version aims to fix compatibility issues and add improvements, ensuring the extension continues to function on modern browsers.


What problem does this project solve?

The original xBrowserSync stopped working correctly in browsers like Google Chrome due to the transition to Manifest V3, which introduced new security policies. This fork resolves that incompatibility by refactoring the code to comply with the new rules.

With this version, you can continue to securely and encrypted sync your Browse history, bookmarks, passwords, and open tabs across different browsers, including Chrome, Firefox, and Edge.


How to use the extension

  1. Download the source code from this repository.
  2. Open your browser (Chrome, Firefox, etc.).
  3. Go to the extensions page (chrome://extensions or about:addons).
  4. Enable "Developer mode".
  5. Click "Load unpacked" and select the source code folder you downloaded.
  6. Follow the instructions to set up the extension with your sync ID and password.

How to contribute

Your help is essential for the success of this project. If you're a developer, here are a few ways you can contribute:

  1. Report bugs: Found an issue? Open a GitHub issue to let us know.
  2. Submit code: If you've implemented an improvement or fixed a bug, fork this repository and submit a Pull Request.
  3. Suggest new features: Share your ideas for improving the extension.

Original README.md Content (Archived)

xBrowserSync

Desktop browser web extensions and Android app

Latest release GitHub license build Coverage Status Crowdin Dependencies Liberapay patrons

GitHub forks GitHub stars

xBrowserSync is a free tool for syncing browser data between different browsers and devices, built for privacy and anonymity. For full details, see www.xbrowsersync.org.

This repository contains the source code for the browser web extensions and Android mobile app used for syncing to an xBrowserSync service. You can get the official releases of the xBrowserSync clients from the various app stores, but if you’d like to build from source you can do so here.

Prerequisites

Installation

CD into the source directory and install the package and dependencies using NPM:

$ npm install

Android

You must follow the Cordova Android installation guide in order to develop xBrowserSync for Android. Once that's done, run the following commands in the xBrowserSync source directory:

$ npm install -g [email protected]
$ cd ./res/android
$ cordova prepare

Building

Run a debug build for the given platform:

$ npm run build:[platform]

or

$ npm run watch:[platform]

Replace [platform] with the name of the platform to build. The app code will be output to the 'build/[platform]' folder. Available platforms:

  • android
  • chromium
  • firefox

Debugging in Chrome

Once you have built xBrowserSync for Chromium, browse to chrome://extensions, enable Developer mode, click "Load unpacked" and browse to build/chromium within the xBrowserSync source directory.

Note: We recommend creating a new Chrome profile for testing so you do not affect your actual profile data.

Debugging in Firefox

Use the web-ext tool for testing xBrowserSync in Firefox. Once that is installed and you have built xBrowserSync for Firefox, CD into build/firefox within the xBrowserSync source directory and run the following command:

$ web-ext run --verbose

Firefox will open using a temporary profile and the xBrowserSync extension will be installed from the built source.

Debugging in Android

After building, in order to run the app you'll need to execute the relevant cordova cli commands. For example, to run the app on a connected device, CD into build/android within the xBrowserSync source directory and run the following commands:

$ cordova build android
$ cordova run android --device

Make sure to run the cordova build command at least once after running a fresh build so that required gradle files are copied (cordova run alone does not copy these files).

Packaging

Run a release build and then package for the given platform:

$ npm run package:[platform]

Replace [platform] with the name of the platform to build. The package will be output to the 'dist' folder.

Issues

If you’ve found a bug or wish to request a new feature, please submit it here.

Translation

If you would like to help with translating xBrowserSync into another language, please read the Translations wiki page to get started.

About

xBrowserSync browser extensions / mobile app

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 78.2%
  • HTML 11.6%
  • SCSS 8.2%
  • JavaScript 2.0%