MiBandWFTool

[lvpokka]

Author
lvpokka

Tool Description
1. The tool is based on a modified version of AmazfitBipTools, thanks to the original open source .
2. The tool supports unpacking, packing of the official watch face bin file.
3. Mi band 4 supports 16,581,375 colors.
4. Mi band 5 supports 15,499,008 colors.

How to
1. Unzip MiBandWFTool_X.X.zip.
2. Download .bin file from catalog or get standard watchface file.
3. Drag the .bin file to WatchFace.exe (in step 1. , get the decompressed file)
(if there is only one log file, the decompression failed).

4. There are two ways to modify the dial.

• is to modify the corresponding image file and replace it with what we want.
• is to modify the corresponding json file and modify the position of the image.

5. After all the modifications are completed, drag the modified json into WatchFace.exe in step 1 to get the corresponding bin file
(the file name depends on the name of the bin. If the .bin file is not generated, the package is wrong)

6. Copy the newly generated bin file to the corresponding directory of the mobile phone, and the synchronization will be completed. (This step is not very clear, you can refer to the original tutorial) above, you're done!

History log

What's new

• added animation support
• fixed pulse and weather
• removed color restrictions for images
• analog clock support

ver1.2
- Added compatibility for Pulse progress bar

ver1.3
- added full support for transparent images
- drawing 20 frames for preview GIF

ver1.3.2
- bug fixes
- added 2 versions, both with transparency but Palette version uses less memory if images are simple.

ver1.3.3
- Added circular/linear step progress on preview

Stable v1.3.6
- locked transparency for palette mode, support only (0 and 255) values
- palette mode fix

Stable v1.3.7
v1.3.7 (cosmetic changes, you can use 1.3.6 if everything suits)
- Fixed GIF preview (Pulse rendering, Step segments, Kilometer drawing, Calories)
- Added the ability to choose which Set of images to use for WeekDays. (Config file WatchFace.exe.config)
- STRONGLY fixed json examples in README.
(to avoid problems, pack 1.3.6 and unpack 1.3.7 for a smooth transition)

Stable v1.3.8
- Removed image order dependency for json (sorting images no longer required)
- Fixed display bugs
Important: the order of the images should be from 0000 to XXXX without gaps.

v1.3.9
- Removed dependence on images order 0000->XXXX
- Calories rendering fixed
- Added ability to change Preview Speed (available from 50ms - 1000ms)
- TimeElement DrawingOrder hardcoded to 1234 (not used by MiBand4)

v1.4.1
- Other bugfixes
- New WF support
- Added new elements (time delimiter / step icon / linear progress )

v2.1.4
- Added support Mi Band 5 wfaces
- Pandafix (new unknown element)
- BugFixes

v2.1.5
- Preview bugfixes
- [WFPreview] Added Copy/Paste/Save ability
- [WFPreview] Added ability to replace watchface header

Mi Band 4 WF Tool
v1.4.2
- Added miles image support
NOTE:
- if your using image for MilesSuffixImageIndex, then KmSuffixImageIndex is required! you can use the same image for it

Mi Band 5 WF Tool
v2.1.6
- Preview bugfixes
- Watchfaces generating with random header identifier
- Fixed problem with Windows scaling, DPI is tied to 96
- [WFPreview] Removed ability to clone watchface header

Mi Band 6 WF Tool
v4.1.0
- Added Lunar calendar
- Bug fixes
- New preview generator, should be pixel perfect (big thx to Johnson070)

MiBandWFTool_4.1.0.zip

MiBandWFTool_2.1.6.zip [alt url] [alt url 2]

MiBandWFTool_1.4.2.zip [alt url] [alt url 2]

[BuddhaBMF]

Can anyoe help me to reverse the DATE into DD/MM instead of MM/DD???

Also, is there a code to input Stress Level in the screen!?

[Scorpion2185]

Can you make a linux version?
Does it work with wine?
I have a mi band 4.

[urieleugenio]

I'm having some trouble with the Battery Indicator, It shows the full-charge icon, even though the battery on my MB5 is currently at 55%. Anyone else is having trouble with this?

I rebooted the MB5, but it's still there. Could I have made an mistake on the code? This happens with different WFs, but maybe I'm carrying a code mistake.

[abcd840322]

Hello,
Very appreitiated the tool, it works really well with MB5.
I want to asked that is it possible to change the watch face automatically? I mean if I have the same watch face with different color versions, can I set a specific time to change my watch face into another color automatically?
Thanks!

[abcd840322]

I'm having some trouble with the Battery Indicator, It shows the full-charge icon, even though the battery on my MB5 is currently at 55%. Anyone else is having trouble with this?

I rebooted the MB5, but it's still there. Could I have made an mistake on the code? This happens with different WFs, but maybe I'm carrying a code mistake.

Hi, I didn't encounter the problem, but I heard your problem from others too.
Here is the well-functioned battery json code for MB5, hope this will help you.
"Battery": {
"BatteryIcon": {
"X": 73,
"Y": 6,
"ImageIndex": 53,
"ImagesCount": 10
}
},

um...the post does not support the spacing...make sure the spacing is correct in your code.

[urieleugenio]

The issue with the battery images not cycling seemed to be because I was using only 6 images (from other WFs I saw mostly 9 images).

[abcd840322]

Bug report:
All images are fixed in the animated preview on the PC, but some moved after installing on the watch.
For instance, my weather indicator and temperature numbers sometimes move from the bottom left of my watch to the top right. The error appears in chances (there was time the images staying in the original place),and remains for random period.

Using IOS 13.5.1 and installing through AmazTools.

[lvpokka]

there is uknown element after weather icons, it should have the same coordinates

[abcd840322]

there is unknown element after weather icons, it should have the same coordinates

Thanks a lot!!! I didn't know the function of the unknown value so I just ignored it after copied it from another watch face. Now all is well with the correct coordinates, many thanks!!!

[diopter]

@lvpokka:
I want to call WatchFace.exe from a cmd batch file,
but WatchFace.exe always returns errorlevel 0.
Can you return another errorlevel value if there is an error?

[Borgo]

Does it support animations on Mi band 5?

[lvpokka]

I want to call WatchFace.exe from a cmd batch file

use watchface as argumet (ex. wf.exe file.bin)

Does it support animations on Mi band 5?

yes... thats strange question... decompile animated watchface to see how to make animations

[diopter]

use watchface as argumet (ex. wf.exe file.bin)

My problem is NOT to call watchface.exe,
the problem is, that watchface.exe gives no errorlevel value back after work is done.

[lvpokka]

My problem is NOT to call watchface.exe,
the problem is, that watchface.exe gives no errorlevel value back after work is done.

Then i cant understand you) your first with that type of question just drag and drop BIN on EXE and you will get log file 100% with all logs

[diopter]

What I want is that the console window of watchface.exe don't close, when there is an error while compiling JSON.
I can hold it open with the "pause" command in my cmd file everytime, but I want it only hold visible if an error occurs.
For this, I must know in the cmd file, if there was an error.
Console programs like watchface.exe usually return an error code when they terminates, which can then be evaluated in the cmd file using "errorlevel".
(In Delphi/Pascal this is "ExitCode")

Another thing:
"Time" has 2 delimiterimage entries:

Code: Select all

    "DelimiterImage": {      // before seconds ?
      "X": 13,
      "Y": 40,
      "ImageIndex": 72,
    },
    "TimeDelimiterImage": {       // before minutes ?
      "X": 38,
      "Y": 174,
      "ImageIndex": 56,
    },

MI Band 5 shows both (even when there are no seconds),
but watchface.exe ignores "DelimiterImage" in the GIF and PNG.
Can you please change this to show both in the previews?

[lvpokka]

1) I can hold it open with the "pause" command in my cmd file everytime, but I want it only hold visible if an error occurs.

2) Another thing:
but watchface.exe ignores "DelimiterImage" in the GIF and PNG

1) all logs is in the .log file which is created after unpacking, no need to check what was in cmd

2) please upload bin,screenchot and some examples with problem with description, and i will fix if something is not rendering right on preview

[diopter]

Here you have:
- my BIN
- the GIF created by watchface.exe from json compilation
- the extracted first image from GIF
- a photo of my MI Band 5 with this watch face

DelimiterImage.zip

DelimiterImage

(332.78 KiB) Downloaded 248 times

As you can see, the progress bar background and date delimiter point are visible on MI Band, but not in the preview.

[lvpokka]

hello, i am using MiBandWFTool_2.1.4 for Mi Band 5. is there a problem with "shape of heartrate" ? its look like works right in the pc test and compiler animated gif. but wrong working in Mi Band 5.

try to raise heartrate up to 120+ ) this tag is showing anaerobic pulse and its different for all users.

[awrun]

Hi!
I created my first own watchface for mi band 5.
When I drop the .bin file to WatchFace.exe, in the command line I see this, with purple letters:
"[WARNING] Problems with decompiling, SKIPPED important bit. id:20"
What does it means?
In the decompressed folder "0020.png" is a blue number.
How can I fix this?

[lvpokka]

this warning is not a problem for users, its just for debuging.
this behavior is expected and ok.

[awrun]

Thanks lvpokka!

[diopter]

SEDO is absolutely right, there is a bug, and not only with the heart rate, but with all progress indicators.
The internal MI WFs already show the first progress step (blue for heart rate), while our custom WFs still show nothing.
My workaround is also to put the respective first image on the background.

[franluciani]

Hi. Other bug that i found it's the wind is only visible when the MiBand5 it set in English language. In others languages the wind it's empty

[MrMuesLee]

Hi,
Sorry if this is already asked
Is there a known bug with the current temperature?
It is shown in the preview und not when installing the bin on MiBand 5

Testing:
download https://amazfitwatchfaces.com/mi-band-5/view/259 green_pipboy_eng
Install on MiBand 5 --> current temperature is shown

decompile and compile it again without any changes, current temperature is not shown after install on MiBand 5

Settings: <add key="UsePaletteMode" value="1"/>
MiBand Firmware: V1.0.1.32

Thank You!

[urieleugenio]

From what I've seen, the band only shows current temperature for a short time after opening the app on the phone, so that the phone app and the band synchronize. The Band does not measure temperature, and current temperature changes through out the day. For this reason, if the band has not been recently synchronized, it shows only maximum and minimum temperature.

Preview, of course, just shows coded elements, and would not hid the current temperature.
Maybe that explains your band not showing current temperature?