diff --git a/README.md b/README.md index 37c8ab5a..edb2ffe5 100644 --- a/README.md +++ b/README.md @@ -36,19 +36,29 @@ If you wish to backup the TA partition first, you can find tutorials related to ## Officially supported devices Vendor | Device Name | CodeName | Models | Status ---|---|---|---|--- +Samsung | Galaxy J7 2015 | j7elte | | tested Samsung | Galaxy A3 2017 | a3y17lte | SM-A320FL | tested Samsung | Galaxy A5 2016 | a5xelte | SM-A510F | tested +Samsung | Galaxy A7 2016 | a7xelte | | tested Samsung | Galaxy S7 | herolte | SM-G930F | tested -Samsung | Galaxy S9 | starlte | | under development +Samsung | Galaxy S9 | starlte | | tested +Samsung | Galaxy S10 | beyond1lte | | tested Google | Pixel 3a | sargo | sargo | tested -Google | Pixel 4a | sunfish | sunfish | planned +Google | Pixel 4 | flame | flame | tested +Google | Pixel 4a | sunfish | sunfish | tested +Google | Pixel 5 | redfin | redfin | tested +Google | Pixel 5a | barbet | barbet | tested Sony | Xperia Z | yuga | C6603 | tested -Sony | Xperia Z3 | z3 | | under development +Sony | Xperia Z3 | z3 | | tested Sony | Xperia ZX | kagura | | planned -Fairphone | Fairphone 2 | FP2 | | under development +Fairphone | Fairphone 2 | FP2 | | tested Fairphone | Fairphone 3 | FP3 | | tested Motorola | moto G5 | cedric | | planned Motorola | moto g7 power | ocean | | under development +OnePlus | 6 | enchilada | | under development +OnePlus | 6T | fajita | | under development +OnePlus | 7T | hotdogb | | under development +OnePlus | 9 | lemonade | | under development ## Usage diff --git a/openandroidinstaller/assets/configs/a72q.yaml b/openandroidinstaller/assets/configs/a72q.yaml new file mode 100644 index 00000000..ef470a10 --- /dev/null +++ b/openandroidinstaller/assets/configs/a72q.yaml @@ -0,0 +1,30 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Samsung Galaxy A72 + devicecode: a72q +steps: + unlock_bootloader: + flash_recovery: + - type: call_button + content: > + As a first step, you need to boot into the bootloader. A bootloader is the piece of software, + that tells your phone who to start and run an operating system (like Android). Your device should be turned on. + Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done. + command: adb_reboot_download + - type: call_button + content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue. + command: heimdall_flash_recovery + - type: confirm_button + img: samsung-buttons.png + content: > + Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power* for 8~10 seconds + until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, + hold *Volume Up* + *Power button*. + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Connect your device with your computer with the USB-Cable. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file diff --git a/openandroidinstaller/assets/configs/a7xelte.yaml b/openandroidinstaller/assets/configs/a7xelte.yaml new file mode 100644 index 00000000..6b3e383b --- /dev/null +++ b/openandroidinstaller/assets/configs/a7xelte.yaml @@ -0,0 +1,30 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Samsung Galaxy A7 (2016) + devicecode: a7xelte +steps: + unlock_bootloader: + flash_recovery: + - type: call_button + content: > + As a first step, you need to boot into the bootloader. A bootloader is the piece of software, + that tells your phone who to start and run an operating system (like Android). Your device should be turned on. + Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done. + command: adb_reboot_download + - type: call_button + content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue. + command: heimdall_flash_recovery + - type: confirm_button + img: samsung-buttons.png + content: > + Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds + until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, + hold *Volume Up* + *Home* + *Power button*. + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Connect your device with your computer with the USB-Cable. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file diff --git a/openandroidinstaller/assets/configs/barbet.yaml b/openandroidinstaller/assets/configs/barbet.yaml new file mode 100644 index 00000000..48ef00fd --- /dev/null +++ b/openandroidinstaller/assets/configs/barbet.yaml @@ -0,0 +1,50 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Pixel 5a + devicecode: barbet +steps: + unlock_bootloader: + - type: confirm_button + content: > + As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone + how to start and run an operating system (like Android). Your device should be turned on. + - type: call_button + content: Press 'Confirm and run' to reboot into the bootloader. + command: adb_reboot_bootloader + - type: confirm_button + content: > + Select 'Restart bootloader' on your smartphone screen by pressing the volume button and the confirm by pushing the power button. + Then press 'Confirm and continue' here. + - type: call_button + content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here. + command: fastboot_unlock + - type: confirm_button + content: > + At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader. + Please take whatever actions the device asks you to to proceed. + - type: call_button + content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue. + command: fastboot_reboot + - type: confirm_button + content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable USB debugging to continue. + flash_recovery: + - type: confirm_button + content: > + Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating, + adapting and repairing of the operating system. + - type: call_button + content: Once the device is fully booted, you need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue. + command: adb_reboot_bootloader + - type: confirm_button + content: Select 'Restart bootloader' on your smartphone screen. Then confirm to continue. + - type: call_button + content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue. + command: fastboot_flash_recovery + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Wait until the TWRP screen appears. Then run the command. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file diff --git a/openandroidinstaller/assets/configs/beyond1lte.yaml b/openandroidinstaller/assets/configs/beyond1lte.yaml new file mode 100644 index 00000000..a9d70421 --- /dev/null +++ b/openandroidinstaller/assets/configs/beyond1lte.yaml @@ -0,0 +1,30 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Samsung Galaxy S10 + devicecode: beyond1lte +steps: + unlock_bootloader: + flash_recovery: + - type: call_button + content: > + As a first step, you need to boot into the bootloader. A bootloader is the piece of software, + that tells your phone who to start and run an operating system (like Android). Your device should be turned on. + Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done. + command: adb_reboot_download + - type: call_button + content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue. + command: heimdall_flash_recovery + - type: confirm_button + img: samsung-buttons.png + content: > + Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds + until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, + hold *Volume Up* + *Bixby* + *Power button*. + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Connect your device with your computer with the USB-Cable. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file diff --git a/openandroidinstaller/assets/configs/flame.yaml b/openandroidinstaller/assets/configs/flame.yaml new file mode 100644 index 00000000..faa34707 --- /dev/null +++ b/openandroidinstaller/assets/configs/flame.yaml @@ -0,0 +1,50 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Pixel 4 + devicecode: flame +steps: + unlock_bootloader: + - type: confirm_button + content: > + As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone + how to start and run an operating system (like Android). Your device should be turned on. + - type: call_button + content: Press 'Confirm and run' to reboot into the bootloader. + command: adb_reboot_bootloader + - type: confirm_button + content: > + Select 'Restart bootloader' on your smartphone screen by pressing the volume button and the confirm by pushing the power button. + Then press 'Confirm and continue' here. + - type: call_button + content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here. + command: fastboot_unlock + - type: confirm_button + content: > + At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader. + Please take whatever actions the device asks you to to proceed. + - type: call_button + content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue. + command: fastboot_reboot + - type: confirm_button + content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable USB debugging to continue. + flash_recovery: + - type: confirm_button + content: > + Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating, + adapting and repairing of the operating system. + - type: call_button + content: Once the device is fully booted, you need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue. + command: adb_reboot_bootloader + - type: confirm_button + content: Select 'Restart bootloader' on your smartphone screen. Then confirm to continue. + - type: call_button + content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue. + command: fastboot_flash_recovery + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Wait until the TWRP screen appears. Then run the command. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file diff --git a/openandroidinstaller/assets/configs/j7elte.yaml b/openandroidinstaller/assets/configs/j7elte.yaml new file mode 100644 index 00000000..8d540b0c --- /dev/null +++ b/openandroidinstaller/assets/configs/j7elte.yaml @@ -0,0 +1,30 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Samsung Galaxy J7 (2015) + devicecode: j7elte +steps: + unlock_bootloader: + flash_recovery: + - type: call_button + content: > + As a first step, you need to boot into the bootloader. A bootloader is the piece of software, + that tells your phone who to start and run an operating system (like Android). Your device should be turned on. + Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done. + command: adb_reboot_download + - type: call_button + content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue. + command: heimdall_flash_recovery + - type: confirm_button + img: samsung-buttons.png + content: > + Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds + until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, + hold *Volume Up* + *Home* + *Power button*. + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Connect your device with your computer with the USB-Cable. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file diff --git a/openandroidinstaller/assets/configs/redfin.yaml b/openandroidinstaller/assets/configs/redfin.yaml new file mode 100644 index 00000000..77264bf3 --- /dev/null +++ b/openandroidinstaller/assets/configs/redfin.yaml @@ -0,0 +1,50 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Pixel 5 + devicecode: redfin +steps: + unlock_bootloader: + - type: confirm_button + content: > + As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone + how to start and run an operating system (like Android). Your device should be turned on. + - type: call_button + content: Press 'Confirm and run' to reboot into the bootloader. + command: adb_reboot_bootloader + - type: confirm_button + content: > + Select 'Restart bootloader' on your smartphone screen by pressing the volume button and the confirm by pushing the power button. + Then press 'Confirm and continue' here. + - type: call_button + content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here. + command: fastboot_unlock + - type: confirm_button + content: > + At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader. + Please take whatever actions the device asks you to to proceed. + - type: call_button + content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue. + command: fastboot_reboot + - type: confirm_button + content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable USB debugging to continue. + flash_recovery: + - type: confirm_button + content: > + Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating, + adapting and repairing of the operating system. + - type: call_button + content: Once the device is fully booted, you need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue. + command: adb_reboot_bootloader + - type: confirm_button + content: Select 'Restart bootloader' on your smartphone screen. Then confirm to continue. + - type: call_button + content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue. + command: fastboot_flash_recovery + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Wait until the TWRP screen appears. Then run the command. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file diff --git a/openandroidinstaller/assets/configs/sunfish.yaml b/openandroidinstaller/assets/configs/sunfish.yaml new file mode 100644 index 00000000..d54a8d96 --- /dev/null +++ b/openandroidinstaller/assets/configs/sunfish.yaml @@ -0,0 +1,50 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Pixel 4a + devicecode: sunfish +steps: + unlock_bootloader: + - type: confirm_button + content: > + As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone + how to start and run an operating system (like Android). Your device should be turned on. + - type: call_button + content: Press 'Confirm and run' to reboot into the bootloader. + command: adb_reboot_bootloader + - type: confirm_button + content: > + Select 'Restart bootloader' on your smartphone screen by pressing the volume button and the confirm by pushing the power button. + Then press 'Confirm and continue' here. + - type: call_button + content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here. + command: fastboot_unlock + - type: confirm_button + content: > + At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader. + Please take whatever actions the device asks you to to proceed. + - type: call_button + content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue. + command: fastboot_reboot + - type: confirm_button + content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable USB debugging to continue. + flash_recovery: + - type: confirm_button + content: > + Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating, + adapting and repairing of the operating system. + - type: call_button + content: Once the device is fully booted, you need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue. + command: adb_reboot_bootloader + - type: confirm_button + content: Select 'Restart bootloader' on your smartphone screen. Then confirm to continue. + - type: call_button + content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue. + command: fastboot_flash_recovery + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Wait until the TWRP screen appears. Then run the command. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file diff --git a/openandroidinstaller/assets/configs/z3.yaml b/openandroidinstaller/assets/configs/z3.yaml new file mode 100644 index 00000000..4af08a39 --- /dev/null +++ b/openandroidinstaller/assets/configs/z3.yaml @@ -0,0 +1,48 @@ +metadata: + maintainer: Tobias Sterbak (tsterbak) + devicename: Sony Xperia Z3 + devicecode: z3 +steps: + unlock_bootloader: + - type: confirm_button + content: As a first step, you need to unlock the bootloader of your device. On the device, dial *#*#7378423#*#* (*#*#SERVICE#*#*) to launch the service menu. + - type: confirm_button + content: Go to service info > configuration and check rooting status - you can only continue if it says 'Bootloader unlock allowed":" Yes.' + - type: confirm_button + content: > + Now go to Settings 'About the phone' and then Status. Write down the IMEI of your device. You will need it in the next step. + - type: link_button_with_confirm + content: > + Click on the button to open the instructions on Sonys official unlocking website to generate an unlock code for your bootloader. + Once you got the code write it down somewhere and continue to input the code. + link: https://developer.sonymobile.com/unlockbootloader/unlock-yourboot-loader/ + - type: confirm_button + content: Connect the device to your PC via USB. And confirm to continue. + - type: call_button + content: Press the button to reboot into the bootloader now. When the notification light turns blue, confirm to continue. + command: adb_reboot_bootloader + - type: call_button_with_input + content: > + Use your code to unlock the bootloader of your device. Type in the full 18 character code starting with 0x (Example: 0x3EC4F7AD6E0B32B6). + If you already did that, you can skip this step. + command: fastboot_unlock_with_code + - type: call_button + content: > + Press the button to reboot. Since the device resets completely, you will need to re-enable USB debugging to continue. + Connect your device to your PC via USB. Then confirm here to continue. + command: fastboot_reboot + flash_recovery: + - type: call_button + content: Now you have to reboot into bootloader again. With your phone turned on, press the button to do so and continue once it is done. + command: adb_reboot_bootloader + - type: call_button + content: Next, you need to flash a custom recovery image. Press the button to flash the selected image. Then continue. + command: fastboot_flash_recovery + install_os: + - type: call_button + content: > + In the next steps, you finally flash the selected OS image. + Connect your device with your computer with the USB-Cable. + This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored + in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS. + command: adb_twrp_wipe_and_install \ No newline at end of file