PEBakery is a script engine that specializes in customizing the Windows Preinstalled Environment (WinPE/WinRE).
| CI Server | Branch | Build Status |
|---|---|---|
| AppVeyor | Master | |
| AppVeyor | Develop | |
| Azure Pipelines | Master | |
| Azure Pipelines | Develop |
PEBakery is backward compatible with WinBuilder 082 and makes significant improvements upon it.
- All implementation is backed by documentation and black box testing, without violating the EULA of WinBuilder 082.
- The developers do not provide any warranty, use it at your own risk. Backup is highly recommended.
- Windows Preinstalled Environment is a registered trademark of Microsoft.
The official release version is recommended for general use.
A nightly build is provided for testing purposes.
- Official Release
- Lastest Nightly (develop)
- Standalone Nightly (x64)
- No dependency
- Sizes about 170MB
- Standalone Nightly (arm64)
- No dependency
- Sizes about 180MB
- Runtime-dependent Nightly (x64, x86, arm64)
- Requires .NET 6 Desktop Runtime
- Sizes about 28MB
- Supports both x64, x86, arm64 architecture
- Standalone Nightly (x64)
CAUTION: Do not forget to set the proper compatibility options for your projects. We have prepared a special Migrating from WinBuilder guide, so you know what script breaking changes to expect and when compatibility options need to be enabled.
Nightly binaries are served by AppVeyor artifacts.
PEBakery runs on .NET 6.
- Standalone Nightly does not require any runtime installed, but runs only on one architecture (e.g. x64).
- Runtime Dependent Nightly runs on both x64, x86 and arm64 Windows, but requires latest .NET 6 Desktop Runtime to be installed.
PEBakery is primarily licensed under GPLv3 or any later version with additional permission.
Some parts of PEBakery are licensed under the MIT License and other licenses.
Please read LICENSE for details.
Please read ChangeLog.
Please read the Official PEBakery Manual.
Testers using nightly builds should refer to the developer branch Official PEBakery Manual (develop).
.NET Core SDK, Windows SDK, and MSVC are required to compile PEBakery from the source.
- .NET 6 SDK to build and test
PEBakery.exe. - Windows 10 SDK to build
PEBakeryLauncher.exe- Requires Microsoft C++ Build Tools 2022 or later
If you are a contributor, we recommend using a full-featured Visual Studio Community for the best development experience.
Nightly binaries can be compiled by running .\BinaryPublish.ps1 -nightly on PowerShell.
Publish\PEBakery-nightly-rt: Runtime-dependent binaryPublish\PEBakery-nightly-sc_{arch}: Standalone binary for a specific architecture
To test PEBakery, download one of the PE projects and install the PEBakery binary.
These PE projects officially support PEBakery.
These PE projects have been tested with PEBakery.
NOTE: <ProjectPath> is the directory that contains the Projects directory from the PE building project.
- (Simple) Copy
PEBakeryLauncher.exeandBinaryinside<ProjectPath>, and runPEBakeryLauncher.exe. - (Advanced) Launch
PEBakeryLauncher.exeorPEBakery.exewith--baseDirparameter.$ .\PEBakeryLauncher.exe --baseDir <ProjectPath> # or $ .\Binary\PEBakery.exe --baseDir <ProjectPath>
