Install PixelExperience on guacamole

keyboard_arrow_left Back to the overview

Basic requirements

  1. Make sure your computer has adb and fastboot. Setup instructions can be found here.
  2. Enable USB debugging on your device.

Unlocking the bootloader

  1. Enable OEM unlock in the Developer options under device Settings, if present.

  2. Connect the device to your PC via USB.
  3. On the computer, open a command prompt (on Windows) or terminal (on Linux or macOS) window, and type:
    adb reboot bootloader
    

    You can also boot into fastboot mode via a key combination:

    • With the device powered off, hold Volume Up + Volume Down + Power.
  4. Once the device is in fastboot mode, verify your PC finds it by typing:
    fastboot devices
    
  5. Now type the following command to unlock the bootloader:

    fastboot oem unlock
    
  6. If the device doesn’t automatically reboot, reboot it. It should now be unlocked.
  7. Since the device resets completely, you will need to re-enable USB debugging to continue.

Temporarily booting a custom recovery using fastboot

  1. Download the PixelExperience Recovery. Simply download the latest recovery file.

  2. Connect your device to your PC via USB.
  3. On the computer, open a command prompt (on Windows) or terminal (on Linux or macOS) window, and type:
    adb reboot bootloader
    

    You can also boot into fastboot mode via a key combination:

    • With the device powered off, hold Volume Up + Volume Down + Power.
  4. Once the device is in fastboot mode, verify your PC finds it by typing:
    fastboot devices
    
  5. Temporarily flash a recovery on your device by typing:
    fastboot flash boot <recovery_filename>.img
    

Pre-install instructions

In some cases slot b can be unpopulated or contain much older firmware than slot a, leading to various issues including a potential hard-brick. We can ensure none of that will happen by copying the contents of slot a to slot b. This step is NOT optional.

To do this, sideload the copy-partitions-20210323_1922.zip package by doing the following:

  1. Download the copy-partitions-20210323_1922.zip file from here.
  2. Sideload the copy-partitions-20210323_1922.zip package:
    • On the device, select “Apply Update”, then “Apply from ADB” to begin sideload.
    • On the host machine, sideload the package using: adb sideload copy-partitions-20210323_1922.zip
  3. Now reboot to recovery by tapping “Advanced”, then “Reboot to recovery”.

Installing PixelExperience from recovery

  1. Download the PixelExperience installation package that you would like to install or build the package yourself.
  2. If you are not in recovery, reboot into recovery:
    • With the device powered off, hold Volume Down + Power.
  3. Now tap Factory Reset, then Format data / factory reset and continue with the formatting process. This will remove encryption and delete all files stored in the internal storage, as well as format your cache partition (if you have one).
  4. Return to the main menu.
  5. Sideload the PixelExperience .zip package:
    • On the device, select “Apply Update”, then “Apply from ADB” to begin sideload.
    • On the host machine, sideload the package using: adb sideload filename.zip.
  6. Once you have installed everything successfully, click the back arrow in the top left of the screen, then “Reboot system now”.

Post-install instructions

In some devices flashing a custom avb key to avb_custom_key is supported. Doing this will allow you to lock your bootloader. This step is OPTIONAL.

  1. Make sure your device is in bootloader/fastboot mode.
  2. Download the PixelExperience avb_custom_key Image from Here
  3. Flash the ‘.img’ file via fastboot:
    • On the device, be in bootloader/fastboot mode.
    • From the host machine, flash the image using: fastboot flash avb_custom_key avb_custom_key.img
  4. Now you can lock your bootloader using: fastboot oem lock

Get assistance

If you have any questions or get stuck on any of the steps, feel free to ask on our Telegram group.