🌟 Zen Browser Portable

🚀 A fully portable setup for Zen Browser that runs directly from a USB drive or any folder

Launch Zen Browser anywhere without installation - all your data travels with you!

---

✨ Features

🔹 Fully Portable - Run from USB drives, external storage, or any folder
🔹 Cross-Platform - Works seamlessly on Windows, Linux, and macOS
🔹 Auto-Updated - Automated CI/CD builds latest Zen Browser releases daily
🔹 Multi-Architecture - Supports x86_64, ARM64, and Universal builds
🔹 Self-Contained - All user data stored in local Data directory
🔹 Zero Installation - No system modifications required
🔹 Privacy-Focused - Complete control over your browsing data
🔹 Easy to Use - Simple one-click launcher scripts

📁 Folder Structure

zen-portable/
├── 📁 app/                         # Core application files
│   ├── 🐧 lin/                     # Linux executable files
│   ├── 🪟 win/                     # Windows executable files
│   └── 🍎 mac/                     # macOS executable files
├── 💾 data/
│   └── 👤 profile/                 # Browser profile & user data
└── 🚀 launcher/
    ├── 🪟 zenwindowsportable.bat   # Windows launcher script
    ├── 🐧 zenlinuxportable.sh      # Linux launcher script
    └── 🍎 zenmacosportable.sh      # macOS launcher script

🚀 Quick Start Guide

📥 Option 1: Download Pre-built Release

🔄 Automated Builds: Our CI/CD pipeline automatically checks for new Zen Browser releases daily at midnight UTC and builds portable versions for all platforms!

1. Download the latest Zen Browser Portable release

   • 🐧 zen-linux-x86_64-portable.zip - Linux x86_64 (64-bit)
   • 🐧 zen-linux-aarch64-portable.zip - Linux ARM64
   • 🪟 zen-windows-x86_64-portable.zip - Windows x86_64 (64-bit)
   • 🪟 zen-windows-arm64-portable.zip - Windows ARM64
   • 🍎 zen-macos-universal-portable.zip - macOS Universal (Intel & Apple Silicon)
   • 📦 zen-portable.zip - All platforms in one package

2. Extract the ZIP file to your desired location (USB drive, folder, etc.)

3. Navigate to the extracted folder

4. Launch the browser:

   • Windows: Double-click launcher/zenwindowsportable.bat
   • Linux: Double-click launcher/zenlinuxportable.sh or run via terminal
   • macOS: Double-click launcher/zenmacosportable.sh or run via terminal

💡 Tip: Your portable browser is now ready to use! All data will be saved in the data/ folder.

⚡ Update Schedule: New releases are automatically built daily when Zen Browser updates are detected. You can also trigger manual builds anytime!

---

🔨 Option 2: Build from Source

💡 Cross-Platform Support: Build scripts are available for both Linux/macOS (Bash) and Windows (PowerShell).

Automatic Build (All Platforms)

For Linux/macOS:

1. Download the automatic build script:

   wget https://raw.githubusercontent.com/ramhaidar/Zen-Browser-Portable/main/zenmake_all_platforms.sh

2. Make executable:

   chmod +x zenmake_all_platforms.sh

3. Run the build script:

   ./zenmake_all_platforms.sh

For Windows:

1. Download the PowerShell build script:

   Invoke-WebRequest -Uri "https://raw.githubusercontent.com/ramhaidar/Zen-Browser-Portable/main/zenmake_all_platforms.ps1" -OutFile "zenmake_all_platforms.ps1"

2. Run the build script:

   .\zenmake_all_platforms.ps1

This will automatically build portable versions for all platforms (Linux, Windows, and macOS).

Interactive Build (Choose Platforms)

For Linux/macOS:

1. Download the interactive build script:

   wget https://raw.githubusercontent.com/ramhaidar/Zen-Browser-Portable/main/zenmake_with_choice.sh

2. Make executable:

   chmod +x zenmake_with_choice.sh

3. Run the interactive build script:

   ./zenmake_with_choice.sh

For Windows:

1. Download the PowerShell interactive build script:

   Invoke-WebRequest -Uri "https://raw.githubusercontent.com/ramhaidar/Zen-Browser-Portable/main/zenmake_with_choice.ps1" -OutFile "zenmake_with_choice.ps1"

2. Run the interactive build script:

   .\zenmake_with_choice.ps1

This will allow you to choose which platform(s) you want to build - you can select specific platforms or build all of them.

4. Deploy: The script(s) will create ZIP files for the selected platform(s). Extract the appropriate one to your portable storage device.

5. Launch: Use the appropriate launcher script for your platform.

Clean Build Artifacts

After building, you can clean up temporary build files and artifacts:

For Linux/macOS:

./clean_build_artifacts.sh

For Windows:

.\clean_build_artifacts.ps1

This will remove all generated ZIP files, extracted directories, and temporary build artifacts.

💡 Usage Tips

• ✅ Safe Exit: Always close the browser completely before unmounting your storage device
• ⚙️ Customization: Modify the launcher scripts to adjust paths or add custom options
• 💾 Data Persistence: All your bookmarks, history, and settings are automatically saved to the data/ folder
• 🔄 Auto-Updates: New releases are automatically built and published when Zen Browser updates - just download the latest release!
• 🎯 Platform Selection: Download only the package you need, or get the universal package for all platforms
• 🧹 Cleanup: Use the provided cleanup scripts (clean_build_artifacts.sh or clean_build_artifacts.ps1) to remove build artifacts after creating your portable packages
• 🖥️ Cross-Platform Building: Choose between Bash scripts (Linux/macOS) or PowerShell scripts (Windows) for building portable packages
• ⚡ Stay Current: Check the releases page regularly for the latest Zen Browser updates in portable format

---

❓ FAQ

How are releases automatically updated?

Our GitHub Actions workflow runs daily at midnight UTC to check for new Zen Browser releases. When a new version is detected, it automatically:

• 🔍 Detects the latest Zen Browser release
• 🏗️ Builds portable versions for all supported platforms
• 📦 Creates platform-specific ZIP packages
• 🚀 Publishes a new release with all portable versions
• ✅ Ensures you get the latest Zen Browser in portable format (within 24 hours of upstream release)

You can also trigger manual builds immediately using the "Run workflow" button in the Actions tab.

What platforms are automatically built?

Our automated build system creates portable packages for:

• 🐧 Linux: x86_64 and ARM64 (aarch64) architectures
• 🪟 Windows: x86_64 and ARM64 architectures
• 🍎 macOS: Universal binaries (Intel and Apple Silicon)
• 📦 Universal: All platforms combined in one package

Each release includes individual platform packages plus a universal package containing all platforms.

Does this work on macOS?

Yes! This portable setup now supports Windows, Linux, and macOS. Use the appropriate launcher script for your platform.

What's the difference between the build scripts?

We provide two types of build scripts:

• zenmake_all_platforms: Automatically builds portable versions for all platforms (Linux, Windows, and macOS)
• zenmake_with_choice: Interactive script that lets you choose which specific platform(s) to build

Both are available in Bash (.sh) for Linux/macOS and PowerShell (.ps1) for Windows.

Can I use this with existing Zen Browser profiles?

Yes! You can copy your existing profile data to the `data/profile/` folder to migrate your settings.

Is this an official Zen Browser project?

No, this is a community-created portable wrapper for Zen Browser. For official Zen Browser releases, visit the official Zen Browser repository at https://github.com/zen-browser/desktop.

---

🤝 Contributing

We welcome contributions! Please feel free to:

• 🐛 Report bugs
• 💡 Suggest features
• 🔧 Submit pull requests
• 📖 Improve documentation
• ⚙️ Enhance the CI/CD automation workflow

🔄 Note: Our automated build system ensures releases stay current with Zen Browser updates. If you notice any issues with the automation, please report them!

---

🙏 Acknowledgments

• 🔗 Original Repository: This project is forked from wysh3/Zen-Browser-Portable - Thanks for the excellent foundation!
• Thanks to the Zen Browser team for creating an amazing browser
• Special thanks to all contributors who help improve this portable setup

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ for the Zen Browser community

If you find this project helpful, please consider giving it a ⭐!