Quick Start
We are providing custom ROMs for you to quickly enjoy the benefit brought by PowerPhone.
INFO
This page serves as a general introduction about the process. You should follow the model-specific instructions on the navigation bar whenever possible.
1. Supported Smartphones
Make sure you have one of the following smartphones:
Brand | Model | Codename |
---|---|---|
Motorola | Edge (2020) | racer |
Xiaomi | Redmi Note 9 Pro | joyeuse |
Samsung | Galaxy S9+ (Snapdragon version) | star2qltechn |
Samsung | Galaxy S10 (Exynos version) | beyond1lte |
(Results shown in the paper are mostly done using racer.)
If you don't have above-mentioned smartphones, please check Smartphones Model Info to see if you can access smartphones that are similar to above-mentioned and are possible compatible to our published system images.
Or you can reconfigure a smartphone from scratch.
WARNING
Check Smartphones Model Info carefully before purchasing a smartphones. Depends on the country / region, the same smartphone may be advertised as a completely different model name, and the same model name may represent a different smartphone.
2. Tooling
You will need to install Android SDK Platform-Tools to access the command-line utilities we're going to use such as adb
and fastboot
. After downloading, unzip it to your desired location, and add it to your environment variable $PATH
.
Samsung does not implement fastboot, therefore you will need Odin (Windows GUI) or Heimdall suite(Multi-platform CLI)
3. Unlock Bootloader
On factory-setting, the bootloader of the Android smartphones is locked, meaning it can only flash signed images from the manufacturer. We need to unlock it before applying our systems. In general, by Googleing "PHONE_MODEL unlock bootloader" should lead you to tutorials of this producers. Helpful links:
Note that bootloader locks are different from the carrier locks, though normally you will need to unlock carrier locks before unlocking bootloader.
WARNING
You will lost all data after unlocking. A smartphone with a unlocked bootloader is extremely vulnerable. Never do this on your personal daily-used smartphone.
INFO
Samsung officials do not support unlocking Qualcomm Snapdragon devices sold in North America region. The only way to unlock such devices is exploiting security vulnerabilities or buying unlocking services from grey market. Samsung smartphones with Snapdragon SoC sold in Asia should be generally fine.
4. Flash Custom Custom Recovery Image
- Download custom recovery image from our Release.
- Reboot smartphone to bootloader mode by running
adb reboot bootloader
. - Flash custom recovery by
fastboot flash recovery xxxxx.img
. For Samsung smartphones, you'll need Odin to do so. - Reboot to recovery through
fastboot reboot recovery
. For Samsung smartphones, reboot to recovery through volume keys.
WARNING
If operate incorrectly, this step may brick your smartphone.
5. Flash Our System Image
- Download our system image (.zip) from our Release.
- Reboot into custom recovery through
fastboot reboot recovery
if you are in bootloader mode, or throughadb reboot recovery
if you are in the Android system. - In the custom recovery, find and enter "ADB Sideload" mode.
- On the computer, run
adb sideload xxxx.zip
to install our Android distribution.
6. Play & Record Audios
- Run
adb root
to get root privilege. - Run
adb shell
to enter the shell of the smartphone. - Create a playground working directory for yourself
mkdir /data/tmp/
. - Explore scripts in our repo.
- Copy corresponding script to your working directory.
- Use our scripts to play and / or record audio from/to files.
- You can use
adb pull
andadb push
commands to fetch / send files to the smartphone.