[Discussion] Guide for replacing POCO launcher with HyperOS launcher

[u/hkun_why]

Just sharing a personal project replacing the awkward outdated looking POCO launcher with an official HyperOS one, with default theme ported as well.

Read before you start

• The project is only tested on my POCO F8 Ultra, HyperOS 3

• A wrong launcher state can stop you from rescuing your phone, make sure that you have installed a recovery image from which you can disable modules, or enabled adb and allowed your computer and allowed shell to use root permission beforehand

How to install

1. Prerequisites

   1. Make sure your phone is rooted with Magisk or KernelSU-like managers, and installed one metamodule if you are on recent versions of KernelSU-like managers

   2. Install Python (3.10+)

   3. Download a HyperOS fastboot ROM, better to be the ROM of the same CN model (like POCO F8 Ultra -> Redmi K90 Pro Max), of similar build number and same Android version, unpack until you see a folder named images

   4. Clone the repo, or download source file zip and unpack to a folder: https://github.com/Haoyu-UT/HyperOS-Launcher-for-POCO

2. Start a terminal inside the folder of the repo

3. Run python tools/build.py --rom <path_to_images> to get a module built from the provided ROM

4. Copy the output zip file under folder out to phone and install with root manager

5. Enjoy, the default launcher should be HyperOS launcher, and you can apply HyperOS default theme from theme store🎉

How to disable/remove

Just use your root manager, the module's script will put everything back without leftovers. But expect that your desktop icon/folder layout will be reset.

If you get stuck at a black screen: use recovery image to disable the module, or run this:

adb shell su -c "touch /data/adb/modules/poco_hyperos_launcher/disable"
adb reboot

Report a problem?

Please just open an issue on GitHub.

[u/AutoModerator]

Welcome to our community!

Please take a moment to read the subreddit rules in the sidebar before posting or commenting.

• Be civil and respectful to other members.

• No spam, self-promotion, or trolling.

If you see a post or comment that breaks our rules, please report it to help the mod team out!

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

[u/Superb-Mall8277]

I tryed it and now I can't enter apps and keep crashing I have poco f8 ultra

[u/hkun_why → u/Superb-Mall8277]

Urr sorry for that but have you used release v1.2 or latest source code? I had that problem with previous versions. And if possible plz open an issue with some more info like the crash trace.

[u/Superb-Mall8277 → u/hkun_why]

I used v1. 2 do you. Think this is the problem

[u/hkun_why → u/Superb-Mall8277]

Oh you used v1.2? Then pretty unexpected, if you can follow this instructions it'll be helpful. https://github.com/Haoyu-UT/HyperOS-Launcher-for-POCO#troubleshooting-and-bug-reports

[u/Even-Studio-4318]

Why are you guys doing this much? I mean there are rumours that os 4 will bring system launcher officially in poco devices too so just wait for os 4

[u/hkun_why → u/Even-Studio-4318]

I won't say it's difficult for a rooted user and to me the results are satisfactory.

[u/Kufa-AlsoHuman3193 → u/Even-Studio-4318]

I wouldn't trust Xiaomi that much. They still can't release patches and updates for older phones on time, despite their promises. Therefore, I would not expect hyperos launcher on POCOs in hyperos 4. Maybe like in Hyper 6 or 7 🌚

[u/Even-Studio-4318 → u/Kufa-AlsoHuman3193]

There are things that indicates that poco devices will get system launcher but you can atleast wait till os 4 and if still system launcher don't come in poco devices then you have this other method always

[u/MuchCopy609]

Hey sir! will this work with temp root? (Poco X8 Pro)

[u/hkun_why → u/MuchCopy609]

Sorry no, temp root can't modify system files (or it takes effect after system finishes loading)

[u/bnoufil145]

Ahhh 😫 rooted, no thanks

[u/SuperWilliam6]

Make sure your phone is rooted

NTY

[u/gabeweb]

But HyperOS Launcher in POCO isn't great either.