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]

[MrMuesLee]

Thank you ... your idea kind of solved the problem, open and closing tha app didn't changed anything ... but after a full reboot it started to synced again

sorry that for falsely claiming that there is a bug

[lvpokka]

Yes, reboot helps in some cases.

I have BIG PLEASE FOR ALL. Please, do not compare custom with INTERNAL watchfaces because its not a watchface it's a program. You can compare ONLY with custom from Xiaomy MiBand official store. If Xiaomy custom watchface is not working that is problem of MiBand (please restart for double check)

Big thx)

[Lienarhba]

Hi, lvpokka , this tool is looks great but , I can't download it . It says that the maximum number of downloads has reached .
Please help.

[lvpokka]

have no idea, i can download it here... maybe we need to ask Admin GIK-Team

[Lienarhba]

I tried downloading it again and it just worked . Thanks . Best and the greatest tool ever made for Mi band watchfaces . Once again thank you so much lvpokka

[GIK-Team]

Lienarhba, we have no limits. If you have any problems, please contact us.

[Lienarhba]

@Lienarhba, we have no limits. If you have any problems, please contact us.

I was able to download it .

[23ll]

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.

bin and gif files in attachments.
here is my codes. all images transparent and same size correct position.

"HeartProgress": {
"Linear": {
"StartImageIndex": 94,
"Segments": [
{
"X": 12,
"Y": 192
},
{
"X": 12,
"Y": 192
},
{
"X": 12,
"Y": 192
},
{
"X": 12,
"Y": 192
},
{
"X": 12,
"Y": 192
},
{
"X": 12,
"Y": 192
}
]
}
}

I have the exact same problem, the first heart rate bar triggers at 100 bpm instead of 80 and so on, did you manage to find a workaround?

[lvpokka]

Does anyone have the right weather icon sequences with explanations of each weather? I checked 2 watch faces in the ...

Please use different thread for this question, its not the right topic... its not a bug

[diopter]

I can't get 2 small animations running at different speeds on the MI Band 5.
Both always run at the slower speed.
If I put both of them on the fast speed, they'll both run fast.
Is this a firmware bug or could it be that MiBandWFTool does not write the parameters correctly into the .bin file?

[lvpokka]

...
Is this a firmware bug or could it be that MiBandWFTool does not write the parameters correct into the .bin file?

No idea, you can play with animation parameters as Speed little bit more...
check https://amazfitwatchfaces.com/mi-band-5/view/292

btw if you can proof that statement with comparing stock watchfaces and stock watchface after rebuild with no changes, then this message will looks more qualified

[diopter]

There are no stock watchfaces with 2 different animation speeds.

Could you fix the "DelimiterImage" preview bug ?

[lvpokka]

1)There are no stock watchfaces with 2 different animation speeds.
2)Could you fix the "DelimiterImage" preview bug ?

1) there is, if element exist, then i took it somewhere
(ex. here, but i cant find bin

Spoiler

76a0ad54bbf3d8b27a6b7d2e448786951591778642020.png (22.05 KiB) Exibido 38021 vezes

2) will be fixed in next build

[diopter]

OK, animation speed IS a firmware bug, sorry.

But:

Unpacking stock WF "Aurora Glass":

Código: Selecionar todos

Trace|12.2.3 'ImageIndex': 63
Trace|12.2.4 'ImagesCount': 6
Debug|Generating previews...
Error|System.NullReferenceException: Der Objektverweis wurde nicht auf eine Objektinstanz festgelegt.
   bei WatchFace.Parser.Models.Elements.Battery.PulseImageSetElement.Draw(Graphics drawer, List`1 images, WatchState state)
   bei WatchFace.Parser.Models.Elements.ContainerElement.Draw(Graphics drawer, List`1 images, WatchState state)
   bei WatchFace.Parser.Models.Elements.ContainerElement.Draw(Graphics drawer, List`1 images, WatchState state)
   bei WatchFace.Parser.PreviewGenerator.CreateFrame(IDrawable watchFace, List`1 resources, WatchState state)
   bei WatchFace.Parser.PreviewGenerator.<CreateAnimation>d__0.MoveNext()
   bei VxevgnPEK1LvCeXIub.WhqXyRnXCUjjFRCmTS.zL7wBH6jh(List`1  , List`1  , String  , String  , Int32  )
   bei VxevgnPEK1LvCeXIub.WhqXyRnXCUjjFRCmTS.XBXnUmtOw(String  )
Debug|Exporting resources to 'D:\MI_Band\_MI\Aurora_Glass\Aurora_Glass'

No GIF created.
Aurora_Glass_static.png:

Spoiler

[diopter]

MiBandWFTool preview shows not the same alignment as MB5 with "Alignment": "BottomXXXX".
On MB5 then decimal point and the km are bottom aligned, in preview not.
DecimalPointImage is 3x3, KmSuffixImage is 20x12, digits are 9x16

[lvpokka]

Unpacking stock WF "Aurora Glass":

Código: Selecionar todos

Trace|12.2.3 'ImageIndex': 63
Trace|12.2.4 'ImagesCount': 6
Debug|Generating previews...
Error|System.NullReferenceException: Der Objektverweis wurde nicht auf eine Objektinstanz festgelegt.

No GIF created.

Please provide bin file, have no issue with it

Spoiler

c5d48abb75725fda5686baf20c7497be_animated.gif (414.18 KiB) Exibido 38013 vezes

MiBandWFTool preview shows not the same alignment as MB5 with "Alignment": "BottomXXXX".

Also would be nice to have bin, i already saw this problem, thx

[23ll]

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.

I am thinking to do like that as well, but I don't like the fact the first indicator will be always on also if heart rate is not recognised

[diopter]

In Current_Speed you can see the bottom alignment problem. Look on the decimal point.
The km looks OK here, because the km image has the same height as the digits.
The bug occurs only if a prefix/suffix/delimiter image has a height different from the digits height.

Spoiler

Currently I'm working on an "All in One" WF. Can you help me with the tomorrow temperatures and AirQuality/AirQualityIndex?

[rajmund_zarny]

hello i'm new to this site

I have a problem with the GIF generator and the screenshot from my project.
it shows the unreal size of some png

I connect link to my project to check where is the problem
https://amazfitwatchfaces.com/search/mi ... rID/325969

[lvpokka]

it shows the unreal size of some png

DPI of all images should be 96

[rajmund_zarny]

it shows the unreal size of some png

DPI of all images should be 96

Ha
I did't thought about it.
Thanks for help

[diopter]

Pulse: NoDataImage is not shown in preview.

[lvpokka]

Pulse: NoDataImage is not shown in preview.

fixed for new version

[lvpokka]

there's still something wrong with the battery.
I'l revise again tomorrow, to see if I can get it fully functional.

This is not right place for watchfaces, this thread only about bugs.

P.s use only 10 images for battery

[deiG]

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.