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]

[hist]

Hello!

For some reason whenever I try to open the application it just pops up for a second than closes tried all the downloadable versions.
Could someone tell me if I also need to install something else in order to run the application?

Thanks,
Hist

[lvpokka]

[mention]hist[/mention] PLEASE read Carefully !!!
3. Drag the .bin file to WatchFace.exe (in step 1. , get the decompressed file)

[hist]

ohh sorry. thanks for the fast answer

[noooooo]

I successfuly decompiled, modified and recompiled an amazfit bip res using the mi band 4 tool watchface.exe. As the original amazfit tools is not update and it will lead to errors if used. It can cause a brick using a res modified with this tool in my amazfit bip? Do you know if an updated version of amazfit tools for amazfit bip exists?

[lvpokka]

[mention]noooooo[/mention] ???? Whaaaat ))) How do we should know in Mi Band 4 forum section... Mi band 4 tool is only for mi band 4 tool...

[noooooo]

@noooooo ???? Whaaaat ))) How do we should know in Mi Band 4 forum section... Mi band 4 tool is only for mi band 4 tool...

I'm asking the dev, as the base of the decompiler is the same as the amazfit bip One, Just with an higher number of colours available

[lvpokka]

There is also different structure of objects, and yes, mi band 4 allow HQ images to be used... That's mean that Bip is not supporting that king of image... Therefor restrictions are used for Bip

[noooooo]

There is also different structure of objects, and yes, mi band 4 allow HQ images to be used... That's mean that Bip is not supporting that king of image... Therefor restrictions are used for Bip

Many thanks, do you know if an updated version compatible with amazfit bip Is present somewhere? Sorry for the OT, I will close it here

[jfernandezcaro]

Where is located a full-list of accepted commands and how to use them?

In other hand, Animations are supported but in TOP of all. Could be possible to support Background animations? (so numbers and icons can be on top of it)

[lvpokka]

[mention]jfernandezcaro[/mention] we also testing this option, but no luck... animation will always be on top for now

[jfernandezcaro]

I found out a complete list of accepted parameters on a chinese forum called bandbbs. Attached, I hope it helps:
It contains 2x json files. One with Chinese explanations, another in plain format.
Also a picture showing how it looks like.

[pagdot]

I found out a complete list of accepted parameters on a chinese forum called bandbbs. Attached, I hope it helps:
It contains 2x json files. One with Chinese explanations, another in plain format.
Also a picture showing how it looks like.

I've translated the notes to english (using Google Translate), but couldn't find a meaningful translation for the last line:

offset coordinate 指的是被遮住后offset 的coordinate ，在复联四表盘中有体现，各位可以试试

[yzx_28]

I found out a complete list of accepted parameters on a chinese forum called bandbbs. Attached, I hope it helps:
It contains 2x json files. One with Chinese explanations, another in plain format.
Also a picture showing how it looks like.

I've translated the notes to english (using Google Translate), but couldn't find a meaningful translation for the last line:

offset coordinate 指的是被遮住后offset 的coordinate ，在复联四表盘中有体现，各位可以试试

I am the author of this document, I am honored that you use it to perfect the unpacking tool. I don't fully understand the "offset coordinate" that you said. But my friend, after a lot of tests, he knows "offset coordinates". After a while I will do a series of tests. I will tell you the results when I finish.
I said "在复联四表盘中有体现，各位可以试试" means the performance in the special version of the Avengers's Xiaomi Band 4
I don't know which version will be released in countries other than China.
Although I don't know the specific principle of it, I can tell you that the icon (power, Bluetooth, do not disturb) on this version of the dial will move, which is related to X2 Y2.
I want to ask a question, can you find a way to solve the problem of not displaying the weather?
Thanks
My English is not so good, so I used Google Translate

[luka97]

I'm at a loss. After 3 hours of searching and trying different combinations I still have some problems with my watchface (attached below)

• The day of week is off by one (today should be MAR (tuesday) but it shows MER (wednesday)
• The activity bar (the pink bar) is never full, it stops at 80%
• The status icons (Bluetooth, Dnd and Lock) are not displayed correctly (activating DnD show the lock icon, locking the display doesn't show any icon)
• Some glitches in the GIF preview that I was not able to test on the device like one of the activity progress icons is shown over the battery bar (the purple bar) and the first image of the battery bar (under 10% battery) is shown over the orange ruler

The json should be correct as I triple checked it. Thanks in advance to everyone that is able to help me.

[lvpokka]

@l[mention]luka97[/mention] check image 34, it's not used but its shifting all images to +1))))

it's easy to check it in logs

Codice: Seleziona tutto

Trace|Loading image 33...
Trace|Image was loaded from file .\custom\0033.png
Trace|Loading resources for 5 'Date'
Trace|Loading resources for 5.1 'MonthAndDay'
Trace|Loading resources for 5.1.1 'SeparateMonthAndDay'
Trace|Loading resources for 5.1.1.1 'Number'
Trace|Loading resources for 5.1.1.1.5 'TextAlignment'
Trace|Loading resources for 5.1.1.3 'Number'
Trace|Loading resources for 5.1.1.3.5 'TextAlignment'
Trace|Loading resources for 5.1.3 'Boolean'
Trace|Loading resources for 5.1.4 'Boolean'
Trace|Loading resources for 5.2 'ImageSet'
Trace|Loading image 34...
Trace|Image was loaded from file .\custom\0035.png

[luka97]

Thank [mention]lvpokka[/mention], that was it. I checked the log for errors but there were non that mattered, and I ignored everything else since the log is so long. Maybe an unused image should fail the build, or at least give some kind of warning.

[lvpokka]

Wf creation only for best of the best Im helping users with good WFaces or ideas, hate this 100500 Wf with just changed background e.t.c

[marcmc]

I am creating a watchface but the status icons don't work. I tried everything ant I don't see any error in the logs... I attach the folder, any help will be appreciated.

[NikGud]

Wf creation only for best of the best Im helping users with good WFaces or ideas, hate this 100500 Wf with just changed background e.t.c

Hi! i have some problem with temperture on my WF. Maybe i make it with mistake?
Can you check it?
https://amazfitwatchfaces.com/mi-band-4/view/1383

p.s.
(sorry for my bad english))

[lvpokka]

[mention]NikGud[/mention] temperature not working for now...
[mention]marcmc[/mention] user for all statuses x2=12 y2=0 x3=1 and you have allot of problems with coordinates and positioning

[marcmc]

@NikGud temperature not working for now...
@marcmc user for all statuses x2=12 y2=0 x3=1 and you have allot of problems with coordinates and positioning

I tried doing this in all statuses and still don't work Also... what kind of problems with coordinates and positioning? I did everything based on other watchfaces adapting it to my design...

[ColinLaughton]

Hi all,

I want to completely create a wf using this tool initially to unpack the bin file, edit the images and alter the json file so I have full control of image placement. I mean, where the time, steps, battery etc are in the finished face.

Is there a recommended way to do this?

Is there existing software to assist?

I use windows (regrettably) so not sure if anything is out there yet.

I’ve opened the json file in notepad but wonder if this is suitable.

Thanks,

Col

[Bartosz066]

Hi all,

I want to completely create a wf using this tool initially to unpack the bin file, edit the images and alter the json file so I have full control of image placement. I mean, where the time, steps, battery etc are in the finished face.

Is there a recommended way to do this?

Is there existing software to assist?

I use windows (regrettably) so not sure if anything is out there yet.

I’ve opened the json file in notepad but wonder if this is suitable.

Thanks,

Col

Use MiBandWFTool_1.3.6.zip. Read README.txt.

Notepad is ok but you can use notepad plus plus.

Wf creation only for best of the best Im helping users with good WFaces or ideas, hate this 100500 Wf with just changed background e.t.c

I'm terrible in drawing. Can you make for me some graphic? I would like to change icons to text: km, steps and bpm. And you are welcome to make improvements

https://amazfitwatchfaces.com/mi-band-4/view/1278

[coolmyll]

Using version 1.3.6 i am getting this error when i tried to make an animated watchface:

Error|[WARN] This image is using too many palette colors. Please make image less colorful.

The final .bin cannot be synced to the band.

[coolmyll]

Could someone help me? I can't solve it...

Error code 1:
Trace|8 'Status'
Debug|Generating previews...
Error|[ERROR] error while rendering
Error|[ERROR] error while rendering (...)

Error code 2:
Error|[WARN] This image is using too many palette colors. Please make image less colorful.

I have used indexed mode of GIMP-255 colors but it is not solved.
Thanks

I managed to solve it by saving it as 8bit and in PaintNET. Also i replaced transparency with black color but i dont know if that has anything to do with it fixed.