You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This release adds:
Support for new devices:
* Motorola moto z (griffin) (thanks to @SirRGB)
* OnePlus 5 (cheeseburger) (thanks to @SirRGB)
* OnePlus 5T (dumpling) (thanks to @SirRGB)
* Samsung Galaxy S III Neo (s3ve3g)
@@ -176,6 +180,20 @@ If you want to use the tool for a non-supported smartphone, the fastest way is t
176
180
177
181
#### Content of a config file
178
182
183
+
A config file consists of two parts. The first part are some metadata about the device and the second parts are the steps to unlock the bootloader, flash a recovery and install the ROMs.
184
+
185
+
##### How to write Metadata
186
+
Every config file should have metadata with the following fields:
187
+
-`maintainer`: str; Maintainer and author of the config file.
188
+
-`devicename`: str; Name of the device.
189
+
-`devicecode`: str; The official device code.
190
+
-`twrp-link`: [OPTIONAL] str; name of the corresponding twrp page.
191
+
192
+
In addition to these metadata, every config can have optional requirements. If these are set, the user is asked to check if they are meet.
193
+
-`android`: [OPTIONAL] int|str; Android version to install prior to installing a custom ROM.
194
+
-`firmware`: [OPTIONAL] str; specific firmware version to install before installing a custom ROM.
195
+
196
+
##### How to write steps:
179
197
Every step in the config file corresponds to one view in the application. These steps should contain the following fields:
180
198
-`type`: str; Corresponds to the type of view to generate. There are the following options:
181
199
-`text`: Just display the text given in content.
@@ -218,7 +236,7 @@ Other phone vendors stops allowing to unlock the bootloader all together. There
218
236
219
237
220
238
## License
221
-
Original development by [Tobias Sterbak](https://tobiassterbak.com). Copyright (C) 2022.
239
+
Original development by [Tobias Sterbak](https://tobiassterbak.com). Copyright (C) 2022-2023.
222
240
223
241
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
11
+
how to start and run an operating system (like Android). Your device should be turned on.
12
+
Press 'Confirm and run' to reboot into the bootloader.
13
+
command: adb_reboot_bootloader
14
+
- type: call_button
15
+
content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here.
16
+
command: fastboot_oem_unlock
17
+
- type: confirm_button
18
+
content: >
19
+
At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader.
20
+
Please take whatever actions the device asks you to to proceed.
21
+
- type: call_button
22
+
content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue.
23
+
command: fastboot_reboot
24
+
- type: confirm_button
25
+
content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
26
+
flash_recovery:
27
+
- type: call_button
28
+
content: >
29
+
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
30
+
adapting and repairing of the operating system.
31
+
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
32
+
command: adb_reboot_bootloader
33
+
- type: call_button
34
+
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
35
+
command: fastboot_flash_recovery
36
+
install_os:
37
+
- type: call_button
38
+
content: >
39
+
In the next steps, you finally flash the selected OS image.
40
+
Wait until the TWRP screen appears. Then run the command.
41
+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
42
+
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.
As a first step, you need to unlock the bootloader. A bootloader is the piece of software, that tells your phone
11
+
how to start and run an operating system (like Android). Your device should be turned on.
12
+
Press 'Confirm and run' to reboot into the bootloader.
13
+
command: adb_reboot_bootloader
14
+
- type: call_button
15
+
content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here.
16
+
command: fastboot_oem_unlock
17
+
- type: confirm_button
18
+
content: >
19
+
At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader.
20
+
Please take whatever actions the device asks you to to proceed.
21
+
- type: call_button
22
+
content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue.
23
+
command: fastboot_reboot
24
+
- type: confirm_button
25
+
content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable Developer Options and USB debugging to continue.
26
+
flash_recovery:
27
+
- type: call_button
28
+
content: >
29
+
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
30
+
adapting and repairing of the operating system.
31
+
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
32
+
command: adb_reboot_bootloader
33
+
- type: call_button
34
+
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
35
+
command: fastboot_flash_recovery
36
+
install_os:
37
+
- type: call_button
38
+
content: >
39
+
In the next steps, you finally flash the selected OS image.
40
+
Wait until the TWRP screen appears. Then run the command.
41
+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
42
+
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.
As a first step, you need to unlock the bootloader of your device. A bootloader is the piece of software, that tells your phone
11
+
how to start and run an operating system (like Android). You need to boot into fastboot mode by pressing the 'Confirm and run' button. Then continue.
12
+
- type: call_button
13
+
command: fastboot_get_unlock_data
14
+
content: >
15
+
Now you need to get your device ID to get an unlock code from Motorola. Press 'Confirm and run' to get the ID. (You need to toggle 'Advanced Output' here to see it.)
16
+
Copy it to a separate file to use it in the next step.
17
+
- type: link_button_with_confirm
18
+
content: >
19
+
Click on the button to open the instructions on Motorola's official unlocking website to generate an unlock code for your bootloader.
20
+
Copy the code from the last step to the website and follow the instructions there. Then continue here.
content: Connect the device to your PC via USB. And confirm to continue.
24
+
- type: call_button_with_input
25
+
content: >
26
+
Use your code to unlock the bootloader of your device. Type in the full 21 character code you received by email (Example: 5RTSQCYL7ZJKL4NN35MY). Then confirm an run. Afterwards you can continue.
27
+
command: fastboot_unlock_with_code
28
+
- type: call_button_with_input
29
+
content: >
30
+
You need to perform the last command again, so reenter the code and run again. Afterwards you can continue.
31
+
command: fastboot_unlock_with_code
32
+
- type: call_button
33
+
content: >
34
+
Press the button to reboot. Since the device resets completely, you will need to re-enable USB debugging to continue.
35
+
Connect your device to your PC via USB. Then confirm here to continue.
36
+
command: fastboot_reboot
37
+
flash_recovery:
38
+
- type: call_button
39
+
content: >
40
+
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
41
+
adapting and repairing of the operating system.
42
+
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
43
+
command: adb_reboot_bootloader
44
+
- type: call_button
45
+
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
46
+
command: fastboot_flash_recovery
47
+
install_os:
48
+
- type: call_button
49
+
content: >
50
+
In this last step, 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. Confirm to run. This might take a while. At the end your phone will boot into the new OS.
There are two possible hardware configurations of this phone regardless of model number. Some phones were released with a Sony IMX 175 rear camera sensor, while others with a Samsung s5k4h5yb rear camera sensor. As such, we’ve separated this devices builds into two separate builds. The procedure to distinguish which to use is as follows:
11
+
12
+
- Make sure to be on the latest stock firmware of your variant (you can check updates with Settings, Updates);
13
+
14
+
- Make sure the rear camera is working on the stock ROM;
15
+
16
+
- Open the phone app and dial *#*#34971539#*#* to access to the hidden menu;
17
+
- Tap on ‘Phone/Cam FW Check’ and take note of the numbers shown in the notification:
18
+
- For E08QT, install the s3ve3gjv builds
19
+
- For B08QT, install the s3ve3gxx builds
20
+
I you are not sure what you used, you can safely restart here and pick the correct image and recovery.
21
+
- type: call_button
22
+
content: >
23
+
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
24
+
that tells your phone who to start and run an operating system (like Android). Your device should be turned on.
25
+
Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
26
+
command: adb_reboot_download
27
+
- type: call_button
28
+
content: >
29
+
In this step, you need to flash a custom recovery on your device.
30
+
Press 'Confirm and run' to start the process. Confirm afterwards to continue.
31
+
command: heimdall_flash_recovery
32
+
- type: confirm_button
33
+
img: samsung-buttons.png
34
+
content: >
35
+
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for
36
+
8~10 seconds until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
37
+
hold *Volume Up* + *Home* + *Power*. Confirm when the recovery screen appears.
38
+
install_os:
39
+
- type: call_button
40
+
content: >
41
+
In the next steps, you finally flash the selected OS image.
42
+
Connect your device with your computer with the USB-Cable.
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.
0 commit comments