PortableBrowser.Launcher 1.0.0

PortableBrowser.Launcher

A lightweight, zero-dependency C# library that automates downloading, extracting, and launching a portable Chromium-based web browser (Helium Browser) on Windows with 100% Zero-Trace Stealth Mode.

It requires no preinstalled browser on the host machine and leaves absolutely zero footprint (no binaries, zip files, history, cookies, or cache) upon exit.

🚀 Features

• True Zero-Trace Stealth Mode: Generates an isolated temporary workspace on every launch, automatically clearing the downloaded .zip, extracted binaries, and user profile traces (cookies, cache, local storage, history) when the browser window is closed.
• Incognito & Anti-Telemetry: Launches with Chromium security flags configured to block tracking, default checks, and telemetry by default.
• Automatic CPU Architecture Detection: Seamlessly detects and pulls the correct architecture binary (x64 or arm64) for the host machine.
• Multi-Framework Native Support: Native targets from legacy enterprise to modern platforms:
  • .NET Framework 4.8 & 4.8.1
  • .NET Standard 2.0 & 2.1
  • .NET Core 6.0, 7.0, 8.0, & 9.0
• Progress Tracking: Exposes a reactive progress reporter (IProgress<double>) to easily display download progress to your users.
• Robust Process Supervision: Actively monitors the process tree, cleans up orphaned sub-processes, and utilizes an exponential backoff folder eraser to handle closing OS file locks safely.

📦 Installation

Install the package via the NuGet Package Manager Console:

Install-Package PortableBrowser.Launcher

Or via the .NET CLI:

dotnet add package PortableBrowser.Launcher

💻 Quick Start

1. Minimal Zero-Trace Stealth Launch

To launch the browser pointing to a URL with full auto-cleanup on close, simply call:

using PortableBrowser.Launcher;

// Downloads, extracts, launches in incognito, and completely wipes all files on close!
await HeliumLauncher.LaunchAsync("https://example.com");

2. Advanced Usage with Download Progress and Custom Arguments

using System;
using PortableBrowser.Launcher;

// 1. Setup options
var options = new LauncherOptions
{
    StealthMode = true, // Enables full auto-deletion of zip + binaries + cookies + cache on close
    Incognito = true,   // Launches in incognito window
    
    // Wire up download progress indicator
    DownloadProgress = new Progress<double>(percent =>
    {
        Console.Write($"\rDownloading browser: {percent:P0} ");
    })
};

// Add custom chromium command line arguments if desired
options.CustomArguments.Add("--mute-audio");

// 2. Launch
Console.WriteLine("Launching secure session...");
var process = await HeliumLauncher.LaunchAsync("https://example.com", options);

// 3. Wait for exit (optional)
process.WaitForExit();
Console.WriteLine("\nBrowser closed and all traces successfully erased!");

📄 License

This library is released under the MIT License.