Flashing & Updating
How to flash and update the Doppelgänger firmware
This walkthrough assumes you’re using Windows 11. However, the process should be similar regardless of your operating system. We recommend using either macOS or Windows, as at the time of writing, Linux interactions resulted in mkLittleFS dependency errors.
To build and install the Doppelgänger firmware, you’ll need the following dependencies:
VS Code and Dependency Installation
- VS Code
- Python Interpreter - Be sure to select Add Python 3.X to PATH during installation.
- Git - Use the default settings, except for the Default Editor — change it from Vim to VS Code.
PlatformIO IDE Installation
With VS Code and the required dependencies installed, open VS Code and install the PlatformIO Extension. Click on the PlatformIO icon to start the PlatformIO Core Installation (you’ll find it under the Extensions: Marketplace icon). When prompted by VS Code, restart the application.
Loading Doppelgänger into PlatformIO
With VS Code open, click the PlatformIO icon and select Clone Git Project. In the prompt, paste the firmware repo you want to flash and hit Enter:
- Doppelgänger Core: https://github.com/mwgroup-io/Doppelganger_Core.git (Not yet publicly released)
- Doppelgänger Stealth: https://github.com/mwgroup-io/d_stealth_v2.git (Not yet publicly released)
You’ll be asked where to store the project — choose a suitable location. When prompted, open the project and select Yes, I trust the authors.
Building and Flashing
With the project open, click the PlatformIO icon to open the PlatformIO tools. Use the following operations to build and upload the firmware and filesystem.
Note: It’s important to close the PlatformIO terminal after each operation using the Kill Terminal icon (trash can).
Failing to do so may result in errors during certain operations.
The following screenshot highlights the location of the Kill Terminal icon:
After selecting Upload and Monitor, you should see output similar to the following TTY log, indicating a successful upload of the firmware and filesystem:
======================================================================
D_Core
Copyright (c) 2025: Mayweather Group, LLC
Firmware Version: 1.0.0
Build Date: 01APR2025
Hardware REV: 1.0a
Firmware & Hardware: @tweathers-sec (GitHub) @tweathers_sec (X.com)
======================================================================
LEGAL DISCLAIMER:
This device is intended for professional penetration testing only.
Unauthorized or illegal use/possession of this device is the sole
responsibility of the user. Mayweather Group LLC, Practical Physical
Exploitation, and the creator are not liable for illegal application
of this device.
======================================================================
[FILESYSTEM] Initializing the filesystem...
======================================================================
[DEBUG] Debug mode enabled
======================================================================
Firmware Updates
To update your device’s firmware, run a git pull to fetch the latest changes from the repository, then repeat the build and flash steps above.