🧘♀️ 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.comor just run
python zensync.py configurethen 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 pathsupload- Backup profiles to S3download- Restore profiles from S3sync- Bidirectional synchronizationlist-profiles- Show available local profilesprofile-info- Display profile system information
Configuration
Settings are stored in zen_sync_config.json.