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]

[zyfish]

Mi band 6 support it coming.

Closed BETA release 4.0.2a

boss，very good。

[kazlaz]

Mi band 6 support it coming.

Closed BETA release 4.0.2a

Can I download the dial tool test version of Mi Banda 6?I can’t wait to make a watch face .

[eua]

Can't wait, let's post it for everyone's use first.

[Hoekstra]

Thanks, I love how this tool just works!

Now I'm working on a custom watchface with a lot of segments and it doesn't work for some reason. The tool isn't giving any errors and generates all the assets as expected. It just isn't working on the Mi Band 5 for me.

I don't know if this might be an error on my side, the tool's site or with the Mi Band 5.

Is there a limit of how many segments I can use?
The problems exist in the BatteryIcon, HeartProgress and StepsProgress.

I hope someone can have a look at this.

I attached the bin file, you can unpack it with the MiBandWFTool for Mi Band 5.

[yaoun]

Hi, I am a skinner for french people, I've just received a chinese mi band 6,
Is it possible to get the beta compiler/decompiler to make watchfaces for the band 6?
Thanks a lot for your work.

[yaoun]

Thanks, I love how this tool just works!

Now I'm working on a custom watchface with a lot of segments and it doesn't work for some reason. The tool isn't giving any errors and generates all the assets as expected. It just isn't working on the Mi Band 5 for me.

I don't know if this might be an error on my side, the tool's site or with the Mi Band 5.

Is there a limit of how many segments I can use?
The problems exist in the BatteryIcon, HeartProgress and StepsProgress.

I hope someone can have a look at this.

I attached the bin file, you can unpack it with the MiBandWFTool for Mi Band 5.

hi, perharps the problem comes from the size of your file .bin.
The maximum size of the file must be under about( 600kb, I think).
If it is the case you have 2 choices:
decrease the number of pictures.
or decrease the number of colors, you can do it with the config file .
In the readme.txt:
"UsePaletteMode = 1
- can be used if images having <=255 colors.
- uses picture palette, in some cases could reduce pack weight.
- create file image.cfg with content 1,4,2,5,66 (near .json) to inverse image writing mode for selected image IDs
- will compress images if it's not fitting in 255 color palette
UsePaletteMode = 0
- can provide more quality for image.
- normally working with 24&16bit images, raw look. Can greatly increase the size of the build."
Have a good day
Sorry for my english, i am french and it well known that froggers don't speak other languages!

[liu5580]

Do you have mi band 6 watchface tool?I heard that it is in beta, can I join the beta please？
Thank you

[lvpokka]

Beta is only for best of Watch face creators or for my testers(new feature testers)

Both of them should have mi band 6 on hands.

Last build: 4.0.4a

[lvpokka]

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

[yaoun]

Thanks a lot

[Hoekstra]

Hey lvpokka,

I'm creating a watchface with a lot of statistics and it came to my attention that I can create a Time without TimeDelimiterImage but I can't create a TimeZone1 or TimeZone2 without TimeZone1DelimiterImage or TimeZone2DelimiterImage. Is it possible to update the app so I don't need a delimiter image? Or doesn't the watchface work without it? I'd like to show TimeZone1 and TimeZone2 just like time: 1337 instead of 13 37 or 13:37, so without delimiter.

Spoiler

[lvpokka]

Hey @lvpokka,

I'm creating a watchface with a lot of statistics and it came to my attention that I can create a Time without TimeDelimiterImage but I can't create a TimeZone1 or TimeZone2 without TimeZone1DelimiterImage or TimeZone2DelimiterImage. Is it possible to update the app so I don't need a delimiter image? Or doesn't the watchface work without it? I'd like to show TimeZone1 and TimeZone2 just like time: 1337 instead of 13 37 or 13:37, so without delimiter.

Spoiler

nope) thats the rule try image with 1 pixel width

[Hoekstra]

Hey @lvpokka,

I'm creating a watchface with a lot of statistics and it came to my attention that I can create a Time without TimeDelimiterImage but I can't create a TimeZone1 or TimeZone2 without TimeZone1DelimiterImage or TimeZone2DelimiterImage. Is it possible to update the app so I don't need a delimiter image? Or doesn't the watchface work without it? I'd like to show TimeZone1 and TimeZone2 just like time: 1337 instead of 13 37 or 13:37, so without delimiter.

Spoiler

nope) thats the rule try image with 1 pixel width

Well, it is what is is, thank you

I'm already using a 1px transparent image. But it will add "SpacingX + DelimiterImage + SpacingX", so the gap becomes pretty big.

[TedwardCz]

Hello all. I'm brand new here and I created an account for the specific purpose of asking about sunrise and sunset times using this tool. I tried the search tool, but if there is something out there already answered, I couldn't find it.

Anyway, to understand sunrise and sunset time, I unpacked a couple of watch faces that show these times.

Here's an example created by DenisCro1: https://amazfitwatchfaces.com/mi-band-5/view/2179

So, I took a peek at the unpacked JSON and see that the sunrise and sunset are defined as TimeZone1 and TimeZone2. Using this knowledge, I did something similar, packed up my own face, and even got the handy preview gif I'm including below...

Spoiler

When I synch that to my Mi Band 5, though, the time displays, but the rise and set are both blank.

Is there something I have to do to define what TimeZone1 and TimeZone2 are? I looked through the entirety of DenisCro1's unpacked JSON to no success.

Also, I looked at this documentation...

viewtopic.php?t=1192

...but it didn't seem to answer the question.

Thanks, all.

[Hoekstra]

Hello all. I'm brand new here and I created an account for the specific purpose of asking about sunrise and sunset times using this tool. I tried the search tool, but if there is something out there already answered, I couldn't find it.

Anyway, to understand sunrise and sunset time, I unpacked a couple of watch faces that show these times.

Here's an example created by DenisCro1: https://amazfitwatchfaces.com/mi-band-5/view/2179

So, I took a peek at the unpacked JSON and see that the sunrise and sunset are defined as TimeZone1 and TimeZone2. Using this knowledge, I did something similar, packed up my own face, and even got the handy preview gif I'm including below...

Spoiler

When I synch that to my Mi Band 5, though, the time displays, but the rise and set are both blank.

Is there something I have to do to define what TimeZone1 and TimeZone2 are? I looked through the entirety of DenisCro1's unpacked JSON to no success.

Also, I looked at this documentation...

viewtopic.php?t=1192

...but it didn't seem to answer the question.

Thanks, all.

As stated in the anwers above your question. TimeZone1 and TimeZone2 won't work without "TimeZone1DelimiterImage" / "TimeZone2DelimiterImage".
I hope that answers your question. I know you don't want a delimiter, just as I, but there's nothing to do about it.

Code: Select all

    "TimeZone1": {
      "TopLeftX": 71,
      "TopLeftY": 29,
      "BottomRightX": 120,
      "BottomRightY": 42,
      "Alignment": "TopLeft",
      "SpacingX": 4,
      "SpacingY": 0,
      "ImageIndex": 60,
      "ImagesCount": 10,
    },
    "TimeZone1DelimiterImage": 409,
    "TimeZone2": {
      "TopLeftX": 5,
      "TopLeftY": 29,
      "BottomRightX": 54,
      "BottomRightY": 42,
      "Alignment": "TopLeft",
      "SpacingX": 4,
      "SpacingY": 0,
      "ImageIndex": 60,
      "ImagesCount": 10,
    },
    "TimeZone2DelimiterImage": 409,

[TedwardCz]

TimeZone1 and TimeZone2 won't work without "TimeZone1DelimiterImage" / "TimeZone2DelimiterImage".

I actually have a delimiter in there. It's a 1px wide blank space.

[Hoekstra]

TimeZone1 and TimeZone2 won't work without "TimeZone1DelimiterImage" / "TimeZone2DelimiterImage".

I actually have a delimiter in there. It's a 1px wide blank space.

Hmm, did you also use all the above mentioned parameteres?
Maybe you can share your .bin so someone can take a look at it.

Some things don't work well together on these watchfaces (firmware bugs).

[TedwardCz]

Some good news! I tinkered for about a dozen iterations, and finally got the TimeZone1 and TimeZone2 to work. I have no idea what I did that finally resolved it, but it's now working. Next trick, and this one would be really nice, is to get the UV index working. Currently, when I add the properties for UVIndex, the entirety of the Weather property breaks (doesn't display). In comparing UVIndex to Wind (which is working), I notice that the syntax is a bit different. Wind has "Wind{Text{data},ImageSuffixEn}" whereas UVIndex has "UVIndex{UV{Text{data},SuffixImageIndex}}". When I make UVIndex's syntax match Wind's, the packer throws an error, though. Anyway, if you'd be willing to take a peek, I'm including a Google Drive link. contrast3 (no UVI) works, contrast4 (with UVI) does not.

https://drive.google.com/drive/folders/ ... sp=sharing

[lvpokka]

TedwardCz probably to many objects to display

btw DO not use v4.1.0 version of app, its ONLY for mi band 6, you should use v2.1.6 version for Mi band 5!!!! or you can brick your MiBand

[noaheist]

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

Will watch face preview be added for mi band 6

[Hoekstra]

Some good news! I tinkered for about a dozen iterations, and finally got the TimeZone1 and TimeZone2 to work. I have no idea what I did that finally resolved it, but it's now working. Next trick, and this one would be really nice, is to get the UV index working. Currently, when I add the properties for UVIndex, the entirety of the Weather property breaks (doesn't display). In comparing UVIndex to Wind (which is working), I notice that the syntax is a bit different. Wind has "Wind{Text{data},ImageSuffixEn}" whereas UVIndex has "UVIndex{UV{Text{data},SuffixImageIndex}}". When I make UVIndex's syntax match Wind's, the packer throws an error, though. Anyway, if you'd be willing to take a peek, I'm including a Google Drive link. contrast3 (no UVI) works, contrast4 (with UVI) does not.

https://drive.google.com/drive/folders/ ... sp=sharing

There was something with UV/Wind not working together with temperatures or something.

[Walker_Alan]

Hey everyone!

lvpokka thanks for creating an awesome tool. Any plans to add PAI Progress? I was trying to add a circular progress bar but it seems like only text PAI is supported.

[lvpokka]

Hey everyone!

@lvpokka thanks for creating an awesome tool. Any plans to add PAI Progress? I was trying to add a circular progress bar but it seems like only text PAI is supported.

Is there any stock watchface with Pai progress??

[Walker_Alan]

Hey everyone!

@lvpokka thanks for creating an awesome tool. Any plans to add PAI Progress? I was trying to add a circular progress bar but it seems like only text PAI is supported.

Is there any stock watchface with Pai progress??

I have searched for it in mi band 5 and 6 custom watchfaces but what I have found is only PAI in numbers not in a progress bar. Default mi band 6 watchface shows PAI progress.

Also, I have found that Amazfit X json supports that as “PaiProgress”. I suppose it's just wasn't added to your tool and maybe you have any plans to add it? That would be really great to have it

[lvpokka]

I will not add items that are not in stock of the watchfaces