Project Penguin

Open-source, ad-free, forever.

Flamingo OS | Project Penguin

Flamingo OS



Installation

Getting your computer ready

If you're on Windows:

  • Uninstall OnePlus drivers
  • Check for and install all Windows updates
  • Download Google's Platform Tools
  • Extract the Platform Tools .zip and remember where you put it


Getting your phone ready

  • You must first unlock the bootloader (Google this)


Installation

Follow these steps closely:

  1. Download the latest Flamingo OS build (ending in -fastboot.zip) for your device.
  2. Reboot your phone into fastboot/bootloader
  3. Go to your extracted Platform Tools folder and, while holding the Shift key, right-click and then open terminal
  4. In the terminal type:
    • fastboot update
    Then, press the spacebar, drag the .zip file into the terminal, and press enter.
  5. When the script finishes executing, reboot to recovery using this command:
    • fastboot reboot recovery
  6. In recovery, format data. (Note: if you are given the option to choose a file system when formatting, choose F2FS).
  7. Finally, boot into the OS and you are done!


Updating

  • If unrooted, you can easily install incremental updates via the Flamingo Updater app found at Settings > System > Updater
  • If rooted, you will need to install the full ROM file. You can do this by choosing the 'Local Upgrade' option in the 3-dot menu of the Flamingo Updater app.


Report Bugs

Guidelines for Reporting a Bug

The best way to report bugs is by sending a message in the Telegram Channel.

If you want to report a bug:

  1. First explain how to reproduce it.
  2. Then, follow the steps below to provide us log.


How to Generate Logs

Use the following command:
adb logcat -b all -d > logcat.log
And send the file saved "logcat.log" to the Telegram group

Or use inbuilt MatlogX app if you can't use adb right now.
For MatlogX logs will be saved in a matlogx folder under the directory you choose at startup.


How to get Crashdump logs (Windows only)

If you experience a CrashDump, please send us logs by doing the following...

  1. Download and Install QPST:
    https://qpsttool.com/category/download
  2. Ensure proper OP Drivers
    Qualcomm HS_USB
  3. Launch Utility
    • Start > QPST > QPST Configuration
  4. Dump Logs
    • While on CrashDump screen, plug phone into USB
    • Ports tab will display a progress bar and Sahara Memory Dump
  5. Retrive and Upload
    • Click Help > Open Log File Directory
    • Browse to Sahara > Port_COM#
    • Paste contents of KMSG.txt to katb.in
    • Save and send us the URL

Troubleshooting
During CrashDump screen, Device Manager should list device as Qualcomm HS-USB Diagnostics 900E. If it does not, right click > Uninstall Device > Delete the driver software for this device Reboot and install above driver set


Magisk

Installing Magisk for the first time

  1. Download the latest boot.img for your device here.
  2. Patch the downloaded boot.img using the Magisk app (copy it to your device)
  3. Flash on fastboot with fastboot flash boot magisk_patched_xxx.img

Update via OTA and retain Magisk

  • Just OTA as usual and when OTA is done (before rebooting) install from magisk app to inactive slot.

Pass Safetynet

  1. Go Magisk settings > Toggle 'Enable Zygisk'
  2. Reboot
  3. Enable Enforce Denylist.
  4. Now select Configure Denylist.
  5. Toggle show system apps from 3–dot menu.
  6. Search gms and enable com.google.android.gms & com.google.android.gms.unstable
  7. Now, check SafetyNet status using this app
  8. Now select the apps which are not working due to root and clear those apps data if it's still not working.

FAQs

Is there a fix for the blackscreen issue?

Blackscreen issue has been a thing since 12. Here's what happens:
When you unlock with fingerprint, under rare circumstances, the high brightness mode (which gets triggered for the period you press the finger) does not get turned off after unlocking (usually it does). So if you lock your screen at this point then it'll not turn on without a reboot.

There is a workaround:

  • Immediately after you notice that screen is stuck at high brightness, restart systemui instead of locking.
  • Then unlock with fingerprint and it will work as usual.
  • If you did lock, then try unlocking your device with pin or whatever (have to rely on muscle memory since you can't see your input).

No one has been able to reproduce the said issue reliably so don't expect any fixes. Cheers.


How can I see the changelog?

You can view changelogs for each device here.


Can face unlock be added?

No, face unlock will never be a thing unless google implements it.


How can I improve fingerprint performance?

Enrollment can give you various accuracy results, and everyone's experience with fp is therefore different. The workaround is to enroll the same finger multiple times (3-4). Basically keep enrolling the same finger until you literally can't enroll it anymore


Where can I find GCam ports?

You can find lots of different Google Camera ports at GCam Hub.


My system colors are no longer changing based on my wallpaper?

This is easy to fix, just execute the following ADB command in a terminal:
adb shell settings delete secure theme_customization_overlay_packages


How do I get Widevine L1?

Note: you only need to do this once

  1. Flash OOS 11 stable. eg.11.0.5.1
  2. Flash Magisk then enable Zygisk + denylist.(in denylist you should select show system apps in three-dot menu,then search gms, select com.google.android.gms and .gms.unstable)or use Magisk v23.0 for test purpose.
  3. Reboot.
  4. Verify if you have L1 working using app like DRM info.
  5. Local upgrafe OOS 11 stable (preferably same build).
  6. Reboot.
  7. Verify if you have L1 working using app like DRM info.
  8. Flash custom ROM and you should have L1 there as well.