🛡️ 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.js and 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-properties fix into the backup. This ensures that Sine Mod icons and other SVG themes work immediately upon restore-no about:config tweaking required.
• 📦 Complete Data: Backs up History, Bookmarks, Passwords (key4.db + logins.json), Cookies, Extensions, and Sessions.

🚀 Installation & Usage

🐧 Linux

1. Clone this repository or download the script:

   git clone https://github.com/Ronin-CK/Zen-Backup-Tool.git
   cd Zen-Backup-Tool
   

2. Make the script executable:

   chmod +x zen-backup.sh 
   

3. Run 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

1. Make the script executable:

   chmod +x zen-backup-mac.sh
   

2. 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:

1. Press the Windows Key, type PowerShell, and press Enter
2. Copy and paste the following command, then press Enter:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. Type Y and hit Enter.

4. 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.