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]

[BatataNoFrita]

Hello, really like the work being done here,

May I join the beta? Thanks

[Ybruz]

Looks great, can I join the beta please? I'd love to create some watch faces for my new mi band 5

[lvpokka]

Mi band 5 tool released from beta. Link added to topic

[urieleugenio]

Mi band 5 tool released from beta. Link added to topic

That's awesome, I'll take a look during this weekend!

[elhombremaquina]

Mi band 5 tool released from beta. Link added to topic

Thank you!!!

[Chapi666]

My antivirus software don't like "WFPreview.exe".
It says that it's a trojan. It detects it as "HEUR:Trojan.Win32.Generic".
Is it a false positive ?

[lvpokka]

My antivirus software don't like "WFPreview.exe".
It says that it's a trojan. It detects it as "HEUR:Trojan.Win32.Generic".
Is it a false positive ?

Try https://www.virustotal.com/gui/home )) have no idea about it, its simple and clean program. you can remove it if you don`t trust it, it actually do nothing important)

[Yife Playte]

It's great to see the updated tools. but hey, could you please give me a sample json for band 5 which have all elements included? That'll be helpful.

[Goublin]

Hello everyone, I have tried to decompress and re-compress the same .bin without modifying anything with the Mi Band 5 WF Tool version
v2.1.4 and it gives me error, don't create the .bin
Why is this happening?
I have tried modifying the .bin and unmodified and it gives me the same error.

Fatal|[ERROR] Watchface is greater than 615kb, it will not be accepted by Mi Band 5, please reduce size! Current size:866kb.
Fatal|System.ArgumentException: [ERROR] Watchface is greater than 615kb, it will not be accepted by Mi Band 5, please reduce size! Current size:866kb.
en AKJgAM2UjJeDpEamRk.hJSbbkjeCJyTvnyiI1.amGLIDL4l(String )
en AKJgAM2UjJeDpEamRk.hJSbbkjeCJyTvnyiI1.SVSXpRmi8(String[] )

Thanks in advance.

[lvpokka]

Read readme... there is palette and raw mode watchface compressor

[Goublin]

Read readme... there is palette and raw mode watchface compressor

how do you do that? Sorry, it's the first time I do this

[lvpokka]

Read readme... there is palette and raw mode watchface compressor

how do you do that? Sorry, it's the first time I do this

Find mi band 4 manuals) i will not explain you all process... i think watchfaces not for you bro, sorry

[Goublin]

Read readme... there is palette and raw mode watchface compressor

how do you do that? Sorry, it's the first time I do this

Find mi band 4 manuals) i will not explain you all process... i think watchfaces not for you bro, sorry

Do you know of any link in any manual please?

[Adore_able]

Awesome but can you please tell me how to unpack and pack a .bin file . Although I read this thread many times but unable to pack , unpack it .
So can anyone please help me in this situation ???

[urieleugenio]

Awesome but can you please tell me how to unpack and pack a .bin file . Although I read this thread many times but unable to pack , unpack it .
So can anyone please help me in this situation ???

To unpack you need to click on the BIN file, drag it, and drop it over WatchFace.exe. You can also right-click over the BIN file and select 'open with', and then manually select WatchFace.exe (you'll need to look for it in the folder you saved it).
This will unpack the BIN file into a folder (in the same location where the BIN file is), with the images and a JSON file.

To pack (after making the changes you wanted), you need to drop / open the JSON file with WatchFace.exe.
This will pack the JSON + images into a new BIN file. It will also create dynamic and static previews of the WF.

[mc200x]

How to run 2.4.1 script on linux (mono) or mac ?
getting this error System.InvalidProgramException: Invalid IL code in VxevgnPEK1LvCeXIub.WhqXyRnXCUjjFRCmTS:HMXFhiOdN (string[]): IL_0185: pop on mono

[Adore_able]

Awesome but can you please tell me how to unpack and pack a .bin file . Although I read this thread many times but unable to pack , unpack it .
So can anyone please help me in this situation ???

To unpack you need to click on the BIN file, drag it, and drop it over WatchFace.exe. You can also right-click over the BIN file and select 'open with', and then manually select WatchFace.exe (you'll need to look for it in the folder you saved it).
This will unpack the BIN file into a folder (in the same location where the BIN file is), with the images and a JSON file.

To pack (after making the changes you wanted), you need to drop / open the JSON file with WatchFace.exe.
This will pack the JSON + images into a new BIN file. It will also create dynamic and static previews of the WF.

Thank you very much , will let you know when done .
Thanks for your help

[Pebbler]

Hi, have been using it since Mi Band 4, great tool!

Found some inconsistency between generated preview and real device display:

In PreviewStatesV2.1.4.json, when "Bluetooth" is set to false, Status.Bluetooth.ImageIndexOn is shown, and ImageIndexOff is shown when Bluetooth is true. I find it counterintuitive. WF is working great on device though, ImageIndexOn is shown when bluetooth is connected.

Also if watchface has 10 pics for BatteryIcon, the first one (which indicates lowest battery level, often in red color) is shown in generated preview if BatteryLevel is set to 9 or lower, whereas on real device, this red battery icon kicks in as soon as battery drops to 15%


Another issue is, Mi Band 5 can store up to 3 different custom WFs on device, and you can choose between them on device without touching your phone. The band seems to detect same WF based on some ID written in .bin file, but all WFs generated by MiBandWFTool seems to be using the same ID. This causes on device old custom WF get overwritten when another custom WF is uploaded even if there is empty slot on band. In other words, band can store only one WF packed by this tool at any time.

Using another packer called mi5wf_tool_1.0.2, I can upload three custom WFs to band at the same time, but that tool have compatibility issues on packing/unpacking many WFs.
All WFs packed by MiBandWFTool, when unpacked by mi5wf_tool_1.0.2, seems to have this string "\u0001\u0011\r=\u0000=\u0000\"'\u0000\u0000?\u0005\u0000" in header. And I see different strings when unpacking official WFs. Not sure if this is the ID, don't know what it means, just hope this helps.

[gsomgsom]

Using another packer called mi5wf_tool_1.0.2, I can upload three custom WFs to band at the same time, but that tool have compatibility issues on packing/unpacking many WFs.

Hi! Thanks for your research!
Where did you find another tool? Can you please share it (PM)?
I'm also doing researches in header format.

[lvpokka]

Hi, have been using it since Mi Band 4, great tool!

Found some inconsistency between generated preview and real device display:
...

BIg thx for research, but for now header will stay the same because of its hard to generate new header for each one, and Chinese tool is just saving previous one, if you will take any wf from here it will reuse same header and the problem will appear again)

Working on that, hope gsomgsom will have luck to reverse header.


btw. Chinese tool is awful and can handle only 40% of new elements...

[Adore_able]

How to convert a dial into a GIF ?
I tried using your creator but it's still impossible to make it animated
Please tell me how to make it a GIF?

[lvpokka]

How to convert a dial into a GIF ?
I tried using your creator but it's still impossible to make it animated
Please tell me how to make it a GIF?

Could you please find this answers by your self by unpacking watchaces with animations and check json of it?
Or create you question in different thread. (ex. viewforum.php?f=14) OR (ex. viewforum.php?f=25)

This forum is NOT for tutorials, its for BUGS of this tool...

[franluciani]

I found that you can only draw with 5 points or less the pointers of analog dials. Also the seconds of analog clock are not working yet.
In status simplified, i think that some of unknown values are from alignment of status icons.
I hope this help to developers to keep improve the tool. Anyway excelent job with the tool

[lvpokka]

In status simplified, i think that some of unknown values are from alignment of status icons.

Yeap but what is the point of alignment if you can set x and y i will make more testing when my band will eventually arrived...

[franluciani]

In status simplified, i think that some of unknown values are from alignment of status icons.

Yeap but what is the point of alignment if you can set x and y i will make more testing when my band will eventually arrived...

Hahaha i mean you can alignment bluethoot, do not disturbe and lock icons, because some elements can be on and others off. For example: bluetooth it's on, lock on and do not disturbe off, you could alignment this two icons at center, for example