Is val-protocol still maintained?

Slowing down. Last change 4 months ago.

Can I trust val-protocol?

Some track record. 106 stars, 4 months old. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to set up val-protocol (Maikyxd/val-protocol) · gitmanual

Assembly instructions

Maikyxd/val-protocol

Motorola LK Patcher That Allows Unlock Bootloader And Remove FRP on MTK Devices Using Fastboot and LK cert exploit

Python

Before you start

Is it free?: YesOpen source (AGPL-3.0).
Still maintained?: Slowing downLast change 4 months ago.
Can I trust it?: Some track record106 stars, 4 months old. Get it from the official repo and read what it installs.

Difficulty: Moderate
Time: 30 min or more
Stars: ★ 106
Activity: Updated 4 months ago

GitHub didn't answer, so this is the saved copy from 1 days ago

Will it work on macOS?

Depends on your device

The app runs on a separate device (phone, tablet or TV). Your computer only installs it.
The README lists supported devices under “Compatibility”. Find yours there first.

Supported devices from the README: Compatibility

Compatibility is pattern-based, not model-name-based. A new LK is considered compatible only when:

the lk payload can be extracted,
the architecture is detected,
the unlock flow is found,
the FRP/OEM checker candidate is found,
the key validator candidate is found,
the unlock erase block is found when the selected preset needs it,
the serial number runtime source is found,
the rebuilt image verifies as Result: VALID.

Always test patched images on recoverable lab devices before using them in production workflows.

Your system

macOS Windows Linux

Launch script in the repo

The maintainers included run_lk_patcher_ui.bat. Run it from the cloned folder after reading it.

.\run_lk_patcher_ui.bat

4 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

Check it supports your device / system
Compare yours with the README's “Compatibility” list above before installing anything.

Clone the repository

Needs Git: xcode-select --install

git clone https://github.com/Maikyxd/val-protocol.git
cd val-protocol

3
Install the required runtimes
Python 3.x (no version pinned), adb (Android platform-tools)
```
brew install python
brew install --cask android-platform-tools
```

Install dependencies

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

From the README: Quick Start

Patch an LK image with the serial-based unlock preset:

python lk_auto_patch.py "path/to/lk.img" \
  -o "path/to/lk.unlock-serial.img" \
  --preset unlock-serial \
  --key-token-secret "YourSecret"

Read the device serial number:

fastboot getvar serialno

Generate a key for that serial number:

python lk_keygen.py --secret "YourSecret" --serialno "SERIAL_FROM_FASTBOOT" --count 1

Use the generated key:

fastboot oem unlock GENERATED_KEY

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.