Code Monkey home page Code Monkey logo

firmware_oneplus's Introduction

Oneplus Firmware Extractor

Easily extract the firmware and modem from stock OxygenOS images for use with other roms.

No OxygenOS flash to your device is necessary

You can sideload the extracted firmware without needing to flash OxygenOS over your existing Lineage or MicroG Lineage OS.

Extract the official firmware by yourself, without relying on third parties or potentially untrustworthy hosting sites.

Compatibility

To run the extract script:

  • Any operating system with bash; all Linux distros and MacOS. Not tested on Windows or WSL.

Device:

  • For Oneplus 3, 3T, 5 and 5T devices

(should also work for others, providing the images' hierarchy is similar)

How to Use

  1. Clone this repository
git clone --depth=1 https://github.com/angela-d/firmware_oneplus.git

(Use --depth=1 to avoid pulling in legacy objects from the original repo)

  1. Obtain the latest copy of OxygenOS from Oneplus as a .zip
  2. In your terminal, navigate to the directory where you cloned this repo: cd firmware_oneplus && ls -l - if you see the directory contents, you're ready to go

As of v2.0, the command-line options have been greatly simplified, using interactive prompts.

To trigger the tool, simply run:

./extract

or

/path/to/extract

That's it! The screen will prompt and guide you through the process.

Successful image generated:

Flashable Firmware Generated

Image mis-match (built-in error checking):

Image Mis-Match

Pre-packaged zip ready to go (the screenshot is focused on the extracted image, showing that all of the OxygenOS stuff is gone and only the desired update remains):

Generated Image


Updating Your Device

Once extract completes, locate your flashable zip (the terminal will tell you the path!)

  • Connect your device to your computer via USB and run adb devices from your terminal to initiate a connection
  • In TWRP Recovery (if you aren't in recovery yet: instructions to get there):
  1. Advanced
  2. Sideload
  3. TWRP will prompt sideloading has started; from your terminal, run:
adb sideload firmware-update-oneplus5T.zip

That's it.

Note: If you tried to update before flashing the firmware, you may get an "update failed" notification once Lineage boots back up. Simply go to Settings > Update > Install again and let it do it's thing. It should then finish the upgrade with the latest Oneplus firmware.

Current Firmware

As of March 25, 2020 the latest firmware is 9.0.11

Caveats

No responsibility to anyone but yourself if you brick your device!

Author & License

Forked concept originally by Koenkk; his commits licensed under public domain (no license)

Code by Angela licensed under GPL2

firmware_oneplus's People

Contributors

angela-d avatar josh5 avatar koenkk avatar onenormalusername avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.