Skip to content

Metee01/Zen-Browser-Portable

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ‡¬πŸ‡§ English Β· πŸ‡ΉπŸ‡· TΓΌrkΓ§e

Zen Browser Portable

Zen Browser β€” Windows Portable

Carry your browser, your profiles, and your privacy β€” anywhere.

Zen Browser Stars License Platform


πŸ“– About

This project is a portable repackaging of Zen Browser for Windows. It allows you to run Zen Browser directly from a USB drive, an external hard drive, or any folder on your computer β€” without installation and without leaving traces on the host system.

Note

Zen Browser is an open-source, Firefox-based browser focused on productivity and a calmer internet experience. This portable build does not modify the original browser in any way; it simply wraps the official binaries with a portable launcher that redirects the profile directory.

✨ Key Features

Feature Description
πŸ”’ Zero Installation No admin rights needed. No registry entries. No leftover files.
πŸ’Ύ Fully Self-Contained Browser binaries, profiles, bookmarks, extensions β€” everything lives inside one folder.
πŸ‘€ Multi-Profile Support 5 pre-configured profile slots out of the box. Switch between work, personal, and other contexts effortlessly.
πŸ”„ Sync-Friendly Move the entire folder to another machine, plug in, and continue exactly where you left off.
πŸ›‘οΈ Privacy by Default Runs with -no-remote flag, ensuring complete isolation from any locally installed Firefox/Zen instance.

πŸš€ Quick Start

Prerequisites

  • Operating System: Windows 10 / 11 (x64)
  • Disk Space: ~500 MB

Setup

  1. Download the latest release from the πŸ“¦ Releases page and extract the ZIP to any location β€” your desktop, a USB drive, an external hard drive, anywhere you like.

  2. Download Zen Browser from the official download page:

    • Download the Windows (x64) installer or archive.
    • Extract the browser files and place them inside the app/win/ directory so that app/win/zen.exe exists.

    [!TIP] You can also copy the contents of an existing Zen Browser installation from C:\Program Files\Zen Browser\ directly into app/win/.

  3. Double-click PortableZen.exe and start browsing!

That's it β€” your portable Zen Browser is ready to use. πŸŽ‰

Tip

You can also run zenbrowser.bat directly if you prefer launching from the command line.


πŸ” Security & False Positives

Some antivirus engines may flag PortableZen.exe as suspicious. This is a false positive. Here's why:

PortableZen.exe is a minimal C# wrapper compiled with the built-in Windows .NET compiler (csc.exe). It simply locates zen.exe in the app/win/ directory and launches it with the correct profile path β€” no external dependencies, no obfuscation, no hidden behavior.

src\launcher.cs  β†’  csc.exe /target:winexe  β†’  PortableZen.exe

This pattern β€” hiding a console window and executing commands β€” is sometimes flagged by heuristic-based antivirus engines, but the file does not contain any malicious code.

Tip

If you don't trust the .exe file, you can simply run zenbrowser.bat directly β€” it does the exact same thing. The .exe is provided purely for convenience (allows you to see Zen Browser in a UI through programs like PortableApps.com).


πŸ“ Directory Structure

Zen-Browser-Portable/
β”‚
β”œβ”€β”€ app/
β”‚   └── win/                    # Zen Browser binaries (not tracked by Git)
β”‚       β”œβ”€β”€ zen.exe             # Main browser executable
β”‚       └── ...                 # All other browser files
β”‚
β”œβ”€β”€ data/
β”‚   β”œβ”€β”€ profile.ini             # Profile manager configuration
β”‚   β”œβ”€β”€ profile1/               # Default profile (active)
β”‚   β”œβ”€β”€ profile2/               # Additional profile slot
β”‚   β”œβ”€β”€ profile3/               # Additional profile slot
β”‚   β”œβ”€β”€ profile4/               # Additional profile slot
β”‚   └── profile5/               # Additional profile slot
β”‚
β”œβ”€β”€ src/
β”‚   └── launcher.cs             # C# wrapper source (compiled to PortableZen.exe in CI)
β”‚
β”œβ”€β”€ PortableZen.exe             # Portable launcher (built in CI, not tracked by Git)
β”œβ”€β”€ zenbrowser.bat              # Launcher batch script (source)

Important

You need to supply the Zen Browser binaries yourself by following the Setup instructions. This ensures you always use the latest version directly from the official source.


βš™οΈ How It Works

The portable launcher is powered by a simple C# wrapper that starts Zen Browser with a portable profile:

string dir = Path.GetDirectoryName(
    System.Reflection.Assembly.GetExecutingAssembly().Location);
string zenExe = Path.Combine(dir, "app", "win", "zen.exe");
string profile = Path.Combine(dir, "data", "profile1");
Process.Start(new ProcessStartInfo {
    FileName = zenExe,
    Arguments = "-profile \"" + profile + "\" -no-remote",
    UseShellExecute = false,
    CreateNoWindow = true
});

What each part does:

Component Purpose
GetExecutingAssembly() Resolves to the directory where the launcher lives, making all paths relative and truly portable.
-profile Tells Zen/Firefox to use the specified directory for all profile data instead of the default %APPDATA% location.
-no-remote Prevents the portable instance from connecting to any already-running Firefox or Zen Browser session on the host machine.
CreateNoWindow = true Hides the console window for a cleaner experience.

The PortableZen.exe is compiled from src/launcher.cs during CI using the built-in Windows C# compiler (csc.exe), providing a clean double-click experience with the custom Zen icon. Alternatively, you can run zenbrowser.bat directly β€” it achieves the same result.


πŸ‘€ Multi-Profile Management

This portable build comes with 5 pre-configured profile slots defined in data/profile.ini:

Profile Path Status
Profile1 data/profile1/ βœ… Default
Profile2 data/profile2/ Available
Profile3 data/profile3/ Available
Profile4 data/profile4/ Available
Profile5 data/profile5/ Available

Switching Profiles

To launch a different profile, edit the zenbrowser.bat file and change profile1 to your desired profile:

"%APP_DIR%\win\zen.exe" -profile "%DATA_DIR%\profile2" -no-remote

Alternatively, you can use Zen Browser's built-in Profile Manager by launching with the -ProfileManager flag:

"%APP_DIR%\win\zen.exe" -ProfileManager

πŸ”„ Updating Zen Browser

To update to a newer version of Zen Browser:

  1. Download the latest Zen Browser from zen-browser.app/download.
  2. Delete the contents of the app/win/ folder.
  3. Extract the new browser files into app/win/.
  4. Your profiles and data remain untouched in the data/ folder.

Caution

Do not delete the data/ directory when updating. It contains all your bookmarks, passwords, extensions, and browsing history.


πŸ›‘οΈ Security & Privacy Notes

  • Isolated Execution: The -no-remote flag ensures this instance runs completely independently.
  • No System Traces: Since profiles are stored within the portable folder, nothing is written to the Windows registry or %APPDATA%.
  • USB Safe: You can run this from a USB drive and remove it without leaving any data on the host computer.
  • Your Responsibility: While this setup is portable, always ensure you're downloading Zen Browser binaries from the official source to avoid tampered builds.

πŸ™ Attribution & Credits

This project is a community portable repackaging and is not an official product of the Zen Browser team.

Zen Browser A beautifully designed, Firefox-based, open-source browser.
🌐 zen-browser.app
πŸ’» github.com/zen-browser/desktop
πŸ“„ docs.zen-browser.app
πŸ“œ Licensed under MPL-2.0
Mozilla Firefox The engine behind Zen Browser.
🌐 mozilla.org/firefox

If you enjoy Zen Browser, consider supporting the project:


πŸ“œ License

This portable configuration (launcher scripts, directory structure, and documentation) is provided as-is for personal use.

Zen Browser itself is licensed under the Mozilla Public License 2.0 (MPL-2.0). All rights to the Zen Browser source code and binaries belong to their respective authors and contributors.


🀝 Contributing

Contributions are welcome! If you have ideas for improving the portable setup:

  1. Fork this repository
  2. Create a feature branch (git checkout -b feature/my-improvement)
  3. Commit your changes (git commit -m "feat: add my improvement")
  4. Push to the branch (git push origin feature/my-improvement)
  5. Open a Pull Request

Reporting Issues

If you encounter problems with the portable launcher, please open an issue on this repository. For issues with Zen Browser itself, please report them on the official issue tracker.


Made with ❀️ for portable browser enthusiasts

About

Portable launcher and configuration setup for Zen Browser on Windows.

Topics

Resources

License

Stars

7 stars

Watchers

0 watching

Forks

Contributors