Creating a custom theme for Xiaomi: from idea to installation MIUI

You are tired of the standard topics in MIUI And you want to make your Xiaomi, Redmi or Poco smartphone really unique? Creating your own theme is not only a way to stand out, but also an opportunity to tailor the interface to your needs, from color scheme to animations and sounds. Unlike buying ready-made solutions in the Mi Theme Store, self-development gives full control over every element – from application icons to fonts and wallpaper.

In this article, we will analyze the entire process: from design preparation to the final installation of the theme on the device. You will learn what tools you will need (including the official Mi Theme Editor and alternative solutions), how to work with.mtz files, and what pitfalls can arise when porting themes to different versions. MIUI. Particular attention will be paid to compatibility with the latest firmware based on Android 13/14 and nuances for devices with HyperOS.

What you need to create a Xiaomi theme: tools and requirements

Before you start designing, make sure you have everything you need. Minimum requirements are easier than they seem, but some nuances depend on the version. MIUI and smartphone models.

The main tool is Mi Theme Editor (official software from Xiaomi), but it has limitations: it works only on Windows, requires registration in Mi Account and does not support all interface elements in new firmware versions. MTZ Theme Editor or MIUI Theme Studio offers more freedom, but may require manual editing XML-file.

  • πŸ–₯️ Windows computer 10/11 (for Mi Theme Editor or macOS/Linux (alternative instruments).
  • πŸ“± Smartphone Xiaomi/Redmi/Poco on MIUI 12–14 HyperOS with unlocked bootloader (for testing).
  • 🎨 Graphic Editors: Adobe Photoshop, GIMP or Figma for creating icons and wallpaper.
  • πŸ“ Archivator (7-Zip WinRAR for working with.mtz files.
  • πŸ”§ ADB-tools (optional, for debugging and installing themes manually).

Important: If you plan to distribute your theme, sign up as a developer at the Mi Theme Store.This is not necessary for personal use, but without a developer account, you will not be able to upload themes to the official store.

πŸ“Š What OS do you create themes for Xiaomi?
Windows
macOS
Linux
Android (directly on the phone)

Step 1: Designing a Theme Design – Where to Start

The first step is not to draw icons, but to create a concept: decide which style you want to embody: minimalism, neon cyberpunk, retro design or something unique. View popular themes in the Mi Theme Store (Top section) and note which elements you like and which you want to change.

Make a list of components that you will customize:

  • πŸ“± Application icons (size) 192Γ—192 px MIUI 12+).
  • 🎨 Wallpaper (for locking and main screen, resolution at least) 2160Γ—1920 px).
  • πŸ”€ Fonts (supported formats.ttf and.otf).
  • 🎡 Sounds (notifications, alarm clock, unlocking - format.mp3 or.ogg).
  • πŸ–ΌοΈ Interface elements: notification panels, switches, buttons.

Critical moment: in MIUI 14 HyperOS has changed the theme structure – some elements (such as animations transition between screens) are now stored in separate.json files. XDA Developers or in telegram channels like @miuithemes.

πŸ’‘

Use Flaticon to search for free SVG-Icons – they are easy to adapt to size MIUI Figma or Photoshop.

Step 2: Creating icons and graphic elements

Icons are the face of your theme, and they should be not only beautiful, but also functional: they should read well against dark and light backgrounds, be sized. 192Γ—192 px (for px) MIUI 12–14) and have a transparent background (.png).

Design recommendations:

  • 🎯 Single style: If you choose a flat design, stick to it for all icons. 3D, gradients.
  • 🌈 Color palette: limit yourself to 3-4 primary colors. Use Coolors to match harmonious combinations.
  • πŸ” Testing: Check how icons look on your smartphone screen (especially on your smartphone screen) AMOLED-displays where black is really black).

Templates can be used to speed up the process:

1. Download the MIUI icon template: [link to XDA](https://forum.xda-developers.com/t/miui-icon-template.3824567/)


2. Open in Photoshop/GIMP and place your images in layers.




3. Export each icon to.png with the name corresponding to the application package (e.g. com.android.chrome.png).

If you are not an artist, use the icon generators:

Icon Kitchen (for adaptive icons)

Android Asset Studio (from Google)

- MIUI Icon Changer (Android app but requires root).

Where can I get the names of icon packs?
Open on your smartphone Settings β†’ Annexes β†’ Application management, select the desired one and copy the name of the package from information about it.

Step 3: Working with Mi Theme Editor – Build theme

When the graphic elements are ready, start assembling the theme in Mi Theme Editor. Download it from the official Xiaomi website (link is relevant to the site). 2026 year: MTEditor.zip). Install the program and log in via Mi Account.

Step-by-step:

  1. Create a new project: File β†’ New Theme.
  2. Choose a basic theme (like Default or Dark Mode) and it will be the basis for your customization.
  3. Import your icons: go to the Icons section, click Import and select the folder with.png files.
  4. Customize wallpapers: In the Wallpapers section, upload images for the home screen and lock screen.
  5. Add fonts and sounds (optional) in the appropriate tabs.
  6. Export theme: File β†’ Export, select the.mtz format.

Note: Mi Theme Editor does not support all HyperOS elements.If your theme is designed for new devices (e.g. Xiaomi) 14 or Redmi Note 13), Some parameters will have to be manually edited through editing. description.xml inside the.mtz archive.

β˜‘οΈ Check before exporting the topic

Done: 0 / 5
Element of the topicFile formatMax size.Notes
Icons.png192Γ—192 pxTransparent background is mandatory
Wallpaper..jpg, .png2160Γ—1920 pxFor AMOLED Better than.png with black background
Fonts.ttf, .otf≀5MBNot all fonts support Cyrillic.
Sounds..mp3, .ogg≀5 secondsBitreit ≀192 kbps

Step 4: Installing theme on Xiaomi smartphone

You have to transfer the.mtz file to your smartphone and install it. There are three ways to do this:

Method 1: Mi Theme Editor (official)

If you're logged in, the theme will automatically appear in the "My Topics" section of the Topics app on your smartphone. Update the themes list by swiping down and apply yours.

Method 2: Manual installation via file manager

  1. Copy the.mtz file into a folder /sdcard/MIUI/theme/ smartphone.
  2. Open the Topics app, go to My My β†’ Import and select your file.
  3. After importing the theme will appear in the list of available.

Method 3: Through ADB (for power users)

If the theme doesn’t want to be installed in a standard way (a common problem on HyperOS), use the command:

adb push your theme.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.ThemeChangeReceiver

πŸ’‘

On HyperOS devices before installing themes through ADB I need to get the debugging on. USB and allow access for the computer to the Settings β†’ The phone. β†’ Version. MIUI (7 times to activate the developer mode).

Attention! ⚠️ On some firmware (e.g, MIUI Global for European devices) third-party themes may be blocked:

  • Install MIUI EU ROM (Unofficial firmware with unlocked functions).
  • Use Magisk modules like this MIUI Theme Manager.
  • Manual patch system files (requires root).

Step 5: Testing and debugging theme

Even if the topic is established, it doesn't guarantee it will work properly.

  • πŸ” Icons: Check that all apps have new icons (especially system ones: Settings, Phone, Messages).
  • πŸ“± Wallpaper: Make sure they don’t stretch or trim on the lock screen.
  • 🎡 Sounds: Test notifications, alarm clock and unlock sound.
  • πŸ–₯️ Interface: Check notification panels, switches in Quick Settings, buttons in Settings.

Typical problems and their solutions:

Problem.Possible causeDecision
The icons haven't changed.Wrong file namesCheck for the matching of packet names (e.g. com.android.contacts.png)
Theme is not setIncompatibility with the MIUI versionEdit it. description.xml.mtz archive
Wallpaper shiftedWrong resolutionUse wallpaper with an aspect ratio of 18:9 or 20:9
No sounds are played.Inappropriate formatConvert to.ogg with a bitrate of 128 kbit/s

Attention! ⚠️ If the smartphone starts to brake or overheat after applying the theme, it is likely that the problem is too heavy graphic elements (for example, animations in.gif instead of.webp.

Step 6: Post a theme in the Mi Theme Store (optional)

If you want to share your theme with others, you can upload it to the official Mi Theme Store.

  1. Register as a developer at themes.xiaomi.com.
  2. Fill out the profile: provide the name, description and examples of the work.
  3. Download the.mtz file through the developer panel.
  4. Wait for moderation (can take up to 7 days).

Publication requirements:

  • πŸ“Œ The topic should be unique (not a copy of existing ones).
  • πŸ“Œ All graphic elements are in high resolution.
  • πŸ“Œ No watermarks or advertisements.
  • πŸ“Œ Support for at least 2 languages (English) + one-on-one).

If a theme is approved, you can earn revenue from downloads (Xiaomi pays developers for popular themes), the average price of themes in a store is 1-3 dollars, but free themes can also score millions of installs.

πŸ’‘

To increase your chances of approval, add support for dark mode and adaptive icons for tablets (if you plan on compatibility with the Xiaomi Pad).

FAQ: Frequent questions about creating themes for Xiaomi

Can I create a theme directly on my phone without a computer?
Yeah, but with limitations. MIUI Theme Studio (unofficial) or Icon Changer lets you edit individual elements, but it's hard to assemble a full-fledged theme with wallpaper, fonts and sounds.
Why does my theme work on Redmi Note 10 but not installed on Xiaomi 13?
Probably the problem with the version. MIUI. Xiaomi 13 work MIUI 14 Or HyperOS, where the theme structure has changed. You need to: Update Mi Theme Editor to the latest version. description.xml In the.mtz archive, specifying support for new versions, check that all icons have the correct packet names (they may differ in new firmware). ADB β€” Sometimes it gets around the restrictions.
How to add animations to your theme?
Animations in MIUI Stored in.zip or.json files inside the.mtz archive. To create them: Use Adobe After Effects to render.webp animations (only certain types of animations are supported). FPS Place the files in the folder. /animations/ inside.mtz. edit. description.xml, adding links to animations for specific events (e.g. unlocking the screen). note that animations greatly increase the size of the theme and can cause lags on weak devices (e.g. Redmi). 9A).
Can I port a theme from Samsung or iOS to Xiaomi?
Technically, yes, but it's a laborious process: πŸ”Ή Different sizes of icons (Samsung uses the same name) 114Γ—114 px, iOS β€” 180Γ—180 px). πŸ”Ή The absence of universal package names (for example, the Settings icon on iOS is called differently than on the iOS icon). MIUI). πŸ”Ή Different Theme Structures: In One UI or iOS uses other configuration files, we recommend manually transfer only graphic elements (icons, wallpaper), and create the rest from scratch under the MIUI.
How to remove the installed theme if it caused failures?
If after applying the theme, the smartphone began to glittle (for example, icons disappeared or the notification panel stopped working), do the following: Go to Settings β†’ The phone. β†’ Resetting settings β†’ Reset themes. If that doesn't help, delete the theme file from the folder. /sdcard/MIUI/theme/. In extreme cases, reset to factory settings (data will not be affected, but all customizations will be reset). If the problem remains, the topic may have damaged the system files.