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]

[hyippiemon]

Maybe I found a bug

I have the problem, that in one of my watchfaces i recognize a difference of the battery icon positions between preview and live picture on the band. I think 2 pixels to the left on the band.

Battery icon is the colored dash in the middle.

Numbers have all the same size.

"Status": {
"Battery": {
"BatteryConfig": {
"BoxWidth": 0,
"Alignment": 0,
"Order": 0
},
"Icon": {
"X": 46,
"Y": 122,
"ImageIndex": 31,
"ImagesCount": 9
}
}
}

The attachments show what I mean.

Maybe an error on my side?

Please take a look!

Thanks

Spoiler

preview generated with MiBandWFTool

unnamedbig_blue_german_packed_static.png (2.31 KiB) 查看 31115 次

Image took with my smartphone

IMG_20190904_064921.jpg (699.11 KiB) 查看 31115 次

[lvpokka]

I think 2 pixels to the left on the band.

As i see there is shift for 1 px for Date and 1 px shift for battery... didn't saw this previously) maybe it's some miscalculations in alignments.Not critical, probably will shift back in next release.

Thx

[hyippiemon]

thanks, yes, seems to be an alignment (Center) issue

took "Left" now -> no difference between preview and live picture

[hammad497]

Hey I am having a problem. After following the procedure stated above i was able to generate a .bin file. After placing it in the respective folder i tried to sync the watch face in the mi fit app. But the app is stating "could not sync". I feel like i am making a dumb mistake. Can someone guide me? Thanks in advance.

[MonsterDruide1]

[mention]hammad497[/mention]

This error can have many sources, maybe try to add a preview into the folder so that you know it really is the correct watchface.

Also, did you generate the .bin with the Palette-Image mode or with the Raw-Mode? Try to do it with the Palette image mode, so there aren't too big/deep pictures.

[lvpokka]

Hey I am having a problem.

99% size off your watchface is higher then 320kb

[hammad497]

Thanks guys! The problem was the size of the WF. Used the palette mode and it worked. Thanks again!

[stqcb]

Hi there,

I'm having a similar problem as hammad497. I can confirm that for my problem it is indeed the size. But my question is, how do I get the size down.

When I try palette image mode it gives me the following error "This image is using too many palette colors. Please make image less colorful or use RAW". But when I try raw mode the total size with the changes I made is 492kb.

But here's the thing. The original .bin I'm working off of is 233kb. I tried simply dragging that to watchface.exe then immediately dragging the .json file from the uncompressed folder, completely unchanged, back to watchface.exe and the new .bin file is 402kb. How come the new file is so much larger even though there were no changes made to the .json code, or any of the images?

Again, I can't use palette mode because it gives me the above error.

Thanks for the help.

[lvpokka]

README) please check palette mode and raw.cfg

[stqcb]

README) please check palette mode and raw.cfg

I assume you're talking about this part of the readme? "create file raw.cfg with content 1,4,2,5,66 (near .json) to force raw image mode for selected image IDs in raw.cfg"

I don't really know much about coding or anything so I don't know exactly what that means or how to do it.

[Dario]

.....

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)

(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!

Download

[mention]GIK-Team[/mention] where is it possible to find version 1.3.8 ?
I have read that it is the best version (I have already tried other versions and other modified programs but they are full of bugs )...
I wanted to change the days (replacing them with those in Italian) in the bluegreen whatchface of [mention]lazimk[/mention] ...
Thank You
Bye

[lazimk]

Hi there,

I'm having a similar problem as hammad497. I can confirm that for my problem it is indeed the size. But my question is, how do I get the size down.

When I try palette image mode it gives me the following error "This image is using too many palette colors. Please make image less colorful or use RAW". But when I try raw mode the total size with the changes I made is 492kb.

But here's the thing. The original .bin I'm working off of is 233kb. I tried simply dragging that to watchface.exe then immediately dragging the .json file from the uncompressed folder, completely unchanged, back to watchface.exe and the new .bin file is 402kb. How come the new file is so much larger even though there were no changes made to the .json code, or any of the images?

Again, I can't use palette mode because it gives me the above error.

Thanks for the help.

I have a workround for this. a curvy path. (pack to RAW in 1.3.9, unpack with v1.3.6, then pack same with PALETTE 1.3.6, unpack with 1.3.9, pack again with PALETTE 1.3.9, its just to make sure jsons are in correct format)
I am gonna request this to be included as an option/feature in next version (posterize option)

[lazimk]

[mention]lvpokka[/mention]
In v1.3.8 and v1.3.9 (i think in both) when raw files are packed with PALETTE exe, it gives error (saying it uses too many colors, use raw.cfg), But in 1.3.6 it somehow posterizes/compresses the image to certain number of colors in palette. I have used this as a workaround in my works.

This is my request to add 'Force posterizing / paletting' as an option (0 or 1) for palette mode exe (on .config maybe).
This should not affect images in raw.cfg
This option will be helpful for ppl who want to include animation in wf and optimize size.
Please include this option in next version.

[GIK-Team]

[mention]GIK-Team[/mention] where is it possible to find version 1.3.8 ?
I have read that it is the best version (I have already tried other versions and other modified programs but they are full of bugs )...
I wanted to change the days (replacing them with those in Italian) in the bluegreen whatchface of [mention]lazimk[/mention] ...
Thank You
Bye

[lvpokka]

[mention]lazimk[/mention] sooo 1.3.6 just allowing to user more than 256 colors or its making image quality lower? there is certain limit and lag on MiBand4, could you please show background images after 1.3.9 raw and 1.3.6 after your tricks

p.s there is some problems if allow to use more palette colors(its just black, or not showing), did you test on miband4?.

[lvpokka]

[mention]Dario[/mention] i have more then 5 testers which is creating watchfaces on daily bases) could you explain where you have bugs in 1.3.9(better than 1.3.8)

[lazimk]

[mention]lvpokka[/mention]
v1.3.6 palette mode makes image quality lower (it doesn't say user that a particular image cannot be used). I lowers quality by palettizing image to certain number of colors (like Posterizing).
In v1.3.9 palette mode, tool doesn't posterize image, but says user to use an image with less number of colors.
(Mi band 4 can support 16mil colors, But heavy WFs make band laggy)

I am attaching 3 pictures here (same frame).
1) RAW (17.5 kb) has many colors
2) Posterized by v1.3.6 (14 kb)- has less number of colors in color palette, (compare both images)
3) Manually Posterized (6 kb) - has very few colors.

The feature i mentioned, if it can give an option to posterize images (on/off), if on, to a number of colors (user inputted number, like 64,128,256), it could be used to optimize WF size.

[lazimk]

[mention]lvpokka[/mention]
Also, In addition (as suggestion),
In generated previews, animations included in WF are repeating again and again even if i set RepeatCount = 1.
If Generated Preview could follow Repeat count , it would be nice

[lvpokka]

[mention]lazimk[/mention] please check in 1.3.6 logs, is there message "[WARN] This image is using too many palette colors" because in 1.3.6 there was only warning but you get lucky, because i think it's cropping needed colors.
Yest it's support 16m colors) BUT In raw mode ;D

Please check how many colors its writed in bin
Trace|Palette item 369: R 78, G 74, B 70
what is the max number

upd.
Your definitely wrong but very lucky!
Just tested and found 1 bug and 1 new solution)) you can try to test and use some random "photo", it will become black)
BUT!!! i found bug, and currently on your example your JUST using 8bit image, so if you will convert in paint.net your image in 8bit, you will get even better result.

[lazimk]

@lazimk please check in 1.3.6 logs, is there message "[WARN] This image is using too many palette colors" because in 1.3.6 there was only warning but you get lucky, because i think it's cropping needed colors.
Yest it's support 16m colors) BUT In raw mode ;D

Please check how many colors its writed in bin
Trace|Palette item 369: R 78, G 74, B 70
what is the max number

upd.
Your definitely wrong but very lucky!
Just tested and found 1 bug and 1 new solution)) you can try to test and use some random "photo", it will become black)
BUT!!! i found bug, and currently on your example your JUST using 8bit image, so if you will convert in paint.net your image in 8bit, you will get even better result.

Ah bro.
Yes.. I always used PNG-8 (8-Bit) images (thinking it would reduce packsize for Raw) . Maybe thats why i got lucky.
So, if it is planned to include that feature, palette exe might want to export pics to PNG 8bit, and apply posterization i guess.

[MonsterDruide1]

[mention]stqcb[/mention]

The problem is as stated by the program, tat your image uses too many colors for palette mode, the palette size has to be decreased. To do so, the simplest way is to convert the images with "too many colors" (the index is named in the error) to an indexed image and then back. Use programs like Photoshop/Gimp or online-tools.

[stqcb]

[mention]MonsterDruide1[/mention]

Thanks! I was doing some trial and error and managed to get it working in a similar way you described. Except I used the posterize feature to change the image instead.

I still don't understand the part about raw.cfg though. But since I got it working I'll just stick with it.


[mention]lazimk[/mention]
I completely missed your response earlier because of all the new posts since the last time I checked. Thanks for that advice.

Funny thing is. The watch face that I made some adjustments to and am currently using is one of yours. The Samsung Galaxy Active Bloodred WF. I changed the months to show letters instead of numbers. Thanks for the great work creating it.

[lvpokka]

Tomorrow will be new version release.
- Added image Quantization algorithm, it will compress image if it will have too much palette colors.

Hope no one will use Raw wf builder)

[infinityio]

This is probably a slightly strange one, but I think I have found a bug in the compiler that prevents animations from working as intended - From my experiments, it seems that watch faces with a second hand are unable to run animations and will instead leave them static on the first image in the series. Has anyone else found this an issue or a workaround for it? I have attached a working copy of my watch face where animations do not work as intended
Thanks

[lvpokka]

speed should be 5 or more, thats my testing. maybe another parameters will affect somehow

btw Seconds now working fine!