bkerler /mtkclient

Mediatek Flash and Repair Utility

★ 1,545⑂ 314👁 36⑃ 56● 350▤ 3
PythonGPL-3.0Created 2026-01-18
Download: Version 2.1.4Version-2.1.4.1 ↓2.1.4.12026-03-18
1,545
stars
314
forks
36
watchers
56
prs
350
issues
3
releases

README

Language:
  🇺🇸
  🇨🇳


 MTKClient
!Logo

Just some mtk tool for exploitation, reading/writing flash and doing crazy stuff. 
For windows, you need to install the stock mtk port and the usbdk driver (see instructions below).
For linux, a patched kernel is only needed when using old kamakiri (see Setup folder) (except for read/write flash).

Once the mtk script is running, boot into brom mode by powering off device, press and hold either
vol up + power or vol down + power and connect the phone. Once detected by the tool,
release the buttons.

 MT6781, MT6789, MT6855, MT6886, MT6895, MT6983, MT8985
- These chipsets use a new protocol called V6 and the bootrom is patched. 
You need to use the --loader option and a proper loader from the Loaders/V6 directory. 
Bootrom won't work, you need to use preloader mode (no hw buttons pressed, just connect). 
On some devices, preloader is deactivated, but you can reactivate it by running "adb reboot edl".

 Credits
- kamakiri [xyzz]
- linecode exploit [chimera]
- heapbait exploit [chimera], creds to [R0rt1z2],[Shomy]
- Chaosmaster
- Geert-Jan Kreileman (GUI, design & fixes)
- All contributors

 Installation

See linux/macos installation hints

See windows installation hints

See automated Windows installer

 Usage
See usage instructions

 Use Re LiveDVD (everything ready to go, based on Ubuntu):
User: user, Password:user (based on Ubuntu 22.04 LTS)

Live DVD V6

 I have issues ....... please send logs and full console details !

- Run the mtk tool with --debugmode. Log will be written to log.txt (hopefully)

 Rules / Infos

 Chip details / configs
- Go to config/brom_config.py
- Unknown usb vid/pids for autodetection go to config/usb_ids.py

 Other Stuff 
Learning resources

Top issues

Discussions

Latest release

Version 2.1.4 v2.1.4.1 2026-03-18
What's Changed
 xml_lib: Fix Carbonara check for V6 devices by @R0rt1z2 in https://github.com/bkerler/mtkclient/pull/90
 Add 64bit support for heapbait by @bkerler in https://github.com/bkerler/mtkclient/pull/93
 fix: MT6771 (0x6771) infinite timeout during flash read — move to two-write ACK path by @gauravyad69 in https://github.com/bkerler/mtkclient/pull/97
 GUI improvements

 New Contributors
 @gauravyad69 made their first contribution in https://github.com/bkerler/mtkclient/pull/97

Full Changelog: https://github.com/bkerler/mtkclient/compare/v2.1.3...v2.1.4

Snapshot: 2026-11-17T10:29:19Z · Data license Apache-2.0 · JSON