Skip to content

Commit f3f7603

Browse files
authored
New devices for release 0.3.2 (#49)
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
2 parents 2b952b0 + 1d70cff commit f3f7603

12 files changed

Lines changed: 486 additions & 5 deletions

File tree

README.md

Lines changed: 59 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,16 +40,29 @@ Linux is currently the best supported platform (tested with Ubuntu 20.04 LTS). W
4040

4141
1. Download the AppImage, .exe or appropriate executable file for your OS. You might need to change permissions to run the executable.
4242
- On Windows also [install the Universal USB Drivers](https://adb.clockworkmod.com/) and other potentially drivers needed for your device.
43-
2. Download the custom ROM image and the TWRP recovery image for your device. A source for files can be found on
43+
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:
44+
- some custom ROMs:
4445
- [LineageOS](https://wiki.lineageos.org/devices/)
45-
- [TWRP recovery](https://twrp.me/Devices/)
4646
- [/e/OS](https://doc.e.foundation/devices)
4747
- [LineageOS for microg](https://download.lineage.microg.org/)
48-
- or you can just search the web for an appropriate version for your device.
48+
- [BlissRoms](https://blissroms.org/)
49+
- [PixelExperience](https://download.pixelexperience.org/)
50+
- TWRP Recovery:
51+
- [TWRP recovery](https://twrp.me/Devices/)
52+
- or you can just search the web or the [xda-developers forum](https://forum.xda-developers.com) for an appropriate version for your device.
4953
3. Start the desktop app and follow the instructions.
5054

5155

5256
## Officially supported devices
57+
58+
Currently, the **we support 41 devices** by various vendors and working on adding more soon!
59+
60+
61+
Support for these devices is provided as best effort, but things might still go wrong.
62+
Help to improve the tool by reporting any issues you might face.
63+
64+
<details><summary><b>Samsung</b></summary>
65+
5366
Vendor | Device Name | CodeName | Models | Status
5467
---|---|---|---|---
5568
Samsung | Galaxy J7 2015 | j7elte | | tested
@@ -61,11 +74,30 @@ Samsung | Galaxy S9 | [starlte](https://wiki.lineageos.org/devices/starlte/) | |
6174
Samsung | Galaxy Note 9 | [crownlte](https://wiki.lineageos.org/devices/crownlte/) | | tested
6275
Samsung | Galaxy S10 | [beyond1lte](https://wiki.lineageos.org/devices/beyond1lte/) | | tested
6376
Samsung | Galaxy Note 10 | [d1](https://wiki.lineageos.org/devices/d1/) | | tested
77+
Samsung | Galaxy Note 3 LTE | [hltetmo](https://wiki.lineageos.org/devices/hltetmo/) | N900T/V/W8 | tested
78+
</details>
79+
80+
<details><summary><b>Google</b></summary>
81+
82+
Vendor | Device Name | CodeName | Models | Status
83+
---|---|---|---|---
84+
Google | Pixel 2 | [walleye](https://wiki.lineageos.org/devices/walleye/) | walleye | tested
85+
Google | Pixel 2 XL | [taimen](https://wiki.lineageos.org/devices/taimen/) | taimen | tested
86+
Google | Pixel 3 | [blueline](https://wiki.lineageos.org/devices/blueline/) | blueline | tested
87+
Google | Pixel 3 XL | [crosshatch](https://wiki.lineageos.org/devices/crosshatch/) | crosshatch | tested
6488
Google | Pixel 3a | [sargo](https://wiki.lineageos.org/devices/sargo/) | sargo | tested
89+
Google | Pixel 3a XL | [bonito](https://wiki.lineageos.org/devices/bonito/) | bonito | tested
6590
Google | Pixel 4 | [flame](https://wiki.lineageos.org/devices/flame/) | flame | tested
91+
Google | Pixel 4 XL | [coral](https://wiki.lineageos.org/devices/coral/) | coral | tested
6692
Google | Pixel 4a | [sunfish](https://wiki.lineageos.org/devices/sunfish/) | sunfish | tested
6793
Google | Pixel 5 | [redfin](https://wiki.lineageos.org/devices/redfin/) | redfin | tested
6894
Google | Pixel 5a | [barbet](https://wiki.lineageos.org/devices/barbet/) | barbet | tested
95+
</details>
96+
97+
<details><summary><b>Sony</b></summary>
98+
99+
Vendor | Device Name | CodeName | Models | Status
100+
---|---|---|---|---
69101
Sony | Xperia Z | [yuga](https://wiki.lineageos.org/devices/yuga/) | C6603 | tested
70102
Sony | Xperia Z3 | [z3](https://wiki.lineageos.org/devices/z3/) | | tested
71103
Sony | Xperia 10 | [kirin](https://wiki.lineageos.org/devices/kirin/) | | tested
@@ -74,18 +106,41 @@ Sony | Xperia XA2 | [pioneer](https://wiki.lineageos.org/devices/pioneer/) | | t
74106
Sony | Xperia XZ2 | [akari](https://wiki.lineageos.org/devices/akari/) | | tested
75107
Sony | Xperia XZ3 | [akatsuki](https://wiki.lineageos.org/devices/akatsuki/) | | tested
76108
Sony | Xperia ZX | kagura | | planned
109+
</details>
110+
111+
<details><summary><b>Fairphone</b></summary>
112+
113+
Vendor | Device Name | CodeName | Models | Status
114+
---|---|---|---|---
77115
Fairphone | Fairphone 2 | [FP2](https://wiki.lineageos.org/devices/FP2/) | | tested
78116
Fairphone | Fairphone 3 | [FP3](https://wiki.lineageos.org/devices/FP3/) | | tested
117+
Fairphone | Fairphone 4 | [FP4](https://wiki.lineageos.org/devices/FP4/) | | tested
118+
</details>
119+
120+
<details><summary><b>Motorola</b></summary>
121+
122+
Vendor | Device Name | CodeName | Models | Status
123+
---|---|---|---|---
79124
Motorola | moto G5 | [cedric](https://wiki.lineageos.org/devices/cedric/) | | tested
80-
Motorola | moto g7 power | [ocean](https://wiki.lineageos.org/devices/ocean/) | | tested
125+
Motorola | moto G7 power | [ocean](https://wiki.lineageos.org/devices/ocean/) | | tested
126+
</details>
127+
128+
<details><summary><b>OnePlus</b></summary>
129+
130+
Vendor | Device Name | CodeName | Models | Status
131+
---|---|---|---|---
81132
OnePlus | 6 | [enchilada](https://wiki.lineageos.org/devices/enchilada/) | | tested
82133
OnePlus | 6T | [fajita](https://wiki.lineageos.org/devices/fajita/) | | tested
83134
OnePlus | 7 | [guacamoleb](https://wiki.lineageos.org/devices/guacamoleb/) | | tested
84135
OnePlus | 7 Pro | [guacamole](https://wiki.lineageos.org/devices/guacamole/) | | tested
85136
OnePlus | 7T | [hotdogb](https://wiki.lineageos.org/devices/hotdogb/) | | tested
86137
OnePlus | 7T Pro | [hotdog](https://wiki.lineageos.org/devices/hotdog/) | | tested
138+
OnePlus | Nord | [avicii](https://wiki.lineageos.org/devices/avicii/) | | tested
87139
OnePlus | Nord N200 | [dre](https://wiki.lineageos.org/devices/dre/) | | tested
88140
OnePlus | 9 | lemonade | | under development
141+
</details>
142+
143+
And more to come!
89144

90145

91146
## Run OpenAndroidInstaller for development
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
metadata:
2+
maintainer: Tobias Sterbak (tsterbak)
3+
devicename: Fairphone 4
4+
devicecode: FP4
5+
steps:
6+
unlock_bootloader:
7+
- type: link_button_with_confirm
8+
content: >
9+
As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
10+
how to start and run an operating system (like Android). Your device should be turned on.
11+
Click on the button to open the instructions on the Fairphone Support official unlocking website to generate an unlock code for your device.
12+
Once you've done that, continue.
13+
link: https://support.fairphone.com/hc/en-us/articles/4405858258961-FP4-Manage-the-bootloader
14+
- type: call_button
15+
content: Press 'Confirm and run' to reboot into the bootloader.
16+
command: adb_reboot_bootloader
17+
- type: confirm_button
18+
content: >
19+
Select 'Restart bootloader' on your smartphone screen by pressing the volume button and the confirm by pushing the power button.
20+
Then press 'Confirm and continue' here.
21+
- type: call_button
22+
content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here.
23+
command: fastboot_unlock
24+
- type: confirm_button
25+
content: >
26+
Follow the instructions on the Fairphone screen. This command will wipe all the personal data on your phone.
27+
- type: call_button
28+
content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue.
29+
command: fastboot_reboot
30+
- type: confirm_button
31+
content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable USB debugging to continue.
32+
flash_recovery:
33+
- type: confirm_button
34+
content: >
35+
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
36+
adapting and repairing of the operating system.
37+
- type: call_button
38+
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.
39+
command: adb_reboot_bootloader
40+
- type: call_button
41+
content: Once the device is in fastboot mode, flash the custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
42+
command: fastboot_flash_recovery
43+
- type: confirm_button
44+
content: >
45+
Now reboot into recovery to verify the installation. Do not reboot into the existing OS, since it will overwrite the recovery you just installed!
46+
With the device powered off, hold 'Volume Up + Power'. Release when boot logo appears.
47+
install_os:
48+
- type: call_button
49+
content: >
50+
In the next steps, you finally flash the selected OS image.
51+
Wait until the TWRP screen appears. Then run the command.
52+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
53+
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.
54+
command: adb_twrp_wipe_and_install
Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
metadata:
2+
maintainer: Tobias Sterbak (tsterbak)
3+
devicename: OnePlus Nord
4+
devicecode: avicii
5+
requirements:
6+
android: 10
7+
steps:
8+
unlock_bootloader:
9+
- type: call_button
10+
content: >
11+
As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
12+
how to start and run an operating system (like Android). Your device should be turned on.
13+
Press 'Confirm and run' to reboot into the bootloader.
14+
command: adb_reboot_bootloader
15+
- type: call_button
16+
content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here.
17+
command: fastboot_oem_unlock
18+
- type: confirm_button
19+
content: >
20+
At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader.
21+
Please take whatever actions the device asks you to to proceed.
22+
- type: call_button
23+
content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue.
24+
command: fastboot_reboot
25+
- type: confirm_button
26+
content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
27+
flash_recovery:
28+
- type: call_button
29+
content: >
30+
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
31+
adapting and repairing of the operating system.
32+
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
33+
command: adb_reboot_bootloader
34+
- type: call_button
35+
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
36+
command: fastboot_flash_recovery
37+
- type: call_button
38+
command: adb_twrp_copy_partitions
39+
content: >
40+
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.
41+
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.
42+
- type: call_button
43+
command: fastboot_flash_recovery
44+
content: >
45+
Now we need to boot into recovery again. Press run and when you see the TWRP screen you can continue.
46+
install_os:
47+
- type: call_button
48+
content: >
49+
In this last step, you finally flash the selected OS image.
50+
Wait until the TWRP screen appears. Then run the command.
51+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
52+
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.
53+
command: adb_twrp_wipe_and_install
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
metadata:
2+
maintainer: Tobias Sterbak (tsterbak)
3+
devicename: Google Pixel 3
4+
devicecode: blueline
5+
requirements:
6+
android: 12
7+
steps:
8+
unlock_bootloader:
9+
- type: call_button
10+
content: >
11+
As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
12+
how to start and run an operating system (like Android). Your device should be turned on.
13+
Press 'Confirm and run' to reboot into the bootloader.
14+
command: adb_reboot_bootloader
15+
- type: call_button
16+
content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here.
17+
command: fastboot_unlock
18+
- type: confirm_button
19+
content: >
20+
At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader.
21+
Please take whatever actions the device asks you to to proceed.
22+
- type: call_button
23+
content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue.
24+
command: fastboot_reboot
25+
- type: confirm_button
26+
content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
27+
flash_recovery:
28+
- type: call_button
29+
content: >
30+
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
31+
adapting and repairing of the operating system.
32+
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
33+
command: adb_reboot_bootloader
34+
- type: call_button
35+
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once your phone screen looks like the picture on the left, continue.
36+
command: fastboot_flash_recovery
37+
img: twrp-start.jpeg
38+
install_os:
39+
- type: call_button
40+
content: >
41+
In the next steps, you finally flash the selected OS image.
42+
Wait until the TWRP screen appears. Then run the command.
43+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
44+
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.
45+
command: adb_twrp_wipe_and_install
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
metadata:
2+
maintainer: Tobias Sterbak (tsterbak)
3+
devicename: Google Pixel 3a XL
4+
devicecode: bonito
5+
requirements:
6+
android: 12.1.0
7+
steps:
8+
unlock_bootloader:
9+
- type: call_button
10+
content: >
11+
As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
12+
how to start and run an operating system (like Android). Your device should be turned on.
13+
Press 'Confirm and run' to reboot into the bootloader.
14+
command: adb_reboot_bootloader
15+
- type: call_button
16+
content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here.
17+
command: fastboot_unlock
18+
- type: confirm_button
19+
content: >
20+
At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader.
21+
Please take whatever actions the device asks you to to proceed.
22+
- type: call_button
23+
content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue.
24+
command: fastboot_reboot
25+
- type: confirm_button
26+
content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
27+
flash_recovery:
28+
- type: call_button
29+
content: >
30+
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
31+
adapting and repairing of the operating system.
32+
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
33+
command: adb_reboot_bootloader
34+
- type: call_button
35+
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once your phone screen looks like the picture on the left, continue.
36+
command: fastboot_flash_recovery
37+
img: twrp-start.jpeg
38+
install_os:
39+
- type: call_button
40+
content: >
41+
In the next steps, you finally flash the selected OS image.
42+
Wait until the TWRP screen appears. Then run the command.
43+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
44+
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.
45+
command: adb_twrp_wipe_and_install

0 commit comments

Comments
 (0)