Creating a theme for MIUI 12: The Complete Guide from A to Z

Branded shell MIUI Xiaomi's 12 is famous not only for its stable operation, but also for its deep customization of the interface. One of the most popular options is to install third-party themes that radically change the appearance of the system. MIUI 12 can be done by anyone, and it doesn't require the skills of a professional designer or programmer, but it's just patience, creativity and the right tools.

In this guide, we will take the theme development process from scratch, from preparing a work environment to testing and publishing in the official Mi Theme Store, you will learn what interface elements can be modified, where to download templates, and how to avoid typical beginner mistakes. We pay special attention to technical requirements MIUI 12, as the themes for this version have a number of differences from newer releases (e.g, MIUI 14. Ready to turn your Xiaomi into a unique device!

1. What you need to create a topic MIUI 12: Tools and requirements

Before you start designing, make sure you have everything you need. MIUI 12 (Or emulator, for testing. 9 Pro, Mi 10 or POCO X3 โ€” The main thing is that the shell version is not newer. 12.5.7. Second, prepare a computer with Windows. 10/11 or macOS for working with graphic editors.

Main instruments:

  • ๐ŸŽจ Adobe Photoshop or GIMP (Free alternatives โ€“ for editing icons and backgrounds.
  • ๐Ÿ“ฆ Mi Theme Editor (official software from Xiaomi) โ€“ for assembling themes from ready-made elements.
  • ๐Ÿ“ฑ MTZ Manager (Android app) โ€“ to upload themes to your phone without posting them to the Store.
  • ๐Ÿ” APKTool โ€“ for decompilation of system APK (advanced users).

โš ๏ธ Note: If you plan to publish a theme in the Mi Theme Store, register a developer account on themes.xiaomi.com. Without this, you can not upload the theme to the official directory. Also note that Xiaomi moderates content โ€“ topics with copyright infringement or obscene images will be rejected.

Minimum technical requirements for the topic MIUI 12:

ParameterRequirementNote
Permission of icons192ร—192 px (for launcher).png formats are supported with transparency.
Background images1080ร—2340 px (Full HD+)Use different screens to adapt to different screens 9-patch formats.
Color paletteNo more than 5 primary colorsMIUI It automatically generates accents.
Size of the theme archiveUp to 50. MBLossless compression (e.g.,.zip without archiving)
๐Ÿ“Š What tool do you plan to use to create a theme?
Adobe Photoshop
GIMP
Mi Theme Editor
Other

Structure of the topic MIUI 12: What elements can be changed

Subject in MIUI 12 is not just wallpaper and icons, it includes over 50 customizable elements, from download animations to notification styles:

Main elements of the topic:

  • ๐Ÿ“ฑ Launcher: application icons, folders, dock panel, opening/closing animations.
  • ๐ŸŽจ Wallpaper: Home screen, lock screen, application wallpaper (e.g. Weather or Calendar).
  • โš™๏ธ Systemic UI: notification panel, quick settings, call screen, keyboard.
  • ๐Ÿ”‹ Animations: system boot, transitions between screens, pressing effects.
  • ๐Ÿ“Š Fonts and colors: system font, palette of accent colors, text style in the menu.

It's important: MIUI 12 supports dynamic wallpapers, but their creation requires knowledge XML and JSON If you're a beginner, start with static elements. Also note that some system applications (like Settings or Phone) have rigidly defined styles that can't be changed without root rights.

Example of folder structure in the theme archive (.mtz):

miui_theme/


โ”œโ”€โ”€ description.ini #Metadata topics (title, author, version)




โ”œโ”€โ”€ preview.png # Store Preview (500ร—500 px)




โ”œโ”€โ”€ icon/ # App icons




โ”œโ”€โ”€ wallpaper/ # Wallpaper




โ”œโ”€โ”€ lockscreen/ # Lock screen elements




โ”œโ”€โ”€ notification/ # Notification Panel




โ””โ”€โ”€ font/ # Fonts (optional)

๐Ÿ’ก

Use official templates from Xiaomi to avoid missing theme elements, which can be downloaded from Mi Theme Editor or en.miui.com.

3. Step-by-step instruction: create a theme from scratch

Now, let's get to the practice. Below is a universal algorithm for creating a theme for the future. MIUI 12, which will suit even beginners. Follow the instructions in order to avoid errors in the assembly.

Step 1: Preparing a template

1. Download and install Mi Theme Editor from Xiaomi's official website.

2. Select the New Theme option and specify the target shell version โ€” MIUI 12.

3. Fill in the metadata in the description.ini file:

- name=Title of your topic

- author=Your name or nickname

- version=1.0

- compat=12 (version) MIUI).

Step 2: Designing icons

Icons are the most visible element of the topic.

Use vector templates (such as from Flaticon or IconFinder) to avoid pixelation.

Save the icons in.png format with a transparent background.

To adapt to a dark theme, create two versions of the icons (light and dark).

Example of a path for the icon Phone: miui_theme/icon/com.android.contacts.png

Step 3: Wallpaper and background images

Wallpapers must match the screen resolution of the target devices. MIUI 12 are relevant to the following standards:

- 1080ร—2340 px โ€“ for most smartphones (e.g. Redmi Note) 9).

- 1440ร—3200 px โ€“ for flagships like Mi 10 Pro.

Tip: Use the tool 9-Patch in Android Studio, so that the wallpaper is properly scaled on screens with different aspect ratios.

Step 4: Assembly and testing

1.In Mi Theme Editor, click Build to generate a.mtz file.

2. Transfer the file to the smartphone in the folder MIUI/theme (use MTZ manager or ADB).

3. Apply the theme through Settings โ†’ Topics.

Icons are displayed without artifacts|The wallpaper is adapted to dark / light mode|All system menus are stylized|The topic doesn't cause lags or departures|The preview corresponds to the real view-->

4 Common Mistakes and How to Avoid Them

Even experienced designers face challenges when creating themes for the... MIUI 12.These are the most common mistakes and ways to solve them:

Problem 1: The theme is not applied or the system crashes.

  • ๐Ÿ” Reason: Incorrect folder structure in the.mtz archive or lack of mandatory files (e.g. description.ini).
  • ๐Ÿ› ๏ธ Solution: Check the structure by template (see Section 2) and reassemble the theme.

Problem 2: Icons are shown in pixels.

  • ๐Ÿ” Reason: Original images are low resolution or lossy compressed.
  • ๐Ÿ› ๏ธ Solution: Use vector icons and export them to the 192ร—192 px without compression.

Problem 3: The theme is not moderated in the Mi Theme Store.

  • ๐Ÿ” Reason: Violation of Xiaomi rules (e.g. use of brand logos or obscene images).
  • ๐Ÿ› ๏ธ Solution: Learn the rules of publication and replace the problem elements.

โš ๏ธ Note: If you use resources from the Internet (icons, wallpaper, fonts), make sure they are distributed under a Creative Commons or Public Domain license. Otherwise, Xiaomi may block your account for copyright infringement.

How to check the topic for compatibility with MIUI 12?
Use an emulator to test compatibility MIUI 12 in Android Studio or slick custom recovery (e.g, TWRP) It's going to allow you to set the theme without limits and debug it at different screen resolutions.

5.Publishing the theme in Mi Theme Store: a step-by-step guide

If you are happy with the result and want to share the topic with other users, publish it in the official store.

  1. Register as a developer on themes.xiaomi.com (it will require a phone number binding).
  2. Upload the.mtz archive through the developer panel. Specify: - Subject category (e.g. Minimalism or Dark). - Brief description (in English and Chinese for a larger audience). - Search tags (e.g., Minimalism or Dark, #AMOLED, #DarkMode).
  3. Wait for moderation (usually takes 3-7 days). Xiaomi checks themes for technical and content requirements.
  4. Make a profit (optional): If the theme becomes popular, you can monetize it through the internal system Mi Credits.

Tip: To increase the chances of approval, add screenshots of the theme to the description on different devices (for example, Redmi and the other devices). POCO) and video animations.

Moderation statusWhat do you do?
โœ… Approved.The theme will appear in the catalog within 24 hours.
โŒ Overruled.Correct the errors in the comments and upload them again.
โณ On the check-up.Wait (depending on the workload of the support service).

๐Ÿ’ก

Posting to the Mi Theme Store is the only legal way to spread the topic to millions of Xiaomi devices. Alternative methods (for example, through forums or Telegram) can result in a ban on an account for piracy.

Advanced Techniques: Animations and Dynamic Elements

If you want to make your topic stand out from thousands of others, add dynamic elements to it. MIUI 12 supported:

  • ๐ŸŒŠ Live Wallpapers: Animated wallpaper based on.gif or.mp4 (maximum size: 10 MB).
  • โšก Transition effects: Custom animations when swiping between screens or opening apps (edited via transition.xml).
  • ๐ŸŽต Sound themes: Replacing system sounds (alarm clock, notifications) with your.ogg Samples.
  • ๐ŸŒ“ Adaptive colors: automatic palette change depending on the time of day (requires manual editing) colors.xml).

Example of code for download animation (bootanimation.zip):

bootanimation/


โ”œโ”€โ”€ desc.txt # Description of animation (resolution and FPS)




โ”œโ”€โ”€ part0/ # First part of animation (logo)




โ”‚   โ”œโ”€โ”€ 001.png




โ”‚   โ”œโ”€โ”€ 002.png




โ”‚   โ””โ”€โ”€ ...




โ””โ”€โ”€ part1/ # Second part (system boot)

To create Live Wallpapers, use Adobe After Effects with the Lottie plugin, which exports animation to.json โ€“ this format is supported. MIUI 12 without additional modifications.

โš ๏ธ Warning: Overly complex animations can increase battery consumption and cause lags on weak devices (e.g. Redmi) 8A). Always test the theme on budget smartphones before publishing.

7. Alternative means of disseminating topics

If your theme hasnโ€™t been moderated in the Mi Theme Store or you want to distribute it for free, consider alternative sites:

  • ๐Ÿ“ฑ Telegram channels: for example, MIUI Themes or Xiaomi Customization. You can upload.mtz files without restrictions here.
  • ๐ŸŒ Forums: XDA Developers, 4PDA Or Mi Community. These resources have a custom section.
  • ๐Ÿ’พ GitHub: Code hosting is open source, users can download and modify the source code.
  • ๐Ÿ“ฆ APK-Mods: If a theme requires root rights, pack it in.apk using MT Manager.

Advantages of alternative sites:

No moderation (you can publish themes with non-standard elements).

The ability to get feedback from users faster than in the official Store.

Flexibility in monetization (for example, through donates or patreon).

Disadvantages:

Smaller audience (Mi Theme Store has millions of users).

The risk of pirated copies of your theme being distributed.

๐Ÿ’ก

To protect your topic from theft, add a unique identifier (such as your account hash) to description.ini to help prove authorship in case of disputes.

FAQ: Answers to Frequent Questions

Can I create a MIUI 12 theme without a computer?
Technically, yes, but with serious limitations, you can only edit wallpaper and icons on your phone through apps like Pixellab or Icon Changer. UI-Elements: Mi Theme Editor is needed on PC.
Why My Theme Works on Redmi Note 9, But Doesn't Apply to the Redmi Note POCO X3?
The problem is probably the screen resolution. POCO X3 display-wise 1080ร—2400 px, and Redmi Note 9 โ€” 1080ร—2340 px. Recheck the adaptability of wallpapers and icons for different aspect ratios. Also make sure that description.ini specifies compat.=12, not a new version MIUI.
How to add your notification sounds to the theme?
1. Place.ogg audio files in a folder miui_theme/media/notification/. 2. In the description.ini file add lines: sound_notification=your_sound.ogg sound_alarm=your_alarm.ogg 3. Reassemble the theme. Keep in mind that the sound must not exceed the duration of the sound. 5 seconds.
Can I port the subject to the MIUI 14 on MIUI 12?
Some elements (like icons or wallpaper) are compatible, but the system is not. UI-components (notification panel, settings) in MIUI 14 have different code. You'll have to manually adapt files from the notification and framework folders using templates for the MIUI 12.
How much can you earn on topics for MIUI?
The revenue depends on the popularity of the theme. Mi Theme Store operates a system called Mi Credits, where you get about 1-5 downloads per 1,000 downloads. USD (The exact amount depends on the region. Top authors earn 200-500 dollars. USD This requires you to regularly release new topics and keep them relevant.