# evbunpack (bundled tool) `evbunpack.exe` is a bundled, third-party unpacker used by the **Evb** engine module to unpack applications protected with **Enigma Virtual Box**. ## Provenance - Upstream project: https://github.com/mos9527/evbunpack - Description: Enigma Virtual Box Unpacker / 解包・脱壳工具 - License: Apache-2.0 (see `LICENSE` in this folder for the full text) - Repository status: **archived (read-only) by the owner on 2026-02-06** - Version / release: bundled from the upstream Windows builds (see the "For Windows Users: Builds are available here" link in the upstream README, which points to the project's GitHub Releases page). > **NOTE**: The binary in this folder is not committed as part of the normal source > tree review flow. Place the upstream-release `evbunpack.exe` here before publishing. > If the file is absent, the `Evb` engine module reports the tool as unavailable and > skips unpacking instead of throwing (callers degrade gracefully). ## CLI usage ``` evbunpack [-h] [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [-l] [--ignore-fs] [--ignore-pe] [--legacy-fs] [-pe {10_70,9_70,7_80}] [--out-pe OUT_PE] file output ``` - `file` : the packed `.exe` (input) - `output` : the folder that receives the unpacked files (created if missing) The tool restores **both** the virtual file system contents **and** the original PE executable, in a single invocation. ### PE variant selection | Packer version | Unpack with flags | |----------------|------------------------------| | 11.00 | `-pe 10_70` | | 10.70 | `-pe 10_70` | | 9.70 | `-pe 9_70` | | 7.80 | `-pe 7_80 --legacy-fs` | `EvbUnpackerToolProvider.BuildArguments` defaults to `-pe 9_70` and can be overridden per call. ## Alternatives (when re-bundling is not possible) - Install via PyPI: `pip install evbunpack` and run `python -m evbunpack ...` (requires a Python runtime on the target machine). - Build from source with `setup.py` / `pyinstaller` following the upstream README. ## Where it is used - `Engines/Evb/EvbUnpackerToolProvider.cs` — resolves the executable and builds CLI arguments. - `Engines/Evb/EvbUnpackService.cs` — orchestrates detection, unpacking and re-detection. Resolution order (see `EvbUnpackerToolProvider.GetToolPath`): 1. `Engines/Evb/Tools/evbunpack/evbunpack.exe` (bundled layout, this folder) 2. `Engines/Evb/Tools/evbunpack.exe` (flat layout) 3. `AppPathHelper.ResolveEngineTool("Evb", "evbunpack/evbunpack.exe")` fallback probe.