What do I need to know about ChaoMe Theme Editor?
ChaoMe Theme Editor opens a theme or a downloaded .mtz file, lets you edit it and builds a new .mtz theme for MIUI and HyperOS phones. Editing and exporting work without Shizuku; installing on Android 11 and newer needs Shizuku or root.
Last updated
Applying and installing themes
Why does my theme reset to the default after a while, and how do I keep it applied?
The phone may go back to its default theme after a while, usually within a few hours. Xiaomi resets themes it did not sell. The app cannot make a theme stay permanently.
Your edits stay in the .mtz file, so apply the theme again. A wallpaper set with Set Wallpaper stays even when the rest of the theme is reset.
On recent HyperOS versions, Xiaomi's Themes app may refuse an edited theme. You can still try single parts under Customize theme in the Themes app.
How do I install a theme from an .mtz file?
To open a file, tap Browse on the start screen and pick the .mtz file, or open it from another app with Open with. A file that is cut off is reported as incomplete: download it again.
After you export, the app offers to install the theme. On Android 10 and older it installs directly. From Android 11, installing needs the Shizuku app or root. On Android 13 and later, Shizuku started in ADB (wireless debugging) mode cannot install themes; Shizuku started with root can.
Without installing, the .mtz file is still saved in your output folder. Apply it in the Themes app.
Can I use a HyperOS theme on a MIUI phone?
Yes, by converting it. In the Theme library, choose Convert for another system version (Pro). The result lists what changed and what is not shown on that system version. Nothing is removed, and the original theme is unchanged.
What does the "theme rules not met" message mean when applying?
ChaoMe's Theme check checks a theme against the official theme rules and lists each finding as Error, Warning or Store rule, with the screen that fixes it. For example, a theme without description.xml is not accepted by the Themes app. Theme check is advice only and never blocks an export.
Open it from its tile in the editor, or from the button after a theme is saved. When it finds nothing, it shows No problems found.
Editing
Why are my edits not in the exported theme file?
- In Settings, Status bar and Control Center set to System's own leaves the theme's status bar, notification and Control Center parts out of the export, together with your edits to them.
- Parts made for another system version may not show on your phone.
- Some editors exist only on certain system versions.
- After a Xiaomi reset the phone shows the default theme again, but the .mtz file keeps your edits.
Can I keep some parts of the phone default (for example launcher art) while using a theme?
Yes. Rows you leave alone keep the theme's own value. When you remove a piece of art, the phone's default shows instead. Reset Edits undoes the surfaces you pick. Hide Elements switches off parts of the system UI, and unchecking one restores it.
In the Themes app, to change one part only, pick the plain entry under Customize theme.
Can I change the icon shape for icon packs?
Yes. After Import whole Icon Pack, set Shape of icon-pack icons: Circle, Squircle, Rounded square, Square or Teardrop. Original keeps the icons as they are. The shape applies only to apps that have no icon in the theme.
Can I change the fingerprint icon on the lock screen?
Yes. The Fingerprint tile has Fingerprint Icon and Unlock Animation. Pick a GIF or a picture and an effect, such as Pulse, Spin or Glow. The tile is shown on newer system versions.
This works only with an in-screen sensor. Phones with the sensor on the side or the back do not draw a fingerprint icon on the lock screen.
Phones, files and Pro
Does the app work on MIUI 14 and HyperOS?
Yes. Themes can be built for MIUI 9.4 or earlier, MIUI 9.5 to 11, MIUI 12, 12.5, 13 and 14, and HyperOS 1, 2 and 3. Choose yours under Settings → Phone system version. The app runs on Android 7.0 and newer.
Where are my themes saved?
Exported .mtz files go to MIUI/theme on your phone, or to a folder you choose on the export screen. Every theme you build is also kept in the Theme library inside the app. Uninstalling the app or clearing its data deletes the library, so back it up to a zip file from the library first.
What does PRO add, and why does the free version need the internet?
The free version is supported by ads and needs a connection while it is open. PRO is a one-time purchase that removes every ad, lets you use the app offline and opens the advanced tools: the advanced editors, lock screen options, the new lock screen builder, always-on display and power menu, MAML code, and combining and converting themes in the library. Every other editor stays free.
Are my themes uploaded?
No. Your themes are built on your phone and are never uploaded.
Can I import a theme backup or a theme I bought?
Your own theme backups (.bak) can be imported, and importing them is free. Bought or licensed themes are refused.
About ChaoMe
Is ChaoMe made by Xiaomi?
No. ChaoMe Theme Editor is an independent tool for creating theme files. It is not affiliated with, endorsed by or sponsored by Xiaomi.
How long has ChaoMe been on Google Play, and how many people use it?
Since June 2017. ChaoMe Theme Editor has more than 5,000,000 downloads on Google Play.