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]

@killmeplsok
Here is a sample code with 2 widgets to display the temperature

Code: Select all

hmUI.createWidget(hmUI.widget.TEXT, {
    x: 65,
    y: 79,
    w: 350,
    h: 40,
    text_size: 25,
    char_space: 0,
    line_space: 0,
    color: 0xFF8080FF,
    text: "BODY_TEMP",
    align_h: hmUI.align.CENTER_H,
    align_v: hmUI.align.TOP,
    text_style: hmUI.text_style.ELLIPSIS,
    show_level: hmUI.show_level.ONLY_NORMAL,
});

normal_step_current_text_img = hmUI.createWidget(hmUI.widget.TEXT_IMG, {
    x: 177,
    y: 313,
    font_array: ["number_0.png","number_1.png","number_2.png","number_3.png","number_4.png","number_5.png","number_6.png","number_7.png","number_8.png","number_9.png"],
    h_space: 0,
    dot_image: '0004.png',
    invalid_image: '0007.png',
    align_h: hmUI.align.LEFT,
    type: hmUI.data_type.BODY_TEMP,
    show_level: hmUI.show_level.ONLY_NORMAL,
});

Sleep is a bit more complicated. It is possible to use hmUI.data_type.SLEEP, but the time will be displayed together with the waking time. To display the time correctly, you need to use hmSensor.id.SLEEP and loop through all the data.

[citizenserious]

First of all, thank you very much for your work on the AmazFit Watch Faces Editor.

I would really like to use the editor, but I only use Linux and do not have access to a Windows machine at home.
Does anyone have any advice or shared experiences on running the editor — for example, via Wine or other methods?— would be greatly appreciated.

I also noticed that the latest versions, such as v13.1, are currently only published here in the forum, while the GitHub repository seems to be outdated and only contains the source code without compiled releases.
Is there a specific reason why the latest versions are not uploaded to GitHub as well?

Thank you very much in advance for any help and clarification!

[killmeplsok]

@killmeplsok
Here is a sample code with 2 widgets to display the temperature

Code: Select all

hmUI.createWidget(hmUI.widget.TEXT, {
    x: 65,
    y: 79,
    w: 350,
    h: 40,
    text_size: 25,
    char_space: 0,
    line_space: 0,
    color: 0xFF8080FF,
    text: "BODY_TEMP",
    align_h: hmUI.align.CENTER_H,
    align_v: hmUI.align.TOP,
    text_style: hmUI.text_style.ELLIPSIS,
    show_level: hmUI.show_level.ONLY_NORMAL,
});

normal_step_current_text_img = hmUI.createWidget(hmUI.widget.TEXT_IMG, {
    x: 177,
    y: 313,
    font_array: ["number_0.png","number_1.png","number_2.png","number_3.png","number_4.png","number_5.png","number_6.png","number_7.png","number_8.png","number_9.png"],
    h_space: 0,
    dot_image: '0004.png',
    invalid_image: '0007.png',
    align_h: hmUI.align.LEFT,
    type: hmUI.data_type.BODY_TEMP,
    show_level: hmUI.show_level.ONLY_NORMAL,
});

Sleep is a bit more complicated. It is possible to use hmUI.data_type.SLEEP, but the time will be displayed together with the waking time. To display the time correctly, you need to use hmSensor.id.SLEEP and loop through all the data.

Thank you so much! That helps tremendously.

[citizenserious]

After many hours, I finally got it working on Linux using Wine. Should I document the process—and if so, where would be the best place to do that?

[asoo]

After many hours, I finally got it working on Linux using Wine. Should I document the process—and if so, where would be the best place to do that?

I think if you want to show the steps of using wine on linux for the purpose of opening the editor, you can open a new topic in the Watchface tools section viewforum.php?f=29
To separate it clearly, easy to find for users who have the same approach as you

But if you want to show only how to install wine on linux, I recommend to make it a new topic in the "off topic" section
viewforum.php?f=13

[SashaCX75]

Is there a specific reason why the latest versions are not uploaded to GitHub as well?

I'm lazy and don't see much need for it. I'll add a link to this forum in the description so you can download the app.

[SashaCX75]

Version 13.2
Mirror
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.

[gingerbeardman]

@gingerbeardman I replied to you on Discord. I will briefly tell you here as well.
In the code generated by the editor, console is used. Logger is used only in the unchangeable part of the code, which is copied from official watch faces. That's why I don't understand such a requirement.

I also find it strange. I have a feeling that they will never approve my watch face again. It was a free face doing thousands of downloads when they removed it for this bogus reason.

[Galle81]

Good evening,
I wanted to make some changes to a watch face.
It included AQI, but when I unpack the watch face with Watch Face Editor 13.02, the AQI is deleted from the .json file. There's an option in the editor to do so.
How can I add the AQI?

Thanks.

[SashaCX75]

I also find it strange. I have a feeling that they will never approve my watch face again. It was a free face doing thousands of downloads when they removed it for this bogus reason.

Even when approved the watch face may not show up in Zepp. Check it out. I had this happen and they said they couldn't fix it and advised me to resubmit it.

[SashaCX75]

@Galle81 There is no AQI in the editor. It can be added only by correcting the code in the finished watch face.

[Galle81]

@Galle81 There is no AQI in the editor. It can be added only by correcting the code in the finished watch face.

Okay, thanks. Can I add the code manually by writing it into the .json file?
If so, what would the code be?

[bazaglia]

Congratulations on the constant development of the tool. I have a problem with the temperature graph. The lines are not refreshing, so as the weather changes, the lines are overlapping each other.

[SashaCX75]

@Galle81 You need to edit the code in the index.js file

[SashaCX75]

@bazaglia Send me a watch face where this problem occurs and I'll try to check. But it's strange. Because when the screen is switched on, the graph is always drawn again.

[bazaglia]

@SashaCX75 I sent you the file by private message. Thanks a lot.

[bibiyo66]

Hello, First of all thank you for the work you do in the constant development of the sphere creator editor. Thank you very much.

In the latest version, the 13.2. I have noticed that if you use a font instead of images for the numbers or letter fields once the dial is packaged, although a folder is created where the font is saved, when it is installed on the clock the fields appear empty.
In version 13.1 what I just mentioned does not happen.

Another thing that I have observed when using another font other than the one of the program is that in the program the fields are alienated. However, once installed in the device the fields are displayed shifted upwards.
This happens only if an additional font is included. With pre-created images such as numbers, days of the week etc this does not happen.

Thanks again for your work.

(translate from spanish)

[SashaCX75]

@bibiyo66 In terms of working with fonts nothing should have changed in the latest version. You can send me a project with problems and I will check it. But first, after installing the watch face, try to restart the watch.

There is a problem with incorrect display of some fonts in the editor and so far I can't do anything about it. That's why there is a recommendation in the editor to check if the fonts work on the watch.

[bibiyo66]

Thank you for your quick response.

What I said in my first message must have been a one-time glitch. I reinstalled the clock face created with version 13.2 and this time it installed correctly, with no empty fields and no need to reboot the device.

It is also true that with some fonts there is variation from how they look in the program to how they look later on the device. I will keep this in mind for future creations or adaptations.

On the other hand, as a curiosity, I imagine that the function has disappeared, as it existed in previous editors, to assign images individually for the tens of “hours” and units of “hours”. It gave a lot of play to create.

Thanks again for your hard work. I love the editors you have created. They are very complete.
Regards.

Translated from spanish

[SashaCX75]

On the other hand, as a curiosity, I imagine that the function has disappeared, as it existed in previous editors, to assign images individually for the tens of “hours” and units of “hours”. It gave a lot of play to create.

You must be referring to past models of watches. There it was a feature of the watch firmware and there was no other way to display the time. Here there is no such need and the time can be made by one module. The need for this may arise only in watch faces with a specific design. Therefore, it will not be in the editor. And if you need such a thing, you will have to write the code yourself.

[Guydu91]

On the other hand, as a curiosity, I imagine that the function has disappeared, as it existed in previous editors, to assign images individually for the tens of “hours” and units of “hours”. It gave a lot of play to create.

You must be referring to past models of watches. There it was a feature of the watch firmware and there was no other way to display the time. Here there is no such need and the time can be made by one module. The need for this may arise only in watch faces with a specific design. Therefore, it will not be in the editor. And if you need such a thing, you will have to write the code yourself.

To assign different images for the tens and units of the hours (and minutes), simply use the usual normal values ​​plus the angle values, leaving the angle value at zero, as in this watch face https://amazfitwatchfaces.com/gts/view/11991
Best regards.

[gingerbeardman]

Even when approved the watch face may not show up in Zepp. Check it out. I had this happen and they said they couldn't fix it and advised me to resubmit it.

My watch face was re-approved on 10th after 16 days. I'll wait a week to see if it appears on the Zepp store.

[bibiyo66]

To assign different images for the tens and units of the hours (and minutes), simply use the usual normal values ​​plus the angle values, leaving the angle value at zero, as in this watch face https://amazfitwatchfaces.com/gts/view/11991
Best regards.

Thank you very much for your response.
I will try as you said.
Regards.

[diver787]

Hello Sasha! First of all thanks for your great tool because it is very complete and efficient to edit all faces!:)

I have used it to modify some faces from this website and everything worked smoothly except one detail...
my new face is installing and working fine, I have also the preview of my face showing in the settings of my watch... but I don't have the preview of my actual face in Zepp app ? there is always still the preview of any other face taken last time directly from AW.

I have the file Preview.png in my folder generated by your tool, the resolution of this preview is 480x480 like my Balance resolution, could it be the problem with this resolution or maybe should I include another preview file?
Also when installing through developer mode I get this error message at the end:
install mini-program/watchface failed

By the way I have also a newbie question;) Is it possible with your tool to generate a very simple AOD face with only hours and minutes in 24-hours format ? The only format I have found is 12-hours format with am/pm ?

Many thanks in advance for your time!

Adrian

[TRK88PL]

Hi, as we all know, it's possible to add sleep duration by editing the code – it's not perfect, but it works to some extent. I'm not sure if it's just my eyes or if this feature is simply missing from the editor? As far as I know, it's also possible to create an animation of passing seconds around a circle, again through code editing – maybe it would be useful to add a button, so anyone interested could add this to their watch face without needing to know how to code?