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

[toolsrme]

@SashaCX75 -

This watch face editor is really saving me a bunch of time on tweaking stuff. Just curious though about a couple of things...

• I see the skins in the applications Skin folder, can those be used and if so how?

• Same with the shortcut pointer in the Mask folder?

Thanks again. Your app is making everything so much easier.

[SashaCX75]

The use of skins is enabled in the settings. They are used when saving the preview in a png or gif file.
The use of shortcut pointer is also enabled in the settings. It is only used when saving the preview to a gif file.

[Max88]

Hello guys. I need help with this watchface:
https://amazfitwatchfaces.com/gts/view/8791

I'd like to understand how has the autor managed to reproduce the behaviour of original watchface of apple watch.
When I load this watchface inside this editor I don't understand where the 12 images have been assigned.
Is there anyone who could help?
I neither see the images in preview, and nothing in json

edit:
for example download the version:
applestyle_contour_rainbow_v0_eng

as you can see I don't see those images

Spoiler

[asoo]

Spoiler

Hello guys. I need help with this watchface:
https://amazfitwatchfaces.com/gts/view/8791

I'd like to understand how has the autor managed to reproduce the behaviour of original watchface of apple watch.
When I load this watchface inside this editor I don't understand where the 12 images have been assigned.
Is there anyone who could help?
I neither see the images in preview, and nothing in json

edit:
for example download the version:
applestyle_contour_rainbow_v0_eng

as you can see I don't see those images

Spoiler

Because of the dial you mentioned. The creator added a custom script which doesn't follow the editor's standards. So when you unpack, the editor can only unpack the images. So after unpacking. The .json that you received there is no script that the creator added himself.

.json is the script that the program uses to create the watch face, not the script of the watch face that is used to run on the watch, so in this case if you need Study the function of the dial. You need to look at the index.js file which is in the .zip file.

[Max88]

Because of the dial you mentioned. The creator added a custom script which doesn't follow the editor's standards. So when you unpack, the editor can only unpack the images. So after unpacking. The .json that you received there is no script that the creator added himself.

.json is the script that the program uses to create the watch face, not the script of the watch face that is used to run on the watch, so in this case if you need Study the function of the dial. You need to look at the index.js file which is in the .zip file.

Ah ok, so it's quite more difficult than when I made wf for gts 2 mini
Thank you for help.

Just one thing, is there any guide to learn how to make wf now for zeppOs?
I don't know anything of that code, so I wouldn't know how to implement the necessary modifies or how to understand what I need.

[asoo]

Spoiler

Ah ok, so it's quite more difficult than when I made wf for gts 2 mini
Thank you for help.

Just one thing, is there any guide to learn how to make wf now for zeppOs?
I don't know anything of that code, so I wouldn't know how to implement the necessary modifies or how to understand what I need.

Script used in watchface is in javascript format.
So if you want to understand the script, you must study more about javascript

[toolsrme]

Hi @SashaCX75

I believe at one point I read a post somewhere in the forum that I believe was from you, but for the life of me I can't find it again. I could be wrong though, but just wanted to check.

Did you possibly mention a tool that you like that can convert the Zeppos special TGA images like what the Zeus CLI creates, back into valid PNG files?

[BigBlind68]

Hi @SashaCX75

I believe at one point I read a post somewhere in the forum that I believe was from you, but for the life of me I can't find it again. I could be wrong though, but just wanted to check.

Did you possibly mention a tool that you like that can convert the Zeppos special TGA images like what the Zeus CLI creates, back into valid PNG files?

You mean this tool? viewtopic.php?p=15464&hilit=ImageToZeppOS#p15457

[toolsrme]

Hi @BigBlind68

Thanks, but I don't believe so. That tool looks like it is for creating targa images that are used on the watch.

What I'm looking for is a tool that converts the ZeppOs targa file (even though it has a png extension) back to the original PNG format.

If I have it backwards though just let me know.

The post I remember had SashaCX75 mentioning something along the lines of "here is the tool I prefer". Tried multiple combinations in the search, but still couldn't find it.

[SashaCX75]

Thanks, but I don't believe so. That tool looks like it is for creating targa images that are used on the watch.

The link is just a utility that can convert images from watch face to normal png (it can convert images both ways).
There is also a "[TBUI] Watch face tool". It is designed for other types of watch faces, but it can also extract images from ZepOS watch faces as well.
I don't know of any other image conversion software.

PS. Updated the version of the utility at the link.

[Max88]

@SashaCX75
I have a question about your tool. I have bought an amazfit active (it arrives tomorrow, so I can't still test). I was wondering about the conversion function which your tool offers.
If I have understood corretcly, I can convert watchface from Gts 4 to Active. Am I right?
Maybe it's a stupid question, but it would be the first time for me using your tool (in general), so I have never tried this option in particular.

Thanks Sasha

[SashaCX75]

@Max88
Not all watch faces can be unpacked. Therefore, not all watch faces can be converted.
These watches have different aspect ratios. When converting, the aspect ratio does not change, the watch face is simply scaled in width.

[Max88]

@Max88
Not all watch faces can be unpacked. Therefore, not all watch faces can be converted.
These watches have different aspect ratios. When converting, the aspect ratio does not change, the watch face is simply scaled in width.

Ok, thanks for info. At least now I know it should work.
I'll test it once I'll have the watch. Thanks ^^

[TRK88PL]

Hey, @SashaCX75 when I convert original file from Gtr 3 pro to Gtr 4, then to Gtr 3 and example to Gtr Mini... There is a problem with position when align it's set to right, with every convert text or images move increasingly to the left... I don't have photo but...

This is correct
........ Right element

This is incorrect
... After few conversions

It's moving closer to left side by a few pixels... Can You somehow fix this? I use 10.2 editor version.

Thx.

[SashaCX75]

Show the watch face where this error occurs.
If the offset is not large, it may be due to rounding when calculating the new image size. With each conversion this error may accumulate.

[TRK88PL]

Well I have only gtr 3, unfortunately so I can't show you how this looks on different watches, but You can check this https://amazfitwatchfaces.com/search/gtr/text/X-rot if You want, original file it's created on Gtr 3 pro and there is everything okay, but when You check Gtr 3 LD EN version then You will see a difference on watch, preview image it's from Balance / Gtr 3 pro but on other's models You will see a bug... And like You said it's bigger and bigger after another conversion.

[slimak131]

Hello, thank you very much for the watch face editor program. I have two questions. Gtr4 3.0 stopped supporting the morning report shortcut, is there any way to fix it? That's why the program doesn't support AQI?

[SashaCX75]

I will fix the launching of morning news in the next version (as far as possible).

I don't use AQI in the editor because I think this parameter is useless for many users. There is no information for which city it is displayed. For example, if you look at https://waqi.info/, the nearest point where I can see AQI is in a neighbouring city. And this result will be for all those who do not live in big cities. I don't see the point of looking up AQI in a neighbouring city.

[slimak131]

I understand, but now the program removes AQI from my shield. I have to add AQI manually every time after using the program. I live in a big city.

[SashaCX75]

You can put the AQI widget code in a custom script (JS scripts section) and it will be automatically added to the watch face.

[slimak131]

Thank you very much, I will try this method.

[SashaCX75]

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

[slimak131]

I will fix the launching of morning news in the next version (as far as possible).

It still doesn't work. Impossible, or maybe in the next version?

[SashaCX75]

@slimak131
This version was already ready and I didn't want to make last minute changes.
You can replace 'MorningGreetingNewsScreen' with 'MorningGreetingCoverScreen' in the button function. It's not what it used to be, but the old version doesn't work now.

[slimak131]

Thank you, two of my problems fixed.