Detailed device guides - thomashastings/droidian-devices GitHub Wiki

Xiaomi Pocophone F1 (beryllium)

Make a backup now, as your device will be wiped.

0. Download the needed files and tools

Droidian rootfs and devtools for arm64 (nightly releases include devtools)
Android 9 (Pie) stock firmware
Vendor image
Latest boot image
Latest TWRP recovery
Droidian adaptation zip (unofficial)

1. Device preparation

A USB 2.0 port/hub with an actual USB 2.0 controller is recommended
- Using fastboot on a USB 3.0 port may cause errors with some Xiaomi devices
Save your APN (Android)
- The Access Point Name or APN can be found in the Settings menu of Android
- Take a piece of paper or a text editor, and write down everything that you see on that screen
- These are likely to include a URL (e. g., internet.carrier.net), a username, and possibly a password
Unlock the bootloader (Computer)
- Refer to the instructions provided by the device manufacturer
- Other useful sources include the LineageOS wiki and xda-developers
Boot into recovery (Computer)
- Boot TWRP by running fastboot boot twrp-VERSION-beryllium.img
Wipe the device (TWRP)
- Go to the Wipe menu
- Select Advanced wipe
- Tick the boxes called Dalvik / ART cache, Cache, System, vendor_image, Data
- Swipe to Wipe
- Go back to the previous menu
- Choose Format data and type yes
- Go back to the main menu and select Reboot
- Choose Bootloader
- Boot TWRP again by running fastboot boot twrp-VERSION-beryllium.img
Copy the files to the device (Computer)
- When TWRP is booted, open the device's Internal storage from your computer
- Copy all of the files you downloaded to this folder

2. Droidian installation (TWRP)

Install the required base Android version (9, 10, 11)
- Install the file called fw_beryllium_miui_POCOF1Global_9.6.27_6673f8a455_9.0.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload fw_beryllium_miui_POCOF1Global_9.6.27_6673f8a455_9.0.zip
Install the vendor_image image
- Install the file called vendor.img as an Image to the Vendor partition
- Alternatively, you can enter fastboot mode and fastboot flash vendor_image vendor.img
Install the vendor_image image
- Install the file called boot.img as an Image to the Boot partition
- Alternatively, you can enter fastboot mode and fastboot flash boot boot.img
Install Recovery
- Install the file called twrp-VERSION-beryllium.img as an Image to the Recovery partition
Install Droidian rootfs
- Install the file named droidian-rootfs-arm64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-rootfs-arm64_YYYYMMDD.zip
Install devtools (for stable release)
- Install the file named droidian-devtools-arm64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-devtools-arm64_YYYYMMDD.zip
- This component is already included in nightly builds
- Installation is optional for stable releases, but it is recommended, because it helps with debugging

3. Finalizing the installation

Install adaptation package as a flashable zip (TWRP)
- Install the file named android-recovery-beryllium-adaptation_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload android-recovery-beryllium-adaptation_YYYYMMDD.zip
Boot your device
- Go to the Reboot menu and choose System
- TWRP might complain that there is no OS installed, but that's fine
- The first boot may take longer, and at least one spontaneous reboot is expected during the process
- You should be greeted with the lock screen, the default password is 1234
Run a specific command after first boot (Droidian)
- Open the King's Cross application or connect via SSH (see the SSH entry in the Notes below), and type in the following:

sudo systemctl enable enable-ipa
sudo systemctl reboot

Congratulations, if everything went well, now you should be running Droidian.

Notes

SIM slot

Dual-SIM mode is not supported as of now. Only the SIM2 slot is active, so a microSD card can be used at the same time.

Extras

For other tweaks, open the King's Cross terminal app, and run beryllium-extras.sh. This includes a notch fix and automated installation of Waydroid.

SSH

Flashing the devtools zip enables SSH over USB. To use it, connect your phone to your computer and type ssh [email protected], the password is 1234 (on Windows, you may need PuTTY)

Applications

You can find a list of mobile-friendly Linux applications at LinuxPhoneApps

Credit

You can ask for assistance specific to this device at Droidian for Poco F1 Telegram Group.

Xiaomi Mi 6X (wayne)

Make a backup now, as your device will be wiped.

0. Download the needed files and tools

Droidian rootfs and devtools for arm64 (nightly releases include devtools)
Android 9 Pie Firmware
Vendor (has arb4 firmware!)
Latest TWRP image
Latest adaptation zip

1. Device preparation

A USB 2.0 port/hub with an actual USB 2.0 controller is recommended
- Using fastboot on a USB 3.0 port may cause errors with some Xiaomi devices
Save your APN (Android)
- The Access Point Name or APN can be found in the Settings menu of Android
- Take a piece of paper or a text editor, and write down everything that you see on that screen
- These are likely to include a URL (e. g., internet.carrier.net), a username, and possibly a password
Unlock the bootloader (Computer)
- Refer to the instructions provided by the device manufacturer
- Other useful sources include the LineageOS wiki and xda-developers
Boot into recovery (Computer)
- Boot TWRP by running fastboot boot twrp-VERSION-wayne.img
Wipe the device (TWRP)
- Go to the Wipe menu
- Select Advanced wipe
- Tick the boxes called Dalvik / ART cache, Cache, System, vendor_image, Data
- Swipe to Wipe
- Go back to the previous menu
- Choose Format data and type yes
- Go back to the main menu and select Reboot
- Choose Bootloader
- Boot TWRP again by running fastboot boot twrp-VERSION-wayne.img
Copy the files to the device (Computer)
- When TWRP is booted, open the device's Internal storage from your computer
- Copy all of the files you downloaded to this folder

2. Droidian installation (TWRP)

Install the required base Android version (9, 10, 11)
- Install the file called jasmine_sprout_stock_android9.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload jasmine_sprout_stock_android9.zip
Install the required vendor_zip version
- Install the file called fw-vendor_image_wayne_miui_MI6X_V11.0.6.0.PDCCNXM_f049df201b_9.0.zip
- Alternatively, you can enter ADB sideload mode and run adb sideload fw-vendor_image_wayne_miui_MI6X_V11.0.6.0.PDCCNXM_f049df201b_9.0.zip
Install Recovery
- Install the file called twrp-VERSION-wayne.img as an Image to the Recovery partition
Install Droidian rootfs
- Install the file named droidian-rootfs-arm64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-rootfs-arm64_YYYYMMDD.zip
Install devtools (for stable release)
- Install the file named droidian-devtools-arm64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-devtools-arm64_YYYYMMDD.zip
- This component is already included in nightly builds
- Installation is optional for stable releases, but it is recommended, because it helps with debugging

3. Finalizing the installation

Install adaptation package as a flashable zip (TWRP)
- Install the file named droidian-adaptation-xiaomi-wayne-arm64_MMMMDDYY.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-adaptation-xiaomi-wayne-arm64_MMMMDDYY.zip
Boot your device
- Go to the Reboot menu and choose System
- TWRP might complain that there is no OS installed, but that's fine
- The first boot may take longer, and at least one spontaneous reboot is expected during the process
- You should be greeted with the lock screen, the default password is 1234

Congratulations, if everything went well, now you should be running Droidian.

Notes

Porting status

You can check out the status of the port here

SSH

Flashing the devtools zip enables SSH over USB. To use it, connect your phone to your computer and type ssh [email protected], the password is 1234 (on Windows, you may need PuTTY)

Applications

You can find a list of mobile-friendly Linux applications at LinuxPhoneApps

Credit

You can ask for assistance specific to this device at Shouko's Lab Telegram Group.

Xiaomi Redmo Note 7 Pro (violet)

Make a backup now, as your device will be wiped.

0. Download the needed files and tools

Droidian rootfs and devtools for arch64 (nightly releases include devtools)
Android 9 Pie Firmware
Android 9 vendor_image
Halium-boot
Latest Orange Fox Recovery

1. Device preparation

A USB 2.0 port/hub with an actual USB 2.0 controller is recommended
- Using fastboot on a USB 3.0 port may cause errors with some Xiaomi devices
Save your APN (Android)
- The Access Point Name or APN can be found in the Settings menu of Android
- Take a piece of paper or a text editor, and write down everything that you see on that screen
- These are likely to include a URL (e. g., internet.carrier.net), a username, and possibly a password
Unlock the bootloader (Computer)
- Refer to the instructions provided by the device manufacturer
- Other useful sources include the LineageOS wiki and xda-developers
Boot into recovery (Computer)
- Boot Orange Fox Recovery by running fastboot boot [email protected]
Wipe the device (Orange Fox Recovery)
- Go to the Wipe menu
- Select Advanced wipe
- Tick the boxes called Dalvik / ART cache, Cache, System, vendor_image, Data
- Swipe to Wipe
- Go back to the previous menu
- Choose Format data and type yes
- Go back to the main menu and select Reboot
- Choose Bootloader
- Boot Orange Fox Recovery again by running fastboot boot [email protected]
Copy the files to the device (Computer)
- When Orange Fox Recovery is booted, open the device's Internal storage from your computer
- Copy all of the files you downloaded to this folder

2. Droidian installation (Orange Fox Recovery)

Install the required base Android version (9, 10, 11)
- Install the file called fw_violet_miui_VIOLET_9.9.3_79d3ccd33b_9.0.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload fw_violet_miui_VIOLET_9.9.3_79d3ccd33b_9.0.zip
Install the required vendor_zip version
- Install the file called https://github.com/ubuntu-touch-violet/ubuntu-touch-violet/releases/tag/20210510
- Alternatively, you can enter ADB sideload mode and run adb sideload https://github.com/ubuntu-touch-violet/ubuntu-touch-violet/releases/tag/20210510
Install the vendor_image image
- Install the file called boot.img as an Image to the Boot partition
- Alternatively, you can enter fastboot mode and fastboot flash boot boot.img
Install Recovery
- Please, follow the official guide to install Orange Fox Recovery
Install Droidian rootfs
- Install the file named droidian-rootfs-arch64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-rootfs-arch64_YYYYMMDD.zip
Install devtools (for stable release)
- Install the file named droidian-devtools-arch64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-devtools-arch64_YYYYMMDD.zip
- This component is already included in nightly builds
- Installation is optional for stable releases, but it is recommended, because it helps with debugging

3. Finalizing the installation

Boot your device
- Go to the Reboot menu and choose System
- Orange Fox Recovery might complain that there is no OS installed, but that's fine
- The first boot may take longer, and at least one spontaneous reboot is expected during the process
- You should be greeted with the lock screen, the default password is 1234
Run a specific command after first boot (Droidian)
- Open the King's Cross application or connect via SSH (see the SSH entry in the Notes below), and type in the following:

sudo -s
DEVICE=violet
cat /var/lib/lxc/android/rootfs/ueventd*.rc /vendor/ueventd*.rc | grep ^/dev | sed -e 's/^\/dev\///' | awk '{printf "ACTION==\"add\", KERNEL==\"%s\", OWNER=\"%s\", GROUP=\"%s\", MODE=\"%s\"\n",$1,$3,$4,$2}' | sed -e 's/\r//' >/etc/udev/rules.d/70-$DEVICE.rules

Congratulations, if everything went well, now you should be running Droidian.

Notes

Adaptation

Follow this guide for device adaptation.

SSH

Flashing the devtools zip enables SSH over USB. To use it, connect your phone to your computer and type ssh [email protected], the password is 1234 (on Windows, you may need PuTTY)

Applications

You can find a list of mobile-friendly Linux applications at LinuxPhoneApps

Credit

Xiaomi Mi A2 (jasmine)

Make a backup now, as your device will be wiped.

0. Download the needed files and tools

Droidian rootfs and devtools for arm64 (nightly releases include devtools)
Android 9 Pie Firmware
Latest TWRP image
Adaptation (unofficial)

1. Device preparation

A USB 2.0 port/hub with an actual USB 2.0 controller is recommended
- Using fastboot on a USB 3.0 port may cause errors with some Xiaomi devices
Save your APN (Android)
- The Access Point Name or APN can be found in the Settings menu of Android
- Take a piece of paper or a text editor, and write down everything that you see on that screen
- These are likely to include a URL (e. g., internet.carrier.net), a username, and possibly a password
Unlock the bootloader (Computer)
- Refer to the instructions provided by the device manufacturer
- Other useful sources include the LineageOS wiki and xda-developers
Boot into recovery (Computer)
- Boot TWRP by running fastboot boot twrp-VERSION-jasmine_sprout.img
Wipe the device (TWRP)
- Go to the Wipe menu
- Select Advanced wipe
- Tick the boxes called Dalvik / ART cache, Cache, System, vendor_image, Data
- Swipe to Wipe
- Go back to the previous menu
- Choose Format data and type yes
- Go back to the main menu and select Reboot
- Choose Bootloader
- Boot TWRP again by running fastboot boot twrp-VERSION-jasmine_sprout.img
Copy the files to the device (Computer)
- When TWRP is booted, open the device's Internal storage from your computer
- Copy all of the files you downloaded to this folder

2. Droidian installation (TWRP)

Install base Android version and/or Vendor to both A/B slots
- Go to the Reboot menu and see which slot is active
- If it says Slot A, then select Slot B to be the active slot, and boot TWRP again
With Slot B as active:
- Install the file called jasmine_sprout_stock_android9.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload jasmine_sprout_stock_android9.zip
Now switch back to Slot A and boot TWRP again (must boot again, switching is not enough)
With Slot A as active:
- Install the file called jasmine_sprout_stock_android9.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload jasmine_sprout_stock_android9.zip
- For the rest of the guide, keep using Slot A
Install Recovery
- Install the file called twrp-VERSION-jasmine_sprout.img as an Image to the Recovery partition
Install Droidian rootfs
- Install the file named droidian-rootfs-arm64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-rootfs-arm64_YYYYMMDD.zip
Install devtools (for stable release)
- Install the file named droidian-devtools-arm64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-devtools-arm64_YYYYMMDD.zip
- This component is already included in nightly builds
- Installation is optional for stable releases, but it is recommended, because it helps with debugging

3. Finalizing the installation

Install adaptation package as a flashable zip (TWRP)
- Install the file named jasmine-adaptation_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload jasmine-adaptation_YYYYMMDD.zip
Boot your device
- Go to the Reboot menu and choose System
- TWRP might complain that there is no OS installed, but that's fine
- The first boot may take longer, and at least one spontaneous reboot is expected during the process
- You should be greeted with the lock screen, the default password is 1234

Congratulations, if everything went well, now you should be running Droidian.

Notes

Porting status

You can check out the status of the port here

SSH

Flashing the devtools zip enables SSH over USB. To use it, connect your phone to your computer and type ssh [email protected], the password is 1234 (on Windows, you may need PuTTY)

Applications

You can find a list of mobile-friendly Linux applications at LinuxPhoneApps

Credit

You can ask for assistance specific to this device at Shouko's Lab Telegram Group.

Asus Zenfone Max Pro M2 (EXPERIMENTAL) (X01BD)

Make a backup now, as your device will be wiped.

0. Download the needed files and tools

Droidian rootfs (specific build required)
Droidian devtools (specific build required)
Android 9 (Pie) stock firmware
vendor_zip 16 (unofficial build)
Latest TWRP recovery
Droidian adaptation zip (unofficial)

1. Device preparation

Save your APN (Android)
- The Access Point Name or APN can be found in the Settings menu of Android
- Take a piece of paper or a text editor, and write down everything that you see on that screen
- These are likely to include a URL (e. g., internet.carrier.net), a username, and possibly a password
Unlock the bootloader (Computer)
- Refer to the instructions provided by the device manufacturer
- Other useful sources include the LineageOS wiki and xda-developers
Boot into recovery (Computer)
- Boot TWRP by running fastboot boot twrp-VERSION-X01BD.img
Wipe the device (TWRP)
- Go to the Wipe menu
- Select Advanced wipe
- Tick the boxes called Dalvik / ART cache, Cache, System, vendor_image, Data
- Swipe to Wipe
- Go back to the previous menu
- Choose Format data and type yes
- Go back to the main menu and select Reboot
- Choose Bootloader
- Boot TWRP again by running fastboot boot twrp-VERSION-X01BD.img
Copy the files to the device (Computer)
- When TWRP is booted, open the device's Internal storage from your computer
- Copy all of the files you downloaded to this folder

2. Droidian installation (TWRP)

Install the required base Android version (9, 10, 11)
- Install the file called UL-ASUS_X01BD-WW-16.2017.1912.072.999-user.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload UL-ASUS_X01BD-WW-16.2017.1912.072.999-user.zip
Install the required vendor_zip version
- Install the file called lineage-16.0-20191119-UNOFFICIAL-X01BD.zip/download
- Alternatively, you can enter ADB sideload mode and run adb sideload lineage-16.0-20191119-UNOFFICIAL-X01BD.zip/download
Install Recovery
- Install the file called twrp-VERSION-X01BD.img as an Image to the Recovery partition
Install Droidian rootfs
- Install the file named droidian-rootfs-arm64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-rootfs-arm64_YYYYMMDD.zip
Install devtools (for stable release)
- Install the file named droidian-devtools-arm64_YYYYMMDD.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload droidian-devtools-arm64_YYYYMMDD.zip
- This component is already included in nightly builds
- Installation is optional for stable releases, but it is recommended, because it helps with debugging

3. Finalizing the installation

Install adaptation package as a flashable zip (TWRP)
- Install the file named x01bd-adaptation_20220508.zip as a Zip file
- Alternatively, you can enter ADB sideload mode and run adb sideload x01bd-adaptation_20220508.zip
Boot your device
- Go to the Reboot menu and choose System
- TWRP might complain that there is no OS installed, but that's fine
- The first boot may take longer, and at least one spontaneous reboot is expected during the process
- You should be greeted with the lock screen, the default password is 1234

Congratulations, if everything went well, now you should be running Droidian.

Notes

Porting status

You can check out the status of the port here

SSH

Flashing the devtools zip enables SSH over USB. To use it, connect your phone to your computer and type ssh [email protected], the password is 1234 (on Windows, you may need PuTTY)

Applications

You can find a list of mobile-friendly Linux applications at LinuxPhoneApps

Credit