Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

29 Commits

WolfPack

WolfPack

A custom LibreWolf distribution for Windows with optimized defaults, pre-installed extensions, and portable packaging.

Latest ReleaseWolfPack version 1.5.0DownloadsBuild


What Is This?

WolfPack takes the official LibreWolf portable build and repackages it with:

  • Google as default search engine (with suggestions enabled)
  • DRM enabled out of the box (Netflix, Disney+, Spotify work immediately)
  • Pre-installed extensions via enterprise policies
  • Optimized performance defaults (disk cache, prefetching, GPU acceleration)
  • Session persistence (cookies and logins survive restarts)
  • Password manager and autofill enabled by default
  • Resist Fingerprinting (RFP) disabled to prevent site breakage
  • Dark theme with custom CSS support
  • Portable mode with local profile storage

All telemetry, Mozilla promotions, Pocket, Firefox Sync, safe browsing, and other bloat remains disabled from upstream LibreWolf.

Downloads

FileDescription
WolfPack-<version>-setup.exeWindows installer (Start Menu + Desktop shortcuts, Add/Remove Programs)
WolfPack-<version>-portable.zipPortable zip (extract anywhere and run WolfPack.exe)
WolfPack-<version>.msixMSIX package for enterprise deployment (requires signing before end-user installation)

Download from the Releases page.

Pre-Installed Extensions

ExtensionSource
uBlock Origin (MV2)Verified AMO package; the uBlockVanced CRX is retained as an audited fallback candidate
Dark Reader (MV2)Verified AMO package while the DarkReaderLocal fork is unavailable
ScriptVaultCustom userscript manager
StyleKitCustom userstyle manager
SponsorBlockSkip YouTube sponsors
Reddit Enhancement SuiteReddit improvements
Adaptive Tab Bar ColourTab bar matches page color

Extensions are installed automatically on first launch via policies.json.

The extracted package also contains admin-templates/WolfPack.admx and the matching en-US/WolfPack.adml. Copy them to the domain Central Store (or the local %WINDIR%\PolicyDefinitions directory) to expose WolfPack settings in Group Policy. The templates write the standard Firefox policy registry path, Software\Policies\Mozilla\Firefox, so they can be used with managed or portable WolfPack deployments without rebuilding the package.

Changes from Stock LibreWolf

Enabled (was disabled)

  • DRM / Encrypted Media Extensions (streaming services)
  • Disk cache (performance)
  • Search suggestions in URL bar
  • DNS prefetching and speculative connections
  • Password manager and form autofill
  • Session persistence (cookies kept on shutdown)
  • Weather widget on new tab page

Disabled (was enabled)

  • Resist Fingerprinting (RFP) - causes timezone, canvas, and font issues
  • Global Privacy Control (GPC)
  • Sanitize on shutdown (users were getting logged out)
  • Always-ask download location

Search Engines

Google is the default. Also available: DuckDuckGo, DuckDuckGo Lite, SearXNG, StartPage.

Building

Prerequisites

  • Windows 10/11
  • PowerShell 5.1+
  • NSIS (for installer builds)
  • Windows 10/11 SDK (for MSIX builds)
  • .NET Framework 4.x (for launcher compilation)

Build Commands

# Build everything (downloads latest LibreWolf automatically)
.\build-portable.ps1# Build the beta channel (requires an upstream beta artifact/version)
.\build-portable.ps1-Channel beta
# Build specific version
.\build-portable.ps1-Version "146.0.1-1"# Portable zip only (skip installer)
.\build-portable.ps1-PortableOnly
# Rebuild without re-downloading
.\build-portable.ps1-SkipDownload
# Audit configured extension packages and fallback candidates online
.\scripts\Audit-WolfPackExtensions.ps1 -Online -Strict

Output

  • output/WolfPack-<version>-portable.zip
  • output/WolfPack-<version>-setup.exe
  • output/WolfPack-<version>.msix

The build verifies the downloaded LibreWolf archive against librewolf.lock. CI builds fail when the version or SHA-256 hash differs; intentional local experiments can use -AllowUnpinned. The extension audit reads each package's manifest.json, verifies its Firefox ID and Manifest Version, and rejects Chromium-only CRX artifacts before a fallback is promoted to wolfpack.cfg.

Project Structure

WolfPack/
assets/ # Icon and logo files
launcher/ # C# portable launcher source
patches/ # Upstream LibreWolf patches
themes/ # Upstream LibreWolf branding/themes
scripts/ # Upstream LibreWolf build scripts
l10n/ # Localization files
.github/workflows/ # CI/CD build pipeline
build-portable.ps1 # Main build script
installer.nsi # NSIS installer script
policies.json # Enterprise policies (extensions, search engines)
user.js # Browser preferences

How It Works

  1. Downloads the latest official LibreWolf portable zip from GitLab
  2. Patches librewolf.cfg to fix common complaints (DRM, cache, RFP, etc.)
  3. Injects custom policies.json for extension auto-install and Google default
  4. Injects user.js with optimized preferences into the portable profile
  5. Copies the GPO/ADMX templates into admin-templates/
  6. Compiles a lightweight C# launcher (WolfPack.exe, ~5KB)
  7. Packages as portable zip and NSIS installer

License

LibreWolf is licensed under the Mozilla Public License 2.0. This repackaging project adds configuration and build tooling only.

About

Custom LibreWolf portable distribution for Windows with optimized defaults

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages