Want to make your Xiaomi stand out among millions of other smartphones? Creating a custom theme is the best way to give the device a unique style that will reflect your personality. Unlike standard themes from MIUI Themer, a custom theme allows you to control every element of the interface, from app icons to screen lock animations. But how to turn an idea into a working.mtz file that can be installed on the Redmi Note 12, POCO X5 or Mi 13?
In this guide, weβll take you through the entire process, from design preparation to final installation, without having to go into programming, learn what tools youβll need to work with graphics, how to structure theme files correctly, and why some elements may not appear on new versions of MIUI 14/15. And if youβve never done design before, donβt worry: weβll tell you where to download the pre-made templates and how to adapt them to your needs.
1. What you need to create a Xiaomi theme: tools and requirements
Before you start designing, make sure you have everything you need. The minimum requirements are simple, but the success of the project depends on their implementation:
- π± Xiaomi smartphone based on MIUI 12β15 (older versions may not support new themes).
- π» Computer with Windows/macOS/Linux for working with graphic editors.
- π¨ Design Programs: Adobe Photoshop, GIMP (Free, Figma or Inkscape (for vector icons).
- π Theme templates (can be downloaded from forums) XDA Developers or MIUI Themes).
- π§ MIUI Theme Editor (Official Tool for Packaging Themes).
Pay special attention to your deviceβs screen resolution. For example, the Xiaomi 13 Pro with a resolution of 3200Γ1440 will require high-resolution wallpaper and interface elements, while the Redmi 10A (1600Γ720) will suit less detailed images. If you ignore this rule, the theme will look blurry or cropped on some devices.
2. Step-by-step instruction: creating a theme design
Start with a visual concept. Decide which style you want to embody: minimalism, neon cyberpunk, retro pixel, or something else. For inspiration, explore popular themes at MIUI Themer or at sites like ThemeForest. Here are the key elements to work through:
- πΌοΈ Wallpaper: home screen, lock screen (give the location of the time and notification widget).
- π± Icons: There must be at least 150 unique icons for major apps (including Google Play, Mi Browser, Settings, etc).
- π¨ Color palette: colors for notification panels, background elements, text.
- β‘ Animations (optional): transitions between screens, effects when unlocking.
For icons, we recommend using the format PNG transparently 192Γ192 If you're not an artist, use icon generators like IconKit or Flaticon, where you can download free sets. Don't forget scalability: icons should look good on the screen. POCO F5 s AMOLED-screen and budget Redmi A2 s IPS.
Created wallpaper for home screen and lock |
Icons for 150+ apps are ready |
The color scheme is defined (HEX-code)|
Compatibility with the resolution of your Xiaomi|
Backup copies of all files are saved-->
3. Structure of the theme folders and files: what must be
The theme for Xiaomi is an archive with a rigid folder structure, and if you skip one mandatory element, the theme won't load into MIUI Themer.
YourThemeName/
βββ description.xml #Metadata topics (title, author, version)
βββ preview.png # Theme preview (size 1080Γ1920)
βββ wallpaper/ # Wallpaper
β βββ lockscreen.jpg # Lock screen
β βββ homescreen.jpg # Home screen
βββ icon/ # Icons (Permission folders)
β βββ 192x192/
β βββ 256x256/
βββ style/ # CSS- Styles for the interface
β βββ colors.xml # Color scheme
βββ animation/ # Animations (if any)description.xml β The most important file. It's the one that says:
- Theme name (<name>MyAwesomeTheme</name>)
- Version (<version>1.0</version>)
- Author (<author>YourName</author>)
- Supported permissions (<resolution>1080x2400</resolution>)
If you're not sure if the structure is right, download any free theme from MIUI Themer, rename it.zip, and explore the content, which will help you avoid packaging errors.
Example description.xml for the topic
4. Packing theme in.mtz: how to avoid mistakes
When all files are ready, they need to be packaged in.mtz, the only format MIUI Themer recognizes.
- Download MIUI Theme Editor (the official tool from Xiaomi) or use alternatives like MTZ Theme Maker.
- Import the theme folder into the program.
- Check the preview for errors (missing icons, stretched wallpaper).
- Export to.mtz.
Frequent errors in packaging:
- π« Wrong paths to files (for example, icon/192x192/com.android.settings.png instead icon/com.android.settings.png).
- π« Non-compliance with permits (both wallpapers for FHD+ device-wise HD+).
- π« No required icons (e.g. for System) UI phone).
π‘
If the theme does not apply, check the description.xml file for typos in the tags. Even an extra space can cause an error.
5. Install theme on Xiaomi: 3 working methods
The finished.mtz file can be installed in several ways. Choose the one that is suitable for your version of MIUI:
| Method | Requirements | Pluses | Cons |
|---|---|---|---|
| Through MIUI Themer. | MIUI 12+ with unlocked bootloader | Official method, supports updates | You need to register with Xiaomi Account |
| Local installation | File Manager (e.g., Mi File Explorer) | Quick, doesn't require the internet | It may not work on new versions of MIUI. |
| Through ADB | PC, enabled debugging over USB | It works on any firmware. | Hard for beginners. |
The easiest way is to install locally:
- Copy the.mtz file to the MIUI/theme/ folder on your phone.
- Open Topics β Local β Select your file.
- Apply the theme and restart the device.
If the topic does not apply, check:
- πΉ Compatibility with your version MIUI (indicated description.xml).
- πΉ All required files (especially preview.png).
- πΉ Permissions to install topics from unknown sources (Settings) β Additionally. β Installation of unknown applications).
π‘
Local installation only works on devices with an unlocked bootloader. If you have a Redmi with a locked bootloader, use the official MIUI Themer.
6 Problem Solving: Why the topic doesn't work
Even if you followed the instructions, the theme may not apply or not display correctly. Here are the typical problems and their solutions:
β οΈ Warning: If the phone starts to brake or overheat after applying the theme, it means that the animations or wallpaper are too high resolution.
| Problem. | Possible cause | Decision |
|---|---|---|
| Theme is not displayed in MIUI Themer | Incorrect description.xml or folder structure | Check the file for validity through XML Validator |
| Icons don't change. | There are no icons for system applications | Add icons for com.android.settings, com.miui.home, etc. |
| Wallpaper stretched or trimmed | Discrepancy of screen resolution | Re-design the wallpaper to your device's permission |
| The topic applies, but it lays | Too heavy animations or wallpaper in 4K | Optimize your files (use TinyPNG to compress) |
If the problem is not solved, try:
- Delete the app cache Themes (Settings β Applications β Application Management β Themes β Clear the cache).
- Repackage theme with a different name (sometimes changing the <name> to description.xml helps).
- Install the theme through ADB (if the local method doesnβt work):
adb push YourTheme.mtz /sdcard/MIUI/theme/
adb shell am broadcast -a miui.intent.action.CHANGE_THEME --ez extra_theme_auto_apply true -n com.android.themes/.receiver.ThemeChangeReceiver7.Publishing a topic: how to share your creation
If you want your theme to be seen by other Xiaomi users, post it on specialized sites:
- π Official MIUI Themer: requires developer registration (free, but you need to confirm your account).
- π± Forums XDA Developers: Xiaomi Themes & Apps.
- π¬ Telegram channels: for example, MIUI Customization or Xiaomi Themes.
- π Play Market: Through Apps Like Play Market MIUI Themes & Wallpapers (developer agreement required).
Before publication:
- Test the theme on 2-3 devices with different resolutions.
- Take screenshots of all screens (home, lock, app menu).
- Write a detailed description of the devices supported and the version of MIUI.
β οΈ WARNING: If you use other people's graphic elements (icons, wallpaper), make sure you have the right to distribute them.Many free icon sets prohibit commercial use.