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]

[lvpokka]

Thanks for the really really great tool, @lvpokka! Is there a json template/example that contains all of the supported tags? For instance, I'd like a PAI progress indicator and I wonder if it is possible.

nope) i hope someone from followers will make such item) to get element, just download watchface with needed element, and copy json from it

BTW> 2.1.5 released

[diopter]

"Time": "DelimiterImage" is still not displayed in preview.

Code: Select all

  "Time": {
    "TimeDelimiterImage": {   //  visible in preview
      "X": 95,
      "Y": 168,
      "ImageIndex": 92,
    },
    "DelimiterImage": {       //  NOT shown in preview
      "X": 0,
      "Y": 168,
      "ImageIndex": 92,
    },
  },

[lvpokka]

"Time": "DelimiterImage" is still not displayed in preview.

oh... forgot to pick this code for compile

upd.
Reuploaded

[diopter]

MiBandWFTool cannot unpack the MI stock WFs of the "Photo Watch Face" series (Style1 ... Style5).
The following error message appears in the log file:

Code: Select all

Debug|Parsing parameters...
Trace|2 'Background'
Trace|2.1 'Image'
Trace|2.1.1 'X': 0
Trace|2.1.2 'Y': 0
Trace|2.1.3 'ImageIndex': 59
Fatal|System.ArgumentException: Parameter 6 isn't supported for Background
   bei WatchFace.Parser.Utils.ParametersConverter.Parse[T](List`1 descriptor, String path)
   bei MiCwU0e2dHM3cnc3H8.rC9cSqxd5BNoymSUH5.D5BJNoymS(Reader  )

[lvpokka]

MiBandWFTool cannot unpack the MI stock WFs of the "Photo Watch Face" series (Style1 ... Style5).
The following error message appears in the log file:

Code: Select all

Debug|Parsing parameters...
Trace|2 'Background'
Trace|2.1 'Image'
Trace|2.1.1 'X': 0
Trace|2.1.2 'Y': 0
Trace|2.1.3 'ImageIndex': 59
Fatal|System.ArgumentException: Parameter 6 isn't supported for Background
   bei WatchFace.Parser.Utils.ParametersConverter.Parse[T](List`1 descriptor, String path)
   bei MiCwU0e2dHM3cnc3H8.rC9cSqxd5BNoymSUH5.D5BJNoymS(Reader  )

Yes, it was not supported by purpose. It's not possible to get data from photo wface because its just a dummy and all compilations was performed on uploading to mi band 5

[franluciani]

I saw in the official's WF for Mi Band 5, that the numbers can be turned. It will be nice if you can include this option in the tool

[lvpokka]

I saw in the official's WF for Mi Band 5, that the numbers can be turned. It will be nice if you can include this option in the tool

didn't understand your message) add photos or something to help me understand

Do not understand, still

[franluciani]

Turned = gyrate = deranged

Spoiler

[lvpokka]

... Still not clear, but try to decompile it and check SpacingY & SpacingX, probably it help you

[diopter]

Yes, it was not supported by purpose. It's not possible to get data from photo wface because its just a dummy and all compilations was performed on uploading to mi band 5

Are you sure that it's just a dummy?
I think that there is in the MB5 an overlay with a PNG with alpha blend to give all white pixels (except in the photo) the selected color.
It would be nice if it were also possible to easily change the colors of our custom WFs.
Could you do some research there?
After all, the error message indicates that there is an unknown parameter for "Background".

[diopter]

The bottom alignment bug in preview ist NOT fixed !

see viewtopic.php?p=6371#p6371
and viewtopic.php?p=6374#p6374

[lvpokka]

Yes, it was not supported by purpose. It's not possible to get data from photo wface because its just a dummy and all compilations was performed on uploading to mi band 5

Are you sure that it's just a dummy?

yeap, watchface is not containing background in itself(as it was in mi band 4), even if you uploaded it to mi band 5
also there is allot of images of position of elements, and it looks as configuration, not as builded watchface

[franluciani]

... Still not clear, but try to decompile it and check SpacingY & SpacingX, probably it help you

i got it and this help me. thx

[diopter]

"Alarm" - "ImageNoAlarm":
X and Y not working in preview, Image is shown always at text position

[lvpokka]

"Alarm" - "ImageNoAlarm":
X and Y not working in preview, Image is shown always at text position

i need proofs, please upload images and protos of a problem,
also i need bin files with problem

[diopter]

"Alarm" - preview bug
"Text": OK
"ImageOn": OK
"ImageOff": OK
"ImageNoAlarm": The red line in my example should start at X=0 and Y=17, but starts at the position defined in "Text"

On MB5 all works like expected.

[diopter]

Next preview bug:
"StepsProgress": - "CircleScale":
MB5 stops drawing the progress bar if "EndAngle" is reached, preview drawes around...

[zyfish]

excuse me，Can AQI data be displayed on the MIBAND5? Only three animation files can be json? thanks.....

[diopter]

Suggestion for improvement:
The display of the MB5 has rounded corners.
It would be nice if the corresponding pixels were also set to black in the preview.

[franluciani]

Will be nice if the next version of tool adds some function to shortcuts, and other for modify the complications (as the original theme for Mi Band 5)

[arthurking521]

hi,
could u pls. modify a new tool based on the version of GTR-Watchface-editor,
The design is very convenient, intuitive, and has a “Shortcuts" function, you can click somewhere on the screen to enter the corresponding program. as franluciani mentioned
Thank you very much!

Spoiler

GTR-TOOL (2).jpg (198.72 KiB) Viewed 53518 times

[lvpokka]

hi,
could u pls. modify a new tool based on the version of GTR-Watchface-editor,
The design is very convenient, intuitive, and has a “Shortcuts"

Do you have sourceCode of this program, i need real id of this Shortcut tag. Also need someone to test this element, because i dont want to brick my mi band 5 and i will not release it with out testing and proofs thats its working

[arthurking521]

hi,
could u pls. modify a new tool based on the version of GTR-Watchface-editor,
The design is very convenient, intuitive, and has a “Shortcuts"

Do you have sourceCode of this program, i need real id of this Shortcut tag. Also need someone to test this element, because i dont want to brick my mi band 5 and i will not release it with out testing and proofs thats its working

I downloaded it from the post next door and applied it. Below is the download address,sorry I only know that

viewtopic.php?f=29&t=1076

[schmitty782]

Hello. I have a little problem with the version "Mi Band 5 WF Tool v2.1.6".

I downloaded the following watchface:
https://amazfitwatchfaces.com/mi-band-5/view/577

I can extract it to JSON with no problems. But if I want to pack it back into the BIN without making any changes, I get the following error message:
"Fatal | [ERROR] Watchface is greater than 615kb, it will not be accepted by Mi Band 5, please reduce size! Current size: 724kb.
Fatal | System.ArgumentException: [ERROR] Watchface is greater than 615kb, it will not be accepted by Mi Band 5, please reduce size! Current size: 724kb.
at FBdrVENTOSQNAwAAQU.BV9w4uUq25cVnqdLQO.oSeohcXKw (string)
at FBdrVENTOSQNAwAAQU.BV9w4uUq25cVnqdLQO.J3lOPWa16aK5SHgjpf (Object)
at FBdrVENTOSQNAwAAQU.BV9w4uUq25cVnqdLQO.F4U4xmNtm (String []) "

Does somebody has any idea?

greeting
Christian

[diopter]

@schmitty782 :
Set "UsePaletteMode" value="1" in file WatchFace.exe.config