Watch face editor for Amazfit watch on ZeppOS

[SashaCX75]

Alternative watch face editor for Amazfit watch on ZeppOS.

Supported watch models

- Amazfit Active
- Amazfit Active 2
- Amazfit Active 2 (Square)
- Amazfit Active Edge
- Amazfit Active Max
- Amazfit Band 7
- Amazfit Balance
- Amazfit Balance 2
- Amazfit Bip 5
- Amazfit Bip 5 Unity
- Amazfit Bip 6
- Amazfit Cheetah
- Amazfit Cheetah Pro
- Amazfit Cheetah (Square)
- Amazfit Cheetah 2 Pro
- Amazfit Falcon
- Amazfit GTR 3
- Amazfit GTR 3 Pro
- Amazfit GTR 4
- Amazfit GTR mini
- Amazfit GTS 3
- Amazfit GTS 4
- Amazfit GTS 4 mini
- Amazfit T-Rex 2
- Amazfit T-Rex 3
- Amazfit T-Rex 3 Pro
- Amazfit T-Rex Ultra
- Amazfit T-Rex Ultra 2

When unpacking the watch faces, it is advisable to immediately select the correct watch model, otherwise the colors may be distorted.

It is desirable to create a new project in a separate folder. Image names do not have to consist only of numbers, you can add short prefixes (for example, date_01, time_01).
Watch faces created in the editor and on Huami's website should unpack normally. Watch faces from Zepp and those created based on them will not be unpacked.
In a set of images for displaying one parameter (for example, images for displaying the day of the week), all images should preferably be the same size. If the size of the images is different, then the first image in the set should be the largest.

All new features in this and next release will be tested on the GTR4 and may not work on other models.

List of changes

v17.1

Fixed the bugs that were found.
Added support for Cheetah 2 Pro.

v17.0

Added the ability to create a ZAB file for publication in the store (button in settings)
Added wind speed in km/h
Added atmospheric pressure in mm Hg
Added support for T-Rex Ultra 2.

v16.1

The ability to invert time circles has been added.
Active Max support has been added.
Image file name verification has been added.
The behavior of application shortcuts in editable elements has been fixed.

v16.0

Added sleep widget.
Added text widgets.

v15.1

Added support for new watch models.
Added BioCharge widget.
Added buttons to launch new applications.

v15.0

Time circles added.
Added world time (time, city, time zone, time offset).
Added text display around the circle.
Added the ability to create watch faces in developer mode (for experienced users, allows logs to be displayed in watch faces).

v14.0

Added support for widgets: ALARM_CLOCK, TRAINING_LOAD, VO2MAX, AQI, BODY_TEMP, FLOOR, READINESS, HRV.
Added support for Balance 2.
Changed the structure of the Preview.States file.
When creating an animated preview, frames with a switchable background have been added.
Added the ability to display the city name in uppercase letters in the weather forecast.
Added links to lessons.

v13.2

Added support for Bip 6.
Fixed the progress display using the image set for most widgets. It should now be more similar to how it is displayed on the watch.
Reworked the code for displaying heart rate with a circular scale. It now uses the standard widget in place of the sensor.
Fixed PAI progress display. Note that the maximum value for the PAI pointer is 525, not 100. This is a feature of the watch, not the editor.
Added warning if files in watch face are in *.bin format.

v13.1

Added ability to make a shortcut to any application in editable items.
Added support for Active 2.
Fixed display of buttons and shortcuts when creating a GIF file.

v13.0

Added autosave (enabled in settings).
Added ability to switch background image by tap.
Added ability to switch background colour by tap.

v12.1

Added transparency for some widgets. Does not work on all models.
Added support for Amazfit T-Rex 3.

v11.2

Fixing the smooth second hand on the GTR4.

v11.1

Updated the digital time widget.
Updated shortcuts widget.
Added new application launch commands for buttons.

v11.0

Completely redesigned the weather widget.
Added weather widget for several days (forecast).
Added support for Bip 5 Unity.

v10.4

Added ability to display month names in a font.
Added Compass widget (works on ZeppOS 2 or later).
Added ability to create *.zpk file (enabled in settings).

v10.3

Added display of hours:minutes:seconds in a single line font.
Added display of date/month/year in one line font (order depends on the watch setting).
Added display of the day of the week in font.
Added new presets for button functions.

v10.2

Added ability to copy widget properties (context menu on the properties field).

v10.1

Added display of time and date in font.
Added widget for adding scripts to watch face.
Fixed bugs in sunrise/sunset operation on circle and at an angle.
Fixed bugs in digital time alignment.

v10.0

]Added support of fonts for data display (after installing such watch faces it is better to restart the watch).
Added possibility to display altitude (in barometer).
Completely redesigned the moon widget.
The arrow pointer for sun and moon should now not be displayed after sunset.
All images are now copied to the watch face, even if they are in folders.

v9.1

Fixed working with Amazfit Balance.
Added support for Amazfit Active.
Added support for Amazfit Active Edge.
Fixed display of distance on a circle.
Fixed displaying sunrise and sunset at an angle.
Added ability to convert images to ARGB format in settings.
Fixed continuous vibration in notifications.

v9.0

Added ability to create shortcuts for a set of images (IMG_LEVEL).
Added support for buttons and presets to launch inbuilt apps.
Added support for Amazfit Balance (not tested).

v8.2

Added ability to display angled or circumferential data for sunrise/sunset, maximum and minimum temperatures (for weather, separate units of Celsius and Fahrenheit only work on newer models).
Added support for Cheetah / Cheetah Pro.
Added support for Bip 5.
Theoretically it is now possible to add support for new models by editing the file in the model_config folder.

v8.1

Added ability to display data at an angle or in a circle for date and time.
Fixed found errors when unpacking dials.
Fixed found errors when working with UHD monitors.

v8.0

Added support for T-Rex Ultra
Added support for GTR Mini
Added the ability to display data at an angle or in a circle (battery, steps, distance, calories, heart rate, PAI, SpO2, stand)

v7.3

Fixed problems with icons in editable items.
Fixed problems with circular progress in editable items.
Added ability to set data rotation angle for some models (ZeppOS 2).
Improved algorithm for unpacking dials that contain additional features. Increased probability of partial dial recognition.

v7.2

Added the ability to change the type of line ending for linear and circular progress.
Added the ability to create shortcuts without using an image.

v7.1

Added independent element with image and top image.
For editable items on the clock, an additional selection in the form of a list is included.
Changed the function of creating an editable element for fat burning.
Fixed motion animation and rotation animation for GTR4 and GTS4.
Added wind direction.
Updated watch face file format.

v7.0

Added smooth second hand (several types)
Added alert every hour
Added the ability to change the direction of rotation of the hour hands
Added the ability to set the sector in which the hour hands work

v6.4

Improved the stability of the bluetooth connection loss notification function
Updated German and Spanish translation

v6.3

Added the possibility of notifications when the connection is broken and restored
Fixed work progress for fat burning
Fixed work progress for the pulse
Fixed bugs in temperature display
Fixed display of shortcuts in AOD mode

v6.1

Added Falcon support.
Changed the algorithm of shortcuts to eliminate conflicts with editable elements.
The configuration of created watch faces has been updated to version 2.

v6.0

Added support for editable background.
Added support for editable arrows.
Added support for editable elements.
Added German translation.

v5.0

Added support for GTR 4
Added support for GTS 4 Mini
Added support for Amazfit Band 7 (not to be confused with Mi Band 7)

v4.1

Fixed bugs when creating and unpacking GTR 3 Pro watch faces

v4.0

Added animation support.
Added Ukrainian language.
Added a tab with some tips on working with the editor.
Added the ability to display the distance in miles.

v 3.0

Added sunrise / sunset
Added barometer
Added stress
Wind added
Added fat burning
Added moon phases

v 2.0

Added weather.
Added workout (stand).
Added oxygen (SpO2).
Added humidity.
Added UV index.
Added the ability to highlight shortcuts when saving gif files (enabled in the settings).
Updated the display of shortcuts in connection with the firmware update on the watch.
Added Italian language.
Added Spanish language.

v 1.1

Fixed loss of error symbol for pulse.
Fixed errors when unpacking dials.
Fixed bug with incorrect model definition for GTS 3.

Version 17.1
Fixed the bugs that were found.
Added support for Cheetah 2 Pro.

Old versions

v 10.0
v 10.1
v 10.2
v 10.3
v 10.4
v 11.0
v 11.1
v 11.2
v 12.1
v 13.0
v 13.1
v 13.2
v 14.1
v 15.0
v 15.1
v 16.0
v 16.1
v 17.0

PS. The interface was translated using an online translator. If someone wants to improve the translation, then write to the PM.

PS2. Many people ask how to install watch faces. For starters, I advise you to read this topic. Personally, I prefer to use this program to install the created watch faces on the GTR 3 (for the GTS 3)

Сollection of code examples for use in watch faces.

Donate to the author - PayPal: [email protected].
Buy me a coffee

[SashaCX75]

JACKpark
I don't understand what you mean by "random location AOD".
The position of all elements is specified by specific coordinates. The image on the AOD screen is shifted by a few pixels in a random order about once a minute, this is determined by the watch firmware.

You can write code that will change the coordinates of the elements in random order. The firmware of the watch allows you to do this. But writing code is a more complex process and in the editor this will not be possible.

[SashaCX75]

FeRu
I was unable to use the .tff file with the font in the watch face and I have not seen such watch faces. It is possible to display data in embedded font, but it is problematic. In addition, unlike GTR2, the system font cannot be rotated or written in a circle (I do not know about such possibilities). Therefore, I see no benefit from using the system font.

[FeRu]

@FeRu
I was unable to use the .tff file with the font in the watch face and I have not seen such watch faces. It is possible to display data in embedded font, but it is problematic. In addition, unlike GTR2, the system font cannot be rotated or written in a circle (I do not know about such possibilities). Therefore, I see no benefit from using the system font.

Ok I see . Thanks for info. I think about that because I liked this feature with GTR2 and sometimes i thiked that It could be much better to change that system font to other style...but we can live without this

Anyway can't wait for next relase Keep up great work

And one more question about animation features. GTR3 support .gif animations? Or it will be standard set of png images with option to adjust speed in editor.

[SashaCX75]

FeRu
GIF files are not supported. You can make animation using a set of images. It is possible to make an animation by moving along given coordinates, as it was in GTR 1, but I'm not sure about that.

[rondolfo]

This looks great - thanks for your hard work Sasha! I can see how to create a dial and export it as a zip.
But how do I get it on to my watch - a GTR3 Pro?

As a test, I've taken a basic face, changed the background on it, and now I'd like to upload it to the watch.
Apparently this involves overwriting .bin files in com.huami.etc data folders (with what - the .zip file created by the app?!), or pressing the upload button next to the download button in the app and then uploading (or downloading, or perhaps both simultaneously ) some files to somewhere but not the preview file because you can't change that and you can forget it all anyway if you have a phone with Android 11+ on it.

Sorry, I've spent many hours searching but I can't make head nor tale of it! Any clues anyone?
Thanks!

[Dema]

SashaCX75 , I'm sorry to disturb you again, but I'm facing a strange bug and i can't figure out what is happening..
I'm building a GTS 3 Watchface and everything seems to be ok until i upload my dial on the Watch.
On the tool everything is ok, also the preview generated is ok, but when I put the dial on the Watch, the image that I have use for the "1" of the hours results more larger than what it is, not the number itself, but the empty space around it. I have tried to modify it but show ever a lot of empty space around it.
Can you figure out what's going on?
Can i send my work to you to take a look?

[jerrywm2]

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

[Dema]

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

The simplest way is using amacfaces android app.
You can upload your dials creating a private page on amazfitwatchfaces, then you put this page in your favourites and through the app you can install it really easily.

[Mazaias]

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

The simplest way is using amacfaces android app.
You can upload your dials creating a private page on amazfitwatchfaces, then you put this page in your favourites and through the app you can install it really easily.

To test the face on the watch, it is faster to rename the zip file to bin and copy it to the memory of the mobile. Then the bin is opened in the mobile file explorer and it is told to open it with the amazfaces app. It will automatically take you to the installation option.

[Mazaias]

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

To test the face on the watch, it is faster to rename the zip file to bin and copy it to the memory of the mobile. Then the bin is opened in the mobile file explorer and it is told to open it with the amazfaces app. It will automatically take you to the installation option.

[Dema]

Spoiler

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

To test the face on the watch, it is faster to rename the zip file to bin and copy it to the memory of the mobile. Then the bin is opened in the mobile file explorer and it is told to open it with the amazfaces app. It will automatically take you to the installation option.

Thank you very much! I did not know this method!

[rondolfo]

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

The simplest way is using amacfaces android app.
You can upload your dials creating a private page on amazfitwatchfaces, then you put this page in your favourites and through the app you can install it really easily.

Aha, this sounds like we might be getting somewhere! Thanks for your reply Dema, can I please get some help from you?

I logged in to my account here.
I clicked on Upload, filled in the form and uploaded my test dial (test1.zip).
The link to make it private doesn't seem to work - it says "You do not have any uploaded watch saces" and just takes me to a seemingly unrelated page.

So I've uploaded a dial which has disappeared and which I can't make private.

[rondolfo]

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

To test the face on the watch, it is faster to rename the zip file to bin and copy it to the memory of the mobile. Then the bin is opened in the mobile file explorer and it is told to open it with the amazfaces app. It will automatically take you to the installation option.

Thanks Mazalas. On my phone (Android 11) I don't get the option to 'open' the bin with the Amazfaces app.
On an older phone I do get the option but when I try to install, it fails. This is trying it with a working file I just downloaded from this site and haven't modified in any way other than to change the file extension to .bin.
When I try to install the app says "Checking File ...xxx.zip" -- note it says 'zip' there, even though the file is .bin - so that's weird - then when I click 'Go to Installation' I get the failure message "Wrong format the file".

So - doesn't work. Any clues about what I might be doing wrong?
Thanks for looking!

[Mazaias]

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

To test the face on the watch, it is faster to rename the zip file to bin and copy it to the memory of the mobile. Then the bin is opened in the mobile file explorer and it is told to open it with the amazfaces app. It will automatically take you to the installation option.

Thanks Mazalas. On my phone (Android 11) I don't get the option to 'open' the bin with the Amazfaces app.
On an older phone I do get the option but when I try to install, it fails. This is trying it with a working file I just downloaded from this site and haven't modified in any way other than to change the file extension to .bin.
When I try to install the app says "Checking File ...xxx.zip" -- note it says 'zip' there, even though the file is .bin - so that's weird - then when I click 'Go to Installation' I get the failure message "Wrong format the file".

So - doesn't work. Any clues about what I might be doing wrong?
Thanks for looking!

Install a third-party file browser. In my case, I use MixExplorer but anyone should do. With this you can now open the bin with amazfaces.

Why do you get the error on the other mobile? It would have to be studied carefully.

[Dema]

Spoiler

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

To test the face on the watch, it is faster to rename the zip file to bin and copy it to the memory of the mobile. Then the bin is opened in the mobile file explorer and it is told to open it with the amazfaces app. It will automatically take you to the installation option.

Thanks Mazalas. On my phone (Android 11) I don't get the option to 'open' the bin with the Amazfaces app.
On an older phone I do get the option but when I try to install, it fails. This is trying it with a working file I just downloaded from this site and haven't modified in any way other than to change the file extension to .bin.
When I try to install the app says "Checking File ...xxx.zip" -- note it says 'zip' there, even though the file is .bin - so that's weird - then when I click 'Go to Installation' I get the failure message "Wrong format the file".

So - doesn't work. Any clues about what I might be doing wrong?
Thanks for looking!

Anyway, in your account there is "my upload" section, you find your page there, if you can't find it, if you try to do another private page, considering that can be only a private page for each user, the page show you a link to your other page.. I hope is clear, my English is awful..

See the attached photo for example

[Dema]

Spoiler

Thank you so much @SashaCX75. I know this should be simple, but can anyone tell me how I actually install the .zip file on my watch after I pack it? Thank you!

The simplest way is using amacfaces android app.
You can upload your dials creating a private page on amazfitwatchfaces, then you put this page in your favourites and through the app you can install it really easily.

Aha, this sounds like we might be getting somewhere! Thanks for your reply Dema, can I please get some help from you?

I logged in to my account here.
I clicked on Upload, filled in the form and uploaded my test dial (test1.zip).
The link to make it private doesn't seem to work - it says "You do not have any uploaded watch saces" and just takes me to a seemingly unrelated page.

So I've uploaded a dial which has disappeared and which I can't make private.

Furthermore, to share your page, the simple URL is enough... Copy that from your browser and share that

[SashaCX75]

Personally, I prefer to use this program to install the created watch faces on the GTR 3 (for the GTS 3)

[SashaCX75]

Can i send my work to you to take a look?

Yes, you can send your work. Only it is better to send not a finished dial, but the original project. If the error is not very noticeable, then it is better to somehow indicate in the photo or preview the place you need to pay attention to.

[Dema]

Spoiler

Can i send my work to you to take a look?

Yes, you can send your work. Only it is better to send not a finished dial, but the original project. If the error is not very noticeable, then it is better to somehow indicate in the photo or preview the place you need to pay attention to.

I tried to modify each number of my incriminate dial, to give each number the same X/Y dimensions, and that fixed partially the situation. The empty space around numbers doesn't look larger anymore, but i notice that the preview isn't exactly the same that the final result and I can't understand why, some numbers appears a bit decentred, it feels a bit strange.... my other dials doesn't have that problem.

I can send you a zip containing the json and the assets ok? I send you in private. Thank you

[rondolfo]

Install a third-party file browser. In my case, I use MixExplorer but anyone should do. With this you can now open the bin with amazfaces.

Why do you get the error on the other mobile? It would have to be studied carefully.

Yeah, like that'll make any difference... HOLY F**K, thank you so much Mazaias! I opened CX Explorer, (already installed) and it let me select file type 'Other' then allowed me to associate pretty much any app at all with the .bin. Which then opened perfectly in the Amazfaces app then installed straight on to the watch. Just to check, I did the same on the old phone and this time it didn't choke on the 'invalid file' error, nor 'recognise' it as a .zip, so that appears to have been some kind of bizarre error related to the stock file explorer. So the moral of the story is: use a third party browser, not the one that came with your phone. Because reasons .

For some reason the thumbnail on my watch is a number '3' but I can live with that for now.

Brilliant, I am finally on my way to making my first watchface. That's this weekend sorted... Thanks everybody!

[rondolfo]

Personally, I prefer to use this program to install the created watch faces on the GTR 3 (for the GTS 3)

Excellent, thanks. I find it strange that it kinda overwrites the 'Get Moving' dial in the Zepp app in order to install its dials but it seems you can do this over and over again and nothing breaks...! And it installs the correct preview thumbnail too so all in all it works very well.

I'm looking forward to using your Watch Face Editor app this weekend!

[rondolfo]

Anyway, in your account there is "my upload" section, you find your page there, if you can't find it, if you try to do another private page, considering that can be only a private page for each user, the page show you a link to your other page.. I hope is clear, my English is awful..

Thanks Dema. I'll try it again when I have something useful to upload to the site . The other methods of transfer seem more efficient anyway.

[Mazaias]

Install a third-party file browser. In my case, I use MixExplorer but anyone should do. With this you can now open the bin with amazfaces.

Why do you get the error on the other mobile? It would have to be studied carefully.

Yeah, like that'll make any difference... HOLY F**K, thank you so much Mazaias! I opened CX Explorer, (already installed) and it let me select file type 'Other' then allowed me to associate pretty much any app at all with the .bin. Which then opened perfectly in the Amazfaces app then installed straight on to the watch. Just to check, I did the same on the old phone and this time it didn't choke on the 'invalid file' error, nor 'recognise' it as a .zip, so that appears to have been some kind of bizarre error related to the stock file explorer. So the moral of the story is: use a third party browser, not the one that came with your phone. Because reasons .

For some reason the thumbnail on my watch is a number '3' but I can live with that for now.

Brilliant, I am finally on my way to making my first watchface. That's this weekend sorted... Thanks everybody!

I'm glad I helped.

As for the thumbnail of the number 3 I imagine it will be the preview. Select the correct image in "preview" within the "background" option.

[gengtrex]

hi sasha. SashaCX75
so glad to know your new editor has been delivered.
just a quick question.
i packed my project then got only a .zip file.
can i get a .bin file too? and how?

thanks a lot in advance.

[FeRu]

hi sasha. @SashaCX75
so glad to know your new editor has been delivered.
just a quick question.
i packed my project then got only a .zip file.
can i get a .bin file too? and how?

thanks a lot in advance.

New GT3 watches have Zepp OS and WF's are in zip format. Only WF Editor 2 for GT2 support bin files for previous generation