Umbrage is a cross-platform GUI tool for working with MediaTek SOC-based devices, built on top of the penumbra core.
The project aims to make routine and complex tasks such as bootloader unlocking or flashing as simple and accessible to everyone as possible, eliminating the need to deal with the terminal and scripts.
The main goal of the project is to create an open and strong alternative to existing paid utilities, which will constantly evolve thanks to community support and contributions.
Unlike classic bulky GSM tools, overloaded with a thousand buttons and unnecessary elements on screen, Umbrage focuses on a clean interface.
The process is built sequentially: the app hides everything irrelevant at the current stage and guides the user through the steps - for example, sequentially requesting the required files (DA -> AUTH -> PRELOADER).
Why spend a long time searching for files on the internet when you can use the Umbrage user repository?
It contains a huge database of DA, AUTH, and PRELOADER files, neatly sorted by device and verified by the community. Just specify your device model and pick one of the ready-made templates.
It works exactly like paid GSM tools, but way cooler, more flexible, and completely free!
Umbrage uses the penumbra core as its backend, so all supported exploits (karbonara, kamakiri, HeapB8, etc.) are available right out of the box.
This allows unlocking the bootloader on vulnerable devices with a single click.
Umbrage provides a convenient tool for working with device memory, allowing you to backup (dump) and write individual partitions in just a few clicks.
Use the same scatter files and instructions as in SP Flash Tool, straight in Umbrage!
Download the latest release, run Umbrage in the terminal and simply follow the on-screen instructions!
./umbrage-linux.AppImage- Install qt6
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" && brew install qt- Download the latest release, run Umbrage in the terminal with elevated privileges and simply follow the on-screen instructions!
sudo ./umbrage-macos-arm
⚠️ WARNING!Using Windows is strongly NOT recommended!
Umbrage currently does not provide ready-made Windows binaries, because making this fing slop system work properly with MediaTek devices is a souls-like game on hardcore mode.*
DO NOT USE WINDOWS! ONLY IF YOU'RE A MASOCHIST! DON'T CRY LATER!
If you've still decided to suffer - compile umbrage-setup.exe from source and run it to install Umbrage.
libusb is already bundled into the binary, but a suitable driver for the MediaTek USB interface is not installed automatically.
Install WinUSB once via Zadig:
- Connect the device in BROM / Preloader / DA mode.
- Open Zadig and select the device's USB interface that appears.
- Select WinUSB as the driver.
- Install the driver.
AND DO IT FAST.
The device may remain in BROM/Preloader mode for only a limited time, after which it simply disappears from the system. So you need to select the right USB interface in Zadig and install the driver while the device is still detected.
After that, Umbrage will be able to access the device via libusb (Probably, depending on the Indians' mood).
Quite simple, isn't it?
You can contribute to the project in two key ways:
- The first and most obvious is direct contribution to Umbrage's development.
- The second, no less valuable contribution is developing the umbrage templates repository, which plays a very important role in the project and the entire Umbrage ecosystem.
For build instructions and other useful development info, see CONTRIBUTING.md
Artificial intelligence is allowed to be used as an assistant, but you must fully understand every change it makes and take full personal responsibility for it.
PRs written on a "vibe coding" basis (mindlessly copied and unverified code) will be closed without hesitation.
Systematic violations may result in a permanent ban across all Umbrage project repositories.