Installation Guide for the OnePlus 6

Remarks ∙ Pre-requisites ∙ Backup ∙ Steps ∙ Cleanup ∙ Post Install ∙ Applications

Opening Remarks

Installing WundermentOS is relatively straight forward, however it does have many steps and uses the command line for the majority of the the work. You should read this entire guide at least once before attempting it to ensure you understand all of the steps involved.

If you do not understand the steps or are uncomfortable with them DO NOT PROCEED WITH INSTALLING WUNDERMENTOS.

Installing WundermentOS is at your own risk and while every attempt has been made to create a clear and concise installation guide, there may be slight differences based on software versions and operating systems.

If at any point you are unsure about a step or do not see the expected result, make sure to review the guide again and do not proceed any further until you fully understand the issue.

Unlocking and re-locking the bootloader of your phone can cause you to brick your device and make it unusable, so proceed with caution.

UNLOCKING YOUR BOOTLOADER WILL WIPE ALL DATA FROM YOUR PHONE, MAKE SURE TO BACKUP ALL DATA BEFORE PROCEEDING!

One final note is that once installed WundermentOS does not have any root privileges available. The LineageOS SU addon will not work with WundermentOS, other rooting solutions will likely not work as LineageOS Recovery cannot flash them and does not have ADB available.

The most significant impart of this is that if you are planning on using a backup solution like Titanium Backup, that requires root, it will not work. Make sure you use a non-root backup solution for any data (like SMS, call logs, etc) you wish to migrate to WundermentOS.

Pre-requisites

There are several pre-requisites before starting the installation, they are:

  • a OnePlus 6
  • a desktop computer (Windows/Mac/Linux)
  • a working USB cable to connect your phone to your computer
  • fastboot and adb installed and working on your computer (there are plenty of guides on the web on how to install them
  • an unzip utility
  • a basic understanding of command line tools and your computer
  • a basic understanding of your phone
  • completely read this guide at least once
  • a backup of any data on your phone

Backup Your Data

Just in case you haven’t read the multiple items above that have told you to backup your data, here it is once more:

MAKE SURE TO BACKUP ALL DATA BEFORE PROCEEDING!

Most of your data should be relatively easy to backup and restore, however one exception to this is your SMS/MMS/Call Logs. This is because the majority of backup solutions used in custom ROMs (like Titanium Backup) require root privileges to work.

WUNDERMENT DOES NOT GRANT ANY APPLICATION ROOT PRIVILEGES.

As such, you must use a backup and restore solution that does not require root.

For an example of how to do this, see the Backing up SMS/MMS/Call Logs page.

Video Tutorial

Coming soon!

Steps

Note: this guide is based on Linux commands, for Windows and Mac there may be slight differences.

  1. Login to both your phone and computer.
  2. Connect the USB cable to your phone and computer.
  3. Open a command prompt on your computer.
  4. On your phone, go to Settings->About.
  5. Find the “Build number” box and enable developer options by tapping 7 times on it. A message should appear at the bottom of your screen saying you are a developer now.
  6. Go to Settings->System->Developer options.
  7. Enable “Advanced restart”.
  8. Enable “OEM unlocking” (note this does not unlock your phone, only allows it to be unlocked).
  9. Click “ENABLE” on the displayed warning about unlocking your phone.
  10. Hold the power button for a moment until the power menu appears, then select Reboot->Bootloader which takes you to fastboot mode.

Note: the advanced restart options are only displayed with the screen is unlocked so you will not see them if you haven’t unlocked your screen.

  1. Start to unlock the bootloader by running the following command on your computer :
fastboot oem unlock

The output from the command should be (times in the output may very based on your phone/computer):

...
OKAY [  0.045s]
finished. total time: 0.046s
  1. On your phone, the bootloader unlock screen should appear, select “UNLOCK THE BOOTLOADER” with volume keys and then press power to unlock the bootloader.
  2. The phone will reboot and you will see the bootloader unlocked message, which will disappear after a few seconds (your you can press the power button twice to clear it).
  3. The phone will wipe your user data, aka do a factory reset and then reboot once more.
  4. Once OxygenOS has loaded, skip through the OnePlus setup wizard (no need to set anything as this will be factory reset again shortly).
  5. Download the lastest WundermentOS recovery image for enchilada in to a working directory and unzip it (we will use this temporarily to install WundermentOS).
  6. Download the WundermentOS pkmd key and unzip it.
  7. Download the latest WundermentOS release zip in to the same working directory and open a command prompt, changing to the working directory.
  1. Reboot your phone to fastboot again via Power->Reboot->Bootloader.
  2. From your computer install the LineageOS recovery:
fastboot flash boot WundermentOS-18.1-20210508-recovery-enchilada.img
  1. Once complete, disconnect your phone from the USB cable (this is only a precaution as in some circumstances your phone may automatically restart if it detects a USB cable connected) and select “Power off” from the fastboot menu.
  2. Once the phone is powered of, hold down the volume down button as well as the power button to restart in to recovery.
  3. You may now plug your USB cable back in.
  4. The phone will now start LineageOS recovery.
  5. Select “Factory reset” from the LineageOS recovery menu (touch screen works here).
  6. Select “Wipe data / factory reset” from the “Factory reset” menu.
  7. Select “Yes” and wait for completion.
  8. Select “Apply update”.
  9. Select “Apply from ADB”.
  10. From your computer run:
adb sideload WundermentOS-latest-enchilada.zip
  1. Once complete, select “Reboot” from the main menu.
  2. Your phone will restart in to LineageOS after the bootloader unlock screen is displayed.
  3. Skip through the LineageOS setup wizard (no need to set anything as this will be factory reset again shortly).
  4. Go to Settings->About and enable developer options by tapping 7 times on the “Build number” box.
  5. Enable “Advanced restart”.
  6. Reboot in to fastboot again via Power->Reboot->Bootloader.
  7. From your computer, flash the AVB keys and reboot back in to fastboot mode:
fastboot flash avb_custom_key WundermentOS-pkmd.bin
fastboot reboot bootloader
  1. Start to re-lock your bootloader by running the following command on your computer:
fastboot oem lock

The output from the command should be (times in the output may very based on your phone/computer):

...
OKAY [  0.035s]
finished. total time: 0.035s
  1. On your phone select “LOCK THE BOOTLOADER” with volume keys and then press power.
  2. Your phone will restart to linage recovery and perform a factory reset.
  3. Your phone will restart to LineageOS.
  4. If you are going to do the optional cleanup below, skip through the LineageOS setup wizard (no need to set anything as this will be factory reset again later). Otherwise complete the setup wizard to your preferences now.
  5. Go to Settings->About and enable developer options by tapping 7 times on the “Build number” box.
  6. Go to Settings->System->Advanced->Developer options.
  7. Disable the “OEM unlocking” toggle.

Congratulations, you have successfully install WundermentOS and re-locked your bootloader!

Note that when you restart your phone, you will still see a warning message that you are running a custom OS, but this is expected and of no concern.

Final Cleanup (optional)

If you want a super clean install without the developer options enabled, do the following to complete one last factory reset.

  1. On your phone enable the “Advanced restart” toggle in Settings->System->Advanced->Developer options.
  2. Reboot in to LineageOS recovery via Power->Reboot->Recovery.
  3. Select “Factory reset”.
  4. Select “Wipe data / factory reset”.
  5. Select “Yes” and wait for completion
  6. Go back to main menu with the arrow in top left corner of screen.
  7. Select “Reboot”.
  8. After LineageOS boots, complete the setup wizard to your preferences.

Finished!

Post Installation Steps (Optional)

There are a few items you may which to do after installation is complete:

  • Change the location of the on screen volume panel (osvp). By default LineageOS places the osvp on the right side of the phone for right handed users. However the actual volume controls for the OnePlus 6T are on the left hand side. To change the osvp to the left, go to Settings->System->Buttons->Show panel on left.
  • LineageOS’s dailer by default does forward/people/reverse lookup for calls. You can disables these or change the lookup providers by going to Phone->Three dot menu in search bar->Settings->Phone number lookup.
  • Add additional repositories to F-Droid. You may find some additional repositories useful, you can find a list of them here. To add one to F-Droid, open F-Droid and select the “Settings” page, then select “Repositories”. In the upper right or the screen is a “+” symbol, select it and then enter the URL for the repository you want to add. After adding them you must refresh the repositories by swiping down from the top of any of the main F-Droid pages.
  • Configure SeedVault. SeedVault allows you to backup your phones applications and data and then restore it if your phone is factory reset. You can use either a local storage option (like an USB thumb drive) or a Nextcloud instance if you have it (note Nextcloud cannot be used to restore but the backups stored on it can be transferred to a USB thumb drive for restoration). You can go to Settings->System->Advanced->Backup to complete the setup.
  • Configure UnfiedNlp. You can download location providers from F-Droid and configure them through the UnfiedNlp app on your phone.

Application Suggestions (Optional)

WundermentOS comes with several applications by default, including a browser, mail client, music player and others. You may find these useful or you may find them limiting based on your personal preference. If you are looking for some additional applications to use, perhaps these are a few you may want to look at (in no particular order, all from F-Droid):

  • Fennec F-Droid: A fork of FireFox for Android without any of the proprietary code in it. Fennec can use FireFox plugins like Ghostery, Auto Cookie Delete and others to make your mobile browsing experience ever better!
  • K-9 Mail: A powerful e-mail client.
  • AnySoftKeyboard: A highly customizable keyboard for Android.
  • Vinyl: A modern music player.
  • Slide: A Reddit client.
  • andOTP: Two factor authentication application.
  • Aurora Store: An alternative way to access the Google Play store without any Google services.
  • BirthDayDroid: Birthday reminders based on your contacts.
  • DAVx5: Contacts and Calendar sync client for WebDav/CardDav servers (like Nextcloud).
  • Simple Gallery Pro: A simple but powerful gallery app.
  • KDE Connect: Connect your phone to your Linux based computer, including notifications and sending/reading SMS.
  • Open Camera: A camera application with lots of options.
  • OsmAnd~: Open Street Maps client for mapping and directions.
  • QKSMS: A replacement SMS client with features like themeing and search built in.
  • WebApps: Create sandboxed applications from any website.

Privacy Policy