Skip to content

Commit

Permalink
New devices for release 0.3.2 (#49)
Browse files Browse the repository at this point in the history
This PR adds:
- fix for #48 

Support for new devices:
- Fairphone 4
- Samsung Galaxy Note 3 LTE (#46)
- Google Pixel 4 XL
- Google Pixel 3a XL (#38)
- Google Pixel 3 XL
- Google Pixel 3
- Google Pixel 2 XL
- Google Pixel 2
  • Loading branch information
tsterbak authored Jan 3, 2023
2 parents 2b952b0 + 1d70cff commit f3f7603
Show file tree
Hide file tree
Showing 12 changed files with 486 additions and 5 deletions.
63 changes: 59 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,16 +40,29 @@ Linux is currently the best supported platform (tested with Ubuntu 20.04 LTS). W

1. Download the AppImage, .exe or appropriate executable file for your OS. You might need to change permissions to run the executable.
- On Windows also [install the Universal USB Drivers](https://adb.clockworkmod.com/) and other potentially drivers needed for your device.
2. Download the custom ROM image and the TWRP recovery image for your device. A source for files can be found on
2. Download the custom ROM image and the TWRP recovery image for your device. A source for files can be found on the following websites:
- some custom ROMs:
- [LineageOS](https://wiki.lineageos.org/devices/)
- [TWRP recovery](https://twrp.me/Devices/)
- [/e/OS](https://doc.e.foundation/devices)
- [LineageOS for microg](https://download.lineage.microg.org/)
- or you can just search the web for an appropriate version for your device.
- [BlissRoms](https://blissroms.org/)
- [PixelExperience](https://download.pixelexperience.org/)
- TWRP Recovery:
- [TWRP recovery](https://twrp.me/Devices/)
- or you can just search the web or the [xda-developers forum](https://forum.xda-developers.com) for an appropriate version for your device.
3. Start the desktop app and follow the instructions.


## Officially supported devices

Currently, the **we support 41 devices** by various vendors and working on adding more soon!


Support for these devices is provided as best effort, but things might still go wrong.
Help to improve the tool by reporting any issues you might face.

<details><summary><b>Samsung</b></summary>

Vendor | Device Name | CodeName | Models | Status
---|---|---|---|---
Samsung | Galaxy J7 2015 | j7elte | | tested
Expand All @@ -61,11 +74,30 @@ Samsung | Galaxy S9 | [starlte](https://wiki.lineageos.org/devices/starlte/) | |
Samsung | Galaxy Note 9 | [crownlte](https://wiki.lineageos.org/devices/crownlte/) | | tested
Samsung | Galaxy S10 | [beyond1lte](https://wiki.lineageos.org/devices/beyond1lte/) | | tested
Samsung | Galaxy Note 10 | [d1](https://wiki.lineageos.org/devices/d1/) | | tested
Samsung | Galaxy Note 3 LTE | [hltetmo](https://wiki.lineageos.org/devices/hltetmo/) | N900T/V/W8 | tested
</details>

<details><summary><b>Google</b></summary>

Vendor | Device Name | CodeName | Models | Status
---|---|---|---|---
Google | Pixel 2 | [walleye](https://wiki.lineageos.org/devices/walleye/) | walleye | tested
Google | Pixel 2 XL | [taimen](https://wiki.lineageos.org/devices/taimen/) | taimen | tested
Google | Pixel 3 | [blueline](https://wiki.lineageos.org/devices/blueline/) | blueline | tested
Google | Pixel 3 XL | [crosshatch](https://wiki.lineageos.org/devices/crosshatch/) | crosshatch | tested
Google | Pixel 3a | [sargo](https://wiki.lineageos.org/devices/sargo/) | sargo | tested
Google | Pixel 3a XL | [bonito](https://wiki.lineageos.org/devices/bonito/) | bonito | tested
Google | Pixel 4 | [flame](https://wiki.lineageos.org/devices/flame/) | flame | tested
Google | Pixel 4 XL | [coral](https://wiki.lineageos.org/devices/coral/) | coral | tested
Google | Pixel 4a | [sunfish](https://wiki.lineageos.org/devices/sunfish/) | sunfish | tested
Google | Pixel 5 | [redfin](https://wiki.lineageos.org/devices/redfin/) | redfin | tested
Google | Pixel 5a | [barbet](https://wiki.lineageos.org/devices/barbet/) | barbet | tested
</details>

<details><summary><b>Sony</b></summary>

Vendor | Device Name | CodeName | Models | Status
---|---|---|---|---
Sony | Xperia Z | [yuga](https://wiki.lineageos.org/devices/yuga/) | C6603 | tested
Sony | Xperia Z3 | [z3](https://wiki.lineageos.org/devices/z3/) | | tested
Sony | Xperia 10 | [kirin](https://wiki.lineageos.org/devices/kirin/) | | tested
Expand All @@ -74,18 +106,41 @@ Sony | Xperia XA2 | [pioneer](https://wiki.lineageos.org/devices/pioneer/) | | t
Sony | Xperia XZ2 | [akari](https://wiki.lineageos.org/devices/akari/) | | tested
Sony | Xperia XZ3 | [akatsuki](https://wiki.lineageos.org/devices/akatsuki/) | | tested
Sony | Xperia ZX | kagura | | planned
</details>

<details><summary><b>Fairphone</b></summary>

Vendor | Device Name | CodeName | Models | Status
---|---|---|---|---
Fairphone | Fairphone 2 | [FP2](https://wiki.lineageos.org/devices/FP2/) | | tested
Fairphone | Fairphone 3 | [FP3](https://wiki.lineageos.org/devices/FP3/) | | tested
Fairphone | Fairphone 4 | [FP4](https://wiki.lineageos.org/devices/FP4/) | | tested
</details>

<details><summary><b>Motorola</b></summary>

Vendor | Device Name | CodeName | Models | Status
---|---|---|---|---
Motorola | moto G5 | [cedric](https://wiki.lineageos.org/devices/cedric/) | | tested
Motorola | moto g7 power | [ocean](https://wiki.lineageos.org/devices/ocean/) | | tested
Motorola | moto G7 power | [ocean](https://wiki.lineageos.org/devices/ocean/) | | tested
</details>

<details><summary><b>OnePlus</b></summary>

Vendor | Device Name | CodeName | Models | Status
---|---|---|---|---
OnePlus | 6 | [enchilada](https://wiki.lineageos.org/devices/enchilada/) | | tested
OnePlus | 6T | [fajita](https://wiki.lineageos.org/devices/fajita/) | | tested
OnePlus | 7 | [guacamoleb](https://wiki.lineageos.org/devices/guacamoleb/) | | tested
OnePlus | 7 Pro | [guacamole](https://wiki.lineageos.org/devices/guacamole/) | | tested
OnePlus | 7T | [hotdogb](https://wiki.lineageos.org/devices/hotdogb/) | | tested
OnePlus | 7T Pro | [hotdog](https://wiki.lineageos.org/devices/hotdog/) | | tested
OnePlus | Nord | [avicii](https://wiki.lineageos.org/devices/avicii/) | | tested
OnePlus | Nord N200 | [dre](https://wiki.lineageos.org/devices/dre/) | | tested
OnePlus | 9 | lemonade | | under development
</details>

And more to come!


## Run OpenAndroidInstaller for development
Expand Down
54 changes: 54 additions & 0 deletions openandroidinstaller/assets/configs/FP4.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
metadata:
maintainer: Tobias Sterbak (tsterbak)
devicename: Fairphone 4
devicecode: FP4
steps:
unlock_bootloader:
- type: link_button_with_confirm
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.
Click on the button to open the instructions on the Fairphone Support official unlocking website to generate an unlock code for your device.
Once you've done that, continue.
link: https://support.fairphone.com/hc/en-us/articles/4405858258961-FP4-Manage-the-bootloader
- 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: >
Follow the instructions on the Fairphone screen. This command will wipe all the personal data on your phone.
- 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: Turn on your device. 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: call_button
content: Once the device is in fastboot mode, flash the custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
command: fastboot_flash_recovery
- type: confirm_button
content: >
Now reboot into recovery to verify the installation. Do not reboot into the existing OS, since it will overwrite the recovery you just installed!
With the device powered off, hold 'Volume Up + Power'. Release when boot logo appears.
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. This might take a while. At the end your phone will boot into the new OS.
command: adb_twrp_wipe_and_install
53 changes: 53 additions & 0 deletions openandroidinstaller/assets/configs/avicii.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
metadata:
maintainer: Tobias Sterbak (tsterbak)
devicename: OnePlus Nord
devicecode: avicii
requirements:
android: 10
steps:
unlock_bootloader:
- type: call_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.
Press 'Confirm and run' to reboot into the bootloader.
command: adb_reboot_bootloader
- 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_oem_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 Developer Options and USB debugging to continue.
flash_recovery:
- type: call_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.
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
command: adb_reboot_bootloader
- type: call_button
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
command: fastboot_flash_recovery
- type: call_button
command: adb_twrp_copy_partitions
content: >
In some cases, the inactive slot can be unpopulated or contain much older firmware than the active slot, leading to various issues including a potential hard-brick.
We can ensure none of that will happen by copying the contents of the active slot to the inactive slot. Press 'confirm and run' to to this. Once you are in the bootloader again, continue.
- type: call_button
command: fastboot_flash_recovery
content: >
Now we need to boot into recovery again. Press run and when you see the TWRP screen you can continue.
install_os:
- type: call_button
content: >
In this last step, 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
45 changes: 45 additions & 0 deletions openandroidinstaller/assets/configs/blueline.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
metadata:
maintainer: Tobias Sterbak (tsterbak)
devicename: Google Pixel 3
devicecode: blueline
requirements:
android: 12
steps:
unlock_bootloader:
- type: call_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.
Press 'Confirm and run' to reboot into the bootloader.
command: adb_reboot_bootloader
- 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 Developer Options and USB debugging to continue.
flash_recovery:
- type: call_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.
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
command: adb_reboot_bootloader
- type: call_button
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once your phone screen looks like the picture on the left, continue.
command: fastboot_flash_recovery
img: twrp-start.jpeg
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
45 changes: 45 additions & 0 deletions openandroidinstaller/assets/configs/bonito.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
metadata:
maintainer: Tobias Sterbak (tsterbak)
devicename: Google Pixel 3a XL
devicecode: bonito
requirements:
android: 12.1.0
steps:
unlock_bootloader:
- type: call_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.
Press 'Confirm and run' to reboot into the bootloader.
command: adb_reboot_bootloader
- 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 Developer Options and USB debugging to continue.
flash_recovery:
- type: call_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.
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
command: adb_reboot_bootloader
- type: call_button
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once your phone screen looks like the picture on the left, continue.
command: fastboot_flash_recovery
img: twrp-start.jpeg
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
Loading

0 comments on commit f3f7603

Please sign in to comment.