Skip to content

Instantly share code, notes, and snippets.

@wxllow
Last active July 17, 2025 18:47
Show Gist options
  • Select an option

  • Save wxllow/e82054305b06900c619f5a76a43c8ab9 to your computer and use it in GitHub Desktop.

Select an option

Save wxllow/e82054305b06900c619f5a76a43c8ab9 to your computer and use it in GitHub Desktop.
T-Mobile OnePlus 8T Unlock and Root Guide

T-Mobile OnePlus 8T Unlock and Root Guide

This guide provides instructions for converting a T-Mobile OnePlus 8T+ 5G (kebab KB2007) to the EU firmware, unlocking the bootloader, and obtaining root access with Magisk on OxygenOS 14. Using this method, no unlock token is required.

Disclaimer: This process will void your warranty (lol) and completely wipe all data on your device. You are solely responsible for any damage, data loss, or bricked devices that may result from following this guide. Proceed at your own risk.

Important: It is highly recommended that you back up your personal data before starting. Additionally, consider backing up your modem and persist partitions in case of unforeseen issues.

Prerequisites

  • OnePlus 8T+ 5G (Model: KB2007, Codename: kebab)
  • A reliable USB-C cable (USB 2.0 port or cable is recommended, some report issues with USB 3 ports)
  • A computer running Windows
  • ADB & Fastboot Platform Tools
  • Patience and problem-solving skills

Part 0: Setup USB Drivers

You may need Qualcomm USB Drivers in order to get MSM to recognize your device.

Donwload and setup the driver from https://androiddatahost.com/wp-content/uploads/Qualcomm_USB_Driver_v1.0.zip

Disable Driver Signature Enforcement

Temporarily disabling driver signature enforcement may be required in order to get the drivers to work.

  1. Restart into Advanced Startup:
    • Click the Power icon in the Start menu
    • Hold down the Shift key and click Restart.
  2. Navigate to Startup Settings:
    • After your PC restarts to the "Choose an option" screen, select Troubleshoot.
    • On the "Troubleshoot" screen, select Advanced options.
    • Select Startup Settings.
  3. Restart for Startup Settings:
    • Click the Restart button to reboot your PC into the Startup Settings menu.
  4. Disable Driver Signature Enforcement:
    • Once your PC restarts, you'll see a list of startup options.
    • Select Disable driver signature enforcement.
  5. Install the Qualcomm driver

This setting will revert to default after the next restart.


Get Started


Part 1: Convert T-Mobile Firmware to EU OxygenOS 11

This procedure uses an MSM (MsmDownloadTool) package to flash the EU firmware, which is a prerequisite for bootloader unlocking.

Critical: This step will wipe all data on your device.

This guide is based on the process outlined on the XDA Forums.

  1. Download the EU OxygenOS 11 MSM conversion package.
  2. Extract the package and run MsmDownloadToolV4.0.exe.
  3. In the login prompt, select the User type Other and click Next.
  4. Press the Start button. The tool will now wait for a device connection.
  5. Power off your phone completely. Wait about 30 seconds.
  6. Enter EDL Mode: Press and hold both the Volume Up and Volume Down buttons simultaneously, then connect the phone to your PC with the USB cable. You can release the buttons once the tool detects the device and the flashing process begins.
  7. The process will take approximately 5-10 minutes. Once complete, the phone will automatically reboot.
  8. Proceed through the initial Android setup. Do not update beyond OxygenOS 11 at this stage if you intend to unlock the bootloader.

Part 2: Unlock the Bootloader

Critical: This step will wipe all data on your device.

Warning: You must be on EU OxygenOS 11 to perform the bootloader unlock. The option is unavailable on later versions without an unlock token, which may not be obtainable for a converted device. If you have already updated, you will need to downgrade back to OOS 11.

  1. Enable Developer Options:
    • Go to Settings > About phone > Version.
    • Tap on the Build number seven times until you see the message "You are now a developer!"
  2. Enable Required Settings:
    • Go to Settings > Additional Settings > Developer options.
    • Enable OEM unlocking.
    • Enable USB debugging.
  3. Connect your phone to your computer and authorize the USB debugging connection if prompted.
  4. Open a terminal or command prompt with ADB access and reboot into the bootloader:
    adb reboot bootloader
  5. Once the device is in fastboot mode, execute the unlock command:
    fastboot oem unlock
  6. Follow the instructions on your phone's screen to confirm the unlock. The device will wipe its data and reboot.

After the bootloader is unlocked, you can set up your device again. You are now free to update to the latest version of OxygenOS (e.g., OOS 14) via official OTA updates or by using an app like Oxygen Updater.


Part 3: Root with Magisk

Security Warning: Rooting your device can expose it to security risks, break certain applications (e.g., banking, Google Wallet), and may lead to instability if not done correctly.

It's recommended you update to the latest version of OxygenOS 14 before continuing

This process is based on the guide found on the XDA Forums.

Step 3.1: Extract the Stock Boot Image

We will use the MSM tool again, but this time only to read the boot.img file from the phone.

Critical: Do NOT press the Start button in the MSM tool during this part. Doing so will re-flash Android 11 and wipe your device.

  1. Download and extract the MSM package for the EU OxygenOS version.
  2. Run MsmDownloadToolV4.0.exe, select Other as the user type, and click Next.
  3. Press F8 on your keyboard to open the "Readback Partition Table" window.
  4. First, determine your phone's active boot slot. In an ADB shell, run:
    adb shell getprop ro.boot.slot_suffix
    This will return _a or _b.
  5. In the MSM tool's partition list, check the box for your corresponding active boot partition ONLY (boot_a or boot_b). Do not select both.
  6. Enter the password oneplus and click OK.
  7. Click the Readback button in the top-left of the tool. It will now show a "Waiting for device" status.
  8. Reboot your phone into EDL Mode as you did in Part 1.
  9. The tool will detect the phone and extract the boot image. The file (boot_a.img or boot_b.img) will be saved to your main Windows drive (typically C:\).

Step 3.2: Patch the Boot Image with Magisk

  1. Copy the extracted boot image (boot_a.img or boot_b.img) from your PC to your phone's internal storage.
  2. Download the latest Magisk APK from the official GitHub repository and install it on your phone.
  3. Open the Magisk app.
  4. Tap Install > Select and Patch a File.
  5. Navigate to and select the boot image you copied to your phone.
  6. Magisk will create a patched image file (e.g., magisk_patched-[...].img) in your Download folder.
  7. Copy this new patched image file from your phone back to your computer's ADB/fastboot folder.

Step 3.3: Flash Magisk and Finalize

  1. Reboot your phone into the bootloader:
    adb reboot bootloader
  2. Temporarily boot from the patched image to verify it works.
    fastboot boot magisk_patched-[...].img
  3. Your phone will boot into Android. Open the Magisk app and verify that the "Installed" field shows a version number, not "N/A".
  4. If the verification is successful, make the installation permanent. In the Magisk app, tap Install > Direct Install (Recommended).
  5. Reboot your phone one last time.

Congratulations, your device is now rooted

Other Useful Things

OxygenOS 15 Port

A port of OxygenOS 15; includes KernelSU.

See https://xdaforums.com/t/shared-rom-port-oxygenos-15-for-oneplus-8t-11-12-24.4704221/

Download link: https://sourceforge.net/projects/coloros-port/files/OxygenOS15/

(Use the file beginning with ota_full-KB2003)

OrangeFox Recovery

OrangeFox Recovery is a custom Android recovery environment based on TWRP, offering an enhanced user interface and additional features for flashing custom ROMs, kernels, and managing device partitions.

Download link: https://github.com/Wishmasterflo/device_oneplus_opkona/releases/tag/R12.1_V32

Flash using fastboot flash recovery [file] and then immediately boot into it using fastboot boot [file]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment