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]

[Sonpham1710]

Help me move to bin file

1d rv. ms/u/s!AiC4WsYy1-I5wUWW_kiiFjRjSWrH?e=McwNDo

delete space

[Maikeldevil]

Help me move to bin file

1d rv. ms/u/s!AiC4WsYy1-I5wUWW_kiiFjRjSWrH?e=McwNDo

delete space

Have you seen your question? I really dont understand what you want..

[lumenvindex]

Help me

Code: Select all

Watchface is greater than 321kb, it will not be accepted by Mi Band 4, please reduce size! Current size:2752kb.

Your animation frames are way too large. You need to animate only 26*10 pixels but your frames are 120*240. Cut off all unnecessary pixels, move the frame by editing your json here:

Code: Select all

  "Other": {
    "Animation": {
      "AnimationImage": {
        "X": 0,      <----------------------------
        "Y": 0,      <----------------------------

[Kierian]

Hi,
I'm making my first watchface and everything works fine except the preview. (I've used 1.4.1 version)
I have no clue why but my preview, png and gif, are "zoom in". (I'm on windows 10 if it matters)
I'm pretty sure that this problem happened after I used indexed color (but no idea if it is related)
This doesn't affect the preview I got directly from the bin file. (preview's displayed correctly when i upload the bin file on an Android app, it only affect the png & gif files generated by the software when building the bin file on windows 10)
Is it something well-known ? (that's no biggie but if i do something wrong that I can easily fix by myself, I would do it)
Thanks for your help !

[lumenvindex]

my preview, png and gif, are "zoom in"

It happens because your images have other than 96 DPI resolution. This issue should be fixed in the next version of the tool.

[Kierian]

Ok, many thanks.

[infernalcombustion]

Is it possible to have both Linear and Circle displays under StepsProgress at the same time?

I made a skin that uses both, the .bin file was created with no error, and the animated sample displays both the Circle and Linear tracker changing. But when I actually put it on my Mi Band, only the Circle tracker changes, and the Linear one doesn't change from the default state.

[lumenvindex]

Is it possible to have both Linear and Circle displays under StepsProgress at the same time?

No. Because...

when I actually put it on my Mi Band, only the Circle tracker changes, and the Linear one doesn't change from the default state.

[infernalcombustion]

Ok, well that's disappointing.

Is it possible to correlate either the Linear or Circle trackers under a different value like Distance or Calories instead?

[lumenvindex]

Is it possible to correlate either the Linear or Circle trackers under a different value like Distance or Calories instead?

Yes and No.
We cannot change correlation, at least not on a watchface level.
But Distance and Calories values are derived from the Steps value. And hence they are all correlated.

[technofab]

2 questions:
a) where I can find all XML Specifications and possibilities? Thanks in advance.
b) the sintax must be the same as other app? So unpack with WatchFace.exe -size120x240 band.bin and pack with WatchFace.exe -size120x240 band.json commands???

[lumenvindex]

a) where I can find all XML Specifications and possibilities? Thanks in advance.
b) the sintax must be the same as other app? So unpack with WatchFace.exe -size120x240 band.bin and pack with WatchFace.exe -size120x240 band.json commands???

a) It's JSON, not XML. Haven't seen any relevant specs in english. Got this thing:

english.zip

(2.58 KiB) Downloaded 234 times

but some sections have changed their syntax since then (you can learn about some of the changes in README file).
b) Unpack with WatchFace.exe band.bin and pack with WatchFace.exe band.json.

[technofab]

Sorry you are right, is JSON, rofl
Thanks for the documentation!

[headgamer]

So I follow these instructions, drag the .bin file to the .exe file... a DOS window pops up and starts unpacking everything and generating previews... then the window disappears. Nothing. I don't have any window or anything showing unpacked files. What am I doing wrong here? I am using the latest version of the app here in this thread.

-Sean

[lumenvindex]

I don't have any window or anything showing unpacked files.

That's it, the program only unpacks the binary to nearby folder. If you have C:\Watchfaces\keanu.bin it will be unpacked to C:\Watchfaces\keanu\.

[steak]

Can someone tell me how to perform the step 6 with an iPhone ?

[hyippiemon]

Hi,

the time delimiter isn't working on my band on the old firmware 1.0.5.66!
The preview gif shows the symbol, on the band it isn't shown.
I tried my own watchface (in development) and this one: https://amazfitwatchfaces.com/mi-band-4/view/7989

Please review this!

Thank you!

[lumenvindex]

time delimiter isn't working on my band on the old firmware 1.0.5.66

This feature works on more recent firmwares only. There is nothing else you can do about it but update the band.

[hyippiemon]

thanks, then I use the old method by integrating in the background

[CydPL]

Hi!
Thank you for your work!
Thanks to you I just prepared watchface exactly as I wanted to have.

I woud like to report a minor bug in generating animated gif.
StepsProgress > SolidImage is generated just like I would think it works (and I thought it was), but in miband it works just an opposite way.
So it is not covering background from start to end, but in fact it is fading from start to end along with progress (interesting choice from mi developers).
You can check it in watchface uploaded by me with gif generated by your tool.
https://amazfitwatchfaces.com/mi-band-4/view/8540

Anyway. It is great that someone commits his free time to do stuff like that

Regards,
Cyd

[geocool]

I found the source code of AmazfitBipTools but I can't find the source code of MiBandWFTool.
Is it uploaded somewhere ?

[ValeCrafter]

Hey guys

I have a problem with the animation.
The animation don't run on the Mi Band 4. In the gif the animation runs normaly.
But as soon as I sync the watch face with my Mi Band 4 it stays still.
Do someone knows what to do with this problem?

Kind regards
ValeCrafter

[lumenvindex]

it stays still.

Current MiBand firmware plays animation only when Speed parameter isn't less than 4.

[franluciani]

Hi!
I'm having problem with the hours, tens and ones.
I want move to the right the numbers of "tens" everytime that "ones" show the number 1. For example:
_1_0
__11
_1_2
_1_3
...
I tried adding the number 1 of the "tens" in the number 1 of the "ones" but when the "tens" show 2 it looks bad. I tried too add black into the "ones" to cover the "tens" and it not work for all numbers.

I'm creating the watch face of Apple (numerals duo, numerals mono (numbers arabic and roman). The only thing that left to give that it looks same is it. If i can solve this, i will upload all the apple faces that i' creating.

Please if anybody can help me, i will appreciate it very much

[nite]

Can someone tell me which folder to put the modified .bin file into? :/
Unfortunately, the "corresponding directory " part of this message means nothing to me. "Copy the newly generated bin file to the corresponding directory of the mobile phone"