NAME
Zen-Backup-Tool — A Simple Backup Tool for FireFox Forks / Zen Browser
SYNOPSIS
INFO
DESCRIPTION
A Simple Backup Tool for FireFox Forks / Zen Browser
README
🛡️ Zen Browser Backup Tool
A smart, "sanitized" backup utility for Zen Browser on Linux.
It solves the common issues of crashing profiles and missing icons when migrating between computers.
✨ Features
- 🧠 Intelligent Detection: Automatically detects if you are using Sine Mod, standard CSS themes, or a Vanilla profile and backs up the correct visual files.
- 🧪 Settings Sanitization: Scans your
prefs.jsand removes absolute file paths (like/home/user/) to prevent crashes when restoring to a new computer or username. - 🔧 Auto-Fixes Icons: Automatically injects the
svg.context-propertiesfix into the backup. This ensures that Sine Mod icons and other SVG themes work immediately upon restore-noabout:configtweaking required. - 📦 Complete Data: Backs up History, Bookmarks, Passwords (
key4.db+logins.json), Cookies, Extensions, and Sessions.
🚀 Installation & Usage
🐧 Linux
Clone this repository or download the script:
git clone https://github.com/Ronin-CK/Zen-Backup-Tool.git cd Zen-Backup-ToolMake the script executable:
chmod +x zen-backup.shRun the tool:
./zen-backup.sh
Select the profile you want to backup. The backup will be saved as a compressed .tar.gz file in: ~/Backups/ZenBrowser/
🍎 macOS
- Make the script executable:
chmod +x zen-backup-mac.sh - Run the tool:
./zen-backup-mac.sh
🪟 Windows
1. Download
Clone the repository or download the ZIP file and extract it.
2. Open PowerShell as Administrator
Press the Windows Key, type PowerShell, right-click it, and select Run as Administrator.
3. Enable Script Execution (First Time Only)
By default, Windows blocks PowerShell scripts for security reasons. To allow this script to run:
- Press the Windows Key, type PowerShell, and press Enter
- Copy and paste the following command, then press Enter:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Type Y and hit Enter.
Now right-clicking your zen-backup-win.ps1 and Run with PowerShell
❓ Troubleshooting
Q: My "Compact Mode" or settings aren't saving after restore?
Solution: Go to your restored profile folder and look for a file named
user.js. Delete it.Why? This file is used to safely import settings, but sometimes it "locks" your preferences. Deleting it allows you to change settings again.
Make sure you launch Zen with the restored profile at least once before deleting
user.js. This allows the browser to read and save your imported settings permanently.