Skip to content

Commit a334957

Browse files
tsterbaktsterbak
authored
Merge branch 'dev' into update-configs-for-additional-partitions
2 parents 53d836b + 3e5f70d commit a334957

File tree

13 files changed

+1274
-1038
lines changed

13 files changed

+1274
-1038
lines changed

‎README.md‎

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -57,12 +57,12 @@ Linux is currently the best supported platform (tested with Ubuntu 20.04/22.04 L
5757
- [MicroG](https://microg.org)
5858
- The recommended way to install MicroG is to use the zip file provided here: [https://github.com/FriendlyNeighborhoodShane/MinMicroG-abuse-CI/releases](https://github.com/FriendlyNeighborhoodShane/MinMicroG-abuse-CI/releases).
5959
- [F-Droid App-Store](https://f-droid.org/en/packages/org.fdroid.fdroid.privileged.ota).
60-
- or you can just search the web or the [xda-developers forum](https://forum.xda-developers.com) for an appropriate version for your device.
60+
- or you can just search the web or the [xda-developers forum](https://xdaforums.com) for an appropriate version for your device.
6161
3. Start the desktop app and follow the instructions.
6262

6363
## Officially supported devices
6464

65-
Currently, the **we support 73 devices** by various vendors and working on adding more soon!
65+
Currently, the **we support 80 devices** by various vendors and working on adding more soon!
6666

6767
Support for these devices is provided as best effort, but things might still go wrong.
6868
Help to improve the tool by reporting any issues you might face.
@@ -72,13 +72,16 @@ Help to improve the tool by reporting any issues you might face.
7272
Vendor | Device Name | CodeName | Models | Status
7373
---|---|---|---|---
7474
Samsung | Galaxy J7 2015 | j7elte | | tested
75+
Samsung | Galaxy J7 Prime | on7xelte | | untested
7576
Samsung | Galaxy A3 2017 | a3y17lte | SM-A320FL | tested
7677
Samsung | Galaxy A5 2016 | [a5xelte](https://wiki.lineageos.org/devices/a5xelte) | SM-A510F | tested
7778
Samsung | Galaxy A5 2017 | [a5y17lte](https://wiki.lineageos.org/devices/a5y17lte) | | tested
7879
Samsung | Galaxy A7 2016 | a7xelte | | tested
80+
Samsung | Galaxy A7 2017 | [a7y17lte](https://wiki.lineageos.org/devices/a7y17lte) | | untested
7981
Samsung | Galaxy Grand Prime VE | grandprimevelte | SM-G531F | tested
8082
Samsung | Galaxy S III Neo | s3ve3g | GT-I9301I | tested
81-
Samsung | Galaxy Tab S2 | [gts210vewifi](https://wiki.lineageos.org/devices/gts210vewifi/) | T813 | tested
83+
Samsung | Galaxy Tab S2 | [gts210vewifi](https://wiki.lineageos.org/devices/gts210vewifi) | T813 | tested
84+
Samsung | Galaxy S4 | [jfltexx](https://wiki.lineageos.org/devices/jfltexx) | | untested
8285
Samsung | Galaxy S4 Mini LTE| [serranoltexx](https://wiki.lineageos.org/devices/serranoltexx) | | tested
8386
Samsung | Galaxy S5 | [klte](https://wiki.lineageos.org/devices/klte) | G900F/M/R4/R7/T/V/W8 | tested
8487
Samsung | Galaxy S6 | [zerofltexx](https://wiki.lineageos.org/devices/zerofltexx) | | tested
@@ -182,13 +185,15 @@ Xiaomi | Redmi Note 7 | [lavender](https://wiki.lineageos.org/devices/lavender)
182185
Xiaomi | Redmi 7A / 8 / 8A / 8A Dual | [Mi439](https://wiki.lineageos.org/devices/Mi439) : pine / olive / olivelite / olivewood | | tested
183186
Xiaomi | Redmi Note 8 / 8T | [ginkgo](https://wiki.lineageos.org/devices/ginkgo) / willow | | untested
184187
Xiaomi | Redmi Note 8 Pro | begonia | | untested
188+
Xiaomi | Mi 8 | [dipper](https://wiki.lineageos.org/devices/dipper) | | untested
185189
Xiaomi | Redmi 9A / 9C / 9AT / 9i / 9A Sport / 10A / 10A Sport | garden / dandelion / blossom / angelican | | tested
186-
Xiaomi | Mi 9T / Redmi K20 | [davinci](https://wiki.lineageos.org/devices/davinci) / davincin | | untested
190+
Xiaomi | Mi 9T / Redmi K20 | [davinci](https://wiki.lineageos.org/devices/davinci) / davinciin | | untested
187191
Xiaomi | Redmi K20 Pro / Mi 9T Pro | raphael / raphaelin | | untested
188192
Xiaomi | Redmi Note 9S / 9 Pro / 9 Pro Max / 10 Lite / Poco M2 pro | [miatoll](https://wiki.lineageos.org/devices/lavender) : gram / curtana / excalibur / joyeuse | | untested
189193
Xiaomi | Redmi Note 10S / 11SE / Poco M5S | [rosemary](https://wiki.lineageos.org/devices/rosemary) / maltose / secret /rosemary_p | | untested
190-
Xiaomi | Redmi K40 / Mi 11X / Poco F3 | [alioth](https://wiki.lineageos.org/devices/alioth) / aliothin | | untested
191-
Xiaomi | Poco X3 Pro | [vayu](https://wiki.lineageos.org/devices/vayu) | | untested
194+
Xiaomi | Redmi K40 / Mi 11X / Poco F3 | [alioth](https://wiki.lineageos.org/devices/alioth) / aliothin | | untested
195+
Xiaomi | Poco X3 / X3 NFC | [surya](https://wiki.lineageos.org/devices/surya) / karna | | untested
196+
Xiaomi | Poco X3 Pro | [vayu](https://wiki.lineageos.org/devices/vayu) | | tested
192197
Xiaomi | 12 | cupid | | untested
193198
</details>
194199

‎docs/unlocking_the_bootloader.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,6 @@ Other phone manufacturers no longer allow you to unlock the bootloader. Nothing
2525
| LG | Fastboot | Impossible since December 2021 | **Yes** | |
2626
| ASUS | Fastboot | Impossible since May 2023 (ASUS unlocking App) | **Yes** | |
2727

28-
**\*** In the EU you won't loose your standard 2 years of the warranty when you unlock your bootloader, flash your device or root it. ([source](https://forum.xda-developers.com/t/info-eu-rooting-and-flashing-dont-void-the-warranty.1998801/))
28+
**\*** In the EU you won't loose your standard 2 years of the warranty when you unlock your bootloader, flash your device or root it. ([source](https://xdaforums.com/t/info-eu-rooting-and-flashing-dont-void-the-warranty.1998801))
2929

3030
You can find more information about the brands and their bootloader policies [here](https://wikilibriste.fr/fr/tutoriels-android/bootloader-unlock) (in French).

‎openandroidinstaller/assets/configs/a5y17lte.yaml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
11
metadata:
22
maintainer: Tobias Sterbak (tsterbak)
33
device_name: Samsung Galaxy A5 (2017)
4-
is_ab_device: false
4+
is_ab_device: false
55
device_code: a5y17lte
66
supported_device_codes:
77
- a5y17lte
88
- a5y17ltecan
9+
- a5y17ltexx
910
steps:
1011
unlock_bootloader:
1112
boot_recovery:
1213
- type: call_button
1314
content: >
14-
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
15-
that tells your phone how to start and run an operating system (like Android). Your device should be turned on.
15+
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
16+
that tells your phone how to start and run an operating system (like Android). Your device should be turned on.
1617
Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
1718
command: adb_reboot_download
1819
- type: call_button
@@ -23,6 +24,6 @@ steps:
2324
- type: confirm_button
2425
img: samsung-buttons.png
2526
content: >
26-
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds
27-
until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
28-
hold *Volume Up* + *Home* + *Power button*.
27+
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds
28+
until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
29+
hold *Volume Up* + *Home* + *Power button*.

‎openandroidinstaller/assets/configs/a7y17lte.yaml‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
metadata:
2+
maintainer: Tobias Sterbak (tsterbak)/SirRGB
3+
device_name: Samsung Galaxy A7 (2017)
4+
is_ab_device: false
5+
device_code: a7y17lte
6+
supported_device_codes:
7+
- a7y17lte
8+
- a7y17ltexx
9+
steps:
10+
unlock_bootloader:
11+
boot_recovery:
12+
- type: call_button
13+
content: >
14+
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
15+
that tells your phone how to start and run an operating system (like Android). Your device should be turned on.
16+
Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
17+
command: adb_reboot_download
18+
- type: call_button
19+
content: >
20+
In this step, you need to flash a custom recovery on your device.
21+
Press 'Confirm and run' to start the process. Confirm afterwards to continue.
22+
command: heimdall_flash_recovery
23+
- type: confirm_button
24+
img: samsung-buttons.png
25+
content: >
26+
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds
27+
until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
28+
hold *Volume Up* + *Home* + *Power button*.

‎openandroidinstaller/assets/configs/dipper.yaml‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
metadata:
2+
maintainer: A non (anon)
3+
brand: xiaomi
4+
device_name: Xiaomi Mi 8
5+
is_ab_device: false
6+
device_code: dipper
7+
supported_device_codes:
8+
- dipper
9+
notes:
10+
- You should install Android 10 or newer ROM.
11+
requirements:
12+
android: 10 (MiUI 12)
13+
untested: true
14+
steps:
15+
unlock_bootloader:
16+
- type: confirm_button
17+
content: >
18+
As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
19+
how to start and run an operating system (like Android). Your device should be turned on. This will reset your phone.
20+
- type: link_button_with_confirm
21+
content: >
22+
- Create a Mi account on Xiaomi’s website. Beware that one account is only allowed to unlock one unique device every 30 days.
23+
24+
- Add a phone number to your Mi account, insert a SIM into your phone.
25+
26+
- Enable developer options in `Settings` > `About Phone` by repeatedly tapping MIUI Version.
27+
28+
- Link the device to your Mi account in `Settings` > `Additional settings` > `Developer options` > `Mi Unlock status`.
29+
30+
- Download the Mi Unlock app with the link bellow (Windows is required to run the app), and follow the instructions provided by the app. It may tell you that you have to wait, usually 7 days. If it does so, please wait the quoted amount of time before continuing to the next step!
31+
32+
- After device and Mi account are successfully verified, the bootloader should be unlocked.
33+
34+
- Since the device resets completely, you will need to re-enable USB debugging to continue : `Settings` > `Additional settings` > `Developer options` > `USB debugging`
35+
link: https://en.miui.com/unlock/download_en.html
36+
boot_recovery:
37+
- type: confirm_button
38+
content: >
39+
Now you need to boot a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
40+
adapting and repairing of the operating system.
41+
- type: call_button
42+
content: >
43+
Once the device is fully booted, you need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
44+
command: adb_reboot_bootloader
45+
- type: call_button
46+
content: >
47+
Install the recovery you chosen before by pressing 'Confirm and run'. Once it's done continue.
48+
command: fastboot_flash_recovery
49+
- type: call_button
50+
img: ofox.png
51+
content: >
52+
Reboot to recovery by pressing 'Confirm and run', and hold the Vol+ button of your phone UNTIL you see the recovery.
53+
If MiUI starts, you have to start the process again, since MiUI delete the recovery you just flashed.
54+
Once it's done continue.
55+
command: fastboot_reboot_recovery

‎openandroidinstaller/assets/configs/jfltexx.yaml‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
metadata:
2+
maintainer: MagicLike
3+
device_name: Samsung Galaxy S4 #(Qualcomm)
4+
is_ab_device: false
5+
device_code: jfltexx
6+
supported_device_codes:
7+
- jfltexx
8+
- jflte
9+
- jfltetmo
10+
twrp-link: jflte
11+
untested: true
12+
requirements:
13+
android: 5.0.1
14+
steps:
15+
unlock_bootloader:
16+
boot_recovery:
17+
- type: call_button
18+
content: >
19+
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
20+
that tells your phone who to start and run an operating system (like Android). Your device should be turned on.
21+
Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
22+
command: adb_reboot_download
23+
- type: call_button
24+
content: >
25+
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.
26+
command: heimdall_flash_recovery
27+
- type: confirm_button
28+
img: samsung-buttons.png
29+
content: >
30+
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds
31+
until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
32+
hold *Volume Up* + *Home* + *Power button*.

‎openandroidinstaller/assets/configs/on7xelte.yaml‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
metadata:
2+
maintainer: MagicLike
3+
device_name: Samsung Galaxy J7 Prime
4+
is_ab_device: false
5+
device_code: on7xelte
6+
supported_device_codes:
7+
- on7xelte
8+
untested: true
9+
steps:
10+
unlock_bootloader:
11+
boot_recovery:
12+
- type: call_button
13+
content: >
14+
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
15+
that tells your phone how to start and run an operating system (like Android). Your device should be turned on.
16+
Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
17+
command: adb_reboot_download
18+
- type: call_button
19+
content: >
20+
In this step, you need to flash a custom recovery on your device.
21+
Press 'Confirm and run' to start the process. Confirm afterwards to continue.
22+
command: heimdall_flash_recovery
23+
- type: confirm_button
24+
img: samsung-buttons.png
25+
content: >
26+
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds
27+
until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
28+
hold *Volume Up* + *Home* + *Power button*.

‎openandroidinstaller/assets/configs/surya.yaml‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
metadata:
2+
maintainer: A non (anon)
3+
brand: poco
4+
device_name: Poco X3 - X3 NFC
5+
is_ab_device: false
6+
device_code: surya
7+
supported_device_codes:
8+
- surya
9+
- karna
10+
untested: true
11+
steps:
12+
unlock_bootloader:
13+
- type: confirm_button
14+
content: >
15+
As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
16+
how to start and run an operating system (like Android). Your device should be turned on. This will reset your phone.
17+
- type: link_button_with_confirm
18+
content: >
19+
- Create a Mi account on Xiaomi’s website. Beware that one account is only allowed to unlock one unique device every 30 days.
20+
21+
- Add a phone number to your Mi account, insert a SIM into your phone.
22+
23+
- Enable developer options in `Settings` > `About Phone` by repeatedly tapping MIUI Version.
24+
25+
- Link the device to your Mi account in `Settings` > `Additional settings` > `Developer options` > `Mi Unlock status`.
26+
27+
- Download the Mi Unlock app with the link bellow (Windows is required to run the app), and follow the instructions provided by the app. It may tell you that you have to wait, usually 7 days. If it does so, please wait the quoted amount of time before continuing to the next step!
28+
29+
- After device and Mi account are successfully verified, the bootloader should be unlocked.
30+
31+
- Since the device resets completely, you will need to re-enable USB debugging to continue : `Settings` > `Additional settings` > `Developer options` > `USB debugging`
32+
link: https://en.miui.com/unlock/download_en.html
33+
boot_recovery:
34+
- type: confirm_button
35+
content: >
36+
Now you need to boot a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
37+
adapting and repairing of the operating system.
38+
- type: call_button
39+
content: >
40+
Once the device is fully booted, you need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
41+
command: adb_reboot_bootloader
42+
- type: call_button
43+
content: >
44+
Install the recovery you chosen before by pressing 'Confirm and run'. Once it's done continue.
45+
command: fastboot_flash_recovery
46+
- type: call_button
47+
img: ofox.png
48+
content: >
49+
Reboot to recovery by pressing 'Confirm and run', and hold the Vol+ button of your phone UNTIL you see the recovery.
50+
If MiUI starts, you have to start the process again, since MiUI delete the recovery you just flashed.
51+
Once it's done continue.
52+
command: fastboot_reboot_recovery

‎openandroidinstaller/views/requirements_view.py‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -214,6 +214,10 @@ def build(self):
214214
self.checkboxes.append(battery_checkbox)
215215
self.checkbox_cards.append(battery_check_card)
216216

217+
boot_stock_checkbox, boot_stock_check_card = self.get_boot_stock_check()
218+
self.checkboxes.append(boot_stock_checkbox)
219+
self.checkbox_cards.append(boot_stock_check_card)
220+
217221
lock_checkbox, lock_check_card = self.get_lock_check()
218222
self.checkboxes.append(lock_checkbox)
219223
self.checkbox_cards.append(lock_check_card)
@@ -251,6 +255,31 @@ def get_battery_check(self):
251255
)
252256
return battery_checkbox, battery_check_card
253257

258+
def get_boot_stock_check(self):
259+
"""Get checkbox and card for default requirements: boot stock once."""
260+
boot_stock_checkbox = Checkbox(
261+
label="Booted the stock OS at least once.",
262+
on_change=self.enable_continue_button,
263+
)
264+
boot_stock_check_card = Card(
265+
Container(
266+
content=Column(
267+
[
268+
Markdown(
269+
"""
270+
#### Boot your device with the stock OS at least once and check every functionality.
271+
Make sure that you can send and receive SMS and place and receive calls (also via WiFi and LTE, if available),
272+
otherwise it won\'t work on your custom ROM either! Additionally, some devices require that VoLTE/VoWiFi be utilized once on stock to provision IMS.
273+
"""
274+
),
275+
boot_stock_checkbox,
276+
]
277+
),
278+
padding=10,
279+
),
280+
)
281+
return boot_stock_checkbox, boot_stock_check_card
282+
254283
def get_lock_check(self):
255284
"""Get the checkbox and card for the default requirement: disable lock code and fingerprint."""
256285
lock_checkbox = Checkbox(

‎openandroidinstaller/views/select_view.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -365,7 +365,7 @@ def toggle_additional_image_selection(self):
365365
366366
## Where do I get these images?
367367
You can download the required images for your device from the [LineageOS downloads page](https://download.lineageos.org/devices/{self.state.config.device_code}/builds).
368-
If this download page does not contain the required images, you can try to find them on the [XDA developers forum](https://forum.xda-developers.com/).
368+
If this download page does not contain the required images, you can try to find them on the [XDA developers forum](https://xdaforums.com).
369369
""",
370370
auto_follow_links=True,
371371
),

0 commit comments

Comments
 (0)