miwtool

A tool for manipulating Redmi Watch 2 Lite, Redmi Watch 2 China, Poco Watch watchface files

Installation

Clone this repository and unzip it
Make sure that you have python (3.8 +) installed
Install requirements:

python -m pip install -r requirements.txt

Usage

Unpacking

python main.py --decode /path/to/input --output /path/to/output

Repacking

python main.py --encode /path/to/input --output /path/to/output

Creating Watch Faces the easy way

Watchface Editor now includes support for Redmi Watch 2 Lite!

How to use

In the top right corner, press "Devices" and select "Redmi Watch 2 Lite"
Go to "View" Tab, press "SELECT" button in front of Images and select all of your custom images (they must be named in order "0.png", "1.png", "2.png"...)
In "Edit" Tab, you can change watch "Name" under "MetaData", and add a custom "Id" (optional)
Toggle the components you want to add in the right
In "Design" Tab, position your components freely
After finishing, click "EXPORT JSON" and save the file as "watchface.json" in the same folder then the images you imported earlier

Compiling to ready-to-install file

python main.py --encode_wfeditor /path/to/input --output /path/to/output

Compiling to unpacked file

python main.py --decode_wfeditor /path/to/input --output /path/to/output

where path/to/input refers to the folder which contains the exported "watchface.json" and the images

Folder structure

├── 0000.png
├── 0001.png
├── 0002.png
├── 0003.png
├── 0004.png
├── 0005.png
├── 0006.png
├── 0007.png
...
└── watchface.json

Unsupported features

12/24H format change
Date OneLine
Steps Goal, Steps Progress, Steps Progress Circle, Steps Goal Icon
Distance
Alarm, Bluetooth, Lock, Do not disturb
Battery icon, Battery bar
Weather OneLine, Day Weather, Night Weather, Alt Day Weather, Alt Night Weather
Air Pollution

[Notes]

Only "Tens" image matters in Time, ("Ones" is ignored)
Editing config.json (see "Details about unpacked file") gives you a more complete control over features (exclusive: analog, ...)
Weather CustomIcon must be in this exact order: Sunny, Cloudy, Overcast, Showers, Thunder Storm, Snowy, Sleet, Moderate Rain, Heavy Rain, Weak Snow, Moderate Snow, Heavy Snow, Very Heavy Snow, Foggy, Windy, Weak Snow, Loop (?), Unknown Data, Showers

Watch Faces extraction

To extract watch faces, you need to install Mi Fitness on an android device, download a watchface, and then navigate to

Android/data/$PACKAGE_NAME/files/WatchFace

($PACKAGE_NAME might be com.mi.health or com.xiaomi.wearable depending on your region)

Details about unpacked file

folder tree

.
├── config.json
├── images_0
│   └── static.png
...
├── images_11
│   ├── image_0.png
│   ├── image_1.png
...
│   ├── image_8.png
│   └── image_9.png
└── images_preview
    └── static.png

config.json structure

{
    "name": "Watch Face Name",
    "id": "12345678",
    "preview": {
        "static": "path/to/preview.png"
    },
    "components": [
        {
            "x": 0,
            "y": 0,
            "static": "background.png"
        },
        ...
        ]
    }
}

component attributes

Attribute	Condition	Description	Data type
x	*	x coordinate	int16
y	*	y coordinate	int16
static	optional	static image path	string
dynamic	optional	dynamic images paths	array[string]
type	optional	defines the type of a dynamic widget	object
-- category	*	[TIME / BATTERY...]	string
-- type	*	[HOUR / TEMPERATURE / ...]	string
-- format	*	the format to display the data	string
-- coordinate_types	*	what x and y mean	string
pivot_x	if R	xcenter of rotation	int16
pivot_y	if R	ycenter of rotation	int16
max_value	if R	max_value that defines a rotation	int16
max_degrees	if R	degrees corresponding to max_value (3600° is 2π)	int16
values_ranges	if FORMAT_IMAGE	value range for each image	array[uint32]
spacing	optional	spacing in pixels at the end of each image	int

[Notes]

Images can have any names and can be placed in any folder
All categories, types, formats, and coordinate_types can be found in constants.py
Examples can be found in ./examples/watchfaces/decoded