🧘‍♀️ Zen-Sync

A (vibe-coded) Windows only command-line tool for syncing Zen Browser data with S3-compatible storage services.

What it does

Since Zen Browser doesn't have proper profile sync yet, this is my quick solution built in a few hours to keep my stuffs in sync across multiple machines.

It backs up all the important stuff to any S3-compatible cloud storage so you can restore or "sync" your profile anywhere. No more manually dragging around profile folders every time you edit a settings 🥹🥹😭. I'm so done with that.

The default (customizable) setting skips session cookies, temporary storage, and other data because sites I visit can detect copied sessions through fingerprinting and will invalidate them.

Features

Bidirectional sync between local and S3 storage
Filtering - only syncs important files, excludes cache and temporary data
"Incremental" sync - only uploads/downloads changed files
Custom S3 endpoints - works with any S3-compatible service

📋 What gets synced by default

Included:

Profile configuration (profiles.ini, installs.ini, compatibility.ini)
Profile Groups databases (Profile Groups/*.sqlite)
Bookmarks (places.sqlite, bookmarks.html)
Saved passwords and certificates (key4.db, cert9.db, logins.json)
Extensions and their settings (extensions.json, extension-*.json)
Custom themes and CSS (zen-*.json, zen-*.css, userChrome.css, userContent.css)
Browser preferences (prefs.js, user.js)
Search engine settings (search.json.mozlz4)
Favicons (favicons.sqlite)
Chrome folder customizations (chrome/**/*)
and other files from customizable ruleset

Excluded:

Cache files (cache2/*, thumbnails/*, shader-cache/*)
Logs and crash reports (logs/*, crashes/*, minidumps/*)
Lock files (*.lock, *.lck, parent.lock)
Temporary storage (storage/temporary/*, storage/*/ls/*)
Session data (sessionstore.jsonlz4, sessionCheckpoints.json)
Session cookies (cookies.sqlite*)
Temporary browsing data (webappsstore.sqlite*, safebrowsing/*)

Use --help with any command for detailed options.

Quick Start

Configure your S3 settings:
```
python zensync.py configure --bucket your-bucket-name --endpoint-url https://your-s3-endpoint.com
```
or just run python zensync.py configure then edit the configuration json manually.
Upload your profiles:
```
python zensync.py upload
```
Download profiles on another machine:
```
python zensync.py download
```
Two-way sync:
```
python zensync.py sync
```

🎮 Main Commands

configure - Set up S3 credentials and paths
upload - Backup profiles to S3
download - Restore profiles from S3
sync - Bidirectional synchronization
list-profiles - Show available local profiles
profile-info - Display profile system information

Configuration

Settings are stored in zen_sync_config.json.

3.0 KiB Raw Blame History