Page 4 of 26
MiBandWFTool
Posted: 08 Jul 2019, 12:57
by 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!
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]
Re: MiBandWFTool
Posted: 15 Jul 2019, 11:04
by 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
Re: MiBandWFTool
Posted: 15 Jul 2019, 11:29
by lvpokka
[mention]hist[/mention] PLEASE read Carefully !!!
3. Drag the .bin file to WatchFace.exe (in step 1. , get the decompressed file)
Re: MiBandWFTool
Posted: 15 Jul 2019, 11:47
by hist
ohh sorry. thanks for the fast answer
Re: MiBandWFTool
Posted: 15 Jul 2019, 12:00
by 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?
Re: MiBandWFTool
Posted: 15 Jul 2019, 13:38
by 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...
Re: MiBandWFTool
Posted: 15 Jul 2019, 13:42
by noooooo
lvpokka wrote: 15 Jul 2019, 13:38
@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
Re: MiBandWFTool
Posted: 15 Jul 2019, 14:17
by 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
Re: MiBandWFTool
Posted: 15 Jul 2019, 14:36
by noooooo
lvpokka wrote: 15 Jul 2019, 14:17
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
Re: MiBandWFTool
Posted: 15 Jul 2019, 17:40
by 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)
Re: MiBandWFTool
Posted: 15 Jul 2019, 18:37
by lvpokka
[mention]jfernandezcaro[/mention] we also testing this option, but no luck... animation will always be on top for now
Re: MiBandWFTool
Posted: 15 Jul 2019, 19:23
by 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.
Re: MiBandWFTool
Posted: 15 Jul 2019, 20:58
by pagdot
jfernandezcaro wrote: 15 Jul 2019, 19:23
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 ,在复联四表盘中有体现,各位可以试试
Re: MiBandWFTool
Posted: 16 Jul 2019, 07:52
by yzx_28
pagdot wrote: 15 Jul 2019, 20:58
jfernandezcaro wrote: 15 Jul 2019, 19:23
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
Re: MiBandWFTool
Posted: 16 Jul 2019, 18:20
by 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.
Re: MiBandWFTool
Posted: 17 Jul 2019, 08:50
by 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
Code: Select all
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
Re: MiBandWFTool
Posted: 17 Jul 2019, 12:00
by 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.
Re: MiBandWFTool
Posted: 17 Jul 2019, 12:03
by lvpokka
Re: MiBandWFTool
Posted: 18 Jul 2019, 18:05
by 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.
Re: MiBandWFTool
Posted: 18 Jul 2019, 18:36
by NikGud
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))
Re: MiBandWFTool
Posted: 19 Jul 2019, 07:39
by 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
Re: MiBandWFTool
Posted: 19 Jul 2019, 11:42
by marcmc
lvpokka wrote: 19 Jul 2019, 07:39
@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...
Re: MiBandWFTool
Posted: 20 Jul 2019, 12:14
by 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
Re: MiBandWFTool
Posted: 21 Jul 2019, 04:42
by Bartosz066
ColinLaughton wrote: 20 Jul 2019, 12:14
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.
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
Re: MiBandWFTool
Posted: 24 Jul 2019, 19:22
by 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.
Re: Two errors/warnings
Posted: 24 Jul 2019, 20:21
by coolmyll
ormaken wrote: 24 Jul 2019, 17:23
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.