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

[Emiliomc]

Very sorry. I thought this was the forum I should go to. So I don't know which forum I should go to and ask questions there, attaching images.

[SashaCX75]

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

[mbriacuni]

Hi,
Do you think it is possible to send an http request with a button directly from the watchface? I know it's possible using the "http" app created by galulex but if it were possible I would like to save the step of opening the app.

[rush2112]

@SashaCX75
Hi, I have a brief inquiry regarding the GTR3 Pro smartwatch. Could you please consider unlocking the angle of the barometer in the next update? It appears that all other angles in your editor are adjustable, except for this particular one , just please take a look at the Distance angle is unlock / is fine . Thank you.

Spoiler

[SashaCX75]

@rush2112
There are two different parameters ‘ Numerical values’ and ‘ Value at angle’ for a reason. They display data in different ways. So it is wrong to compare them. There is no easy way to display angled pressure on the GTR3.

[piotarock]

Thanks @SashaCX75.

I see that in the 10.2 version of the app. I was able to put it all together, but I have a question where I'm probably doing something simple wrong. After using your tool to pack the face, I put it in a directory and unzip it so that I can run "zeus dev" and have it show in the simulator, but it gives me the following error:

error Please set at least one package.

I can see that the apps.json is a little different in that it doesn't have the same JSON structure as what zeus create builds, but contains the same data. Is there a trick to getting the output to work with ZEUS CLI?

Hello,
Did you ever solve this problem? I am encountering the same challenge.

[rush2112]

@SashaCX75
@asoo
I inserted a JavaScript into the editor tools, and now I'm trying to create a shortcut. However, I'm not sure how to make the button appear in the editor. Can you give me some advice? Thanks

Spoiler

[asoo]

Spoiler

@SashaCX75
@asoo
I inserted a JavaScript into the editor tools, and now I'm trying to create a shortcut. However, I'm not sure how to make the button appear in the editor. Can you give me some advice? Thanks

Spoiler

As far as I know, the JS script that you add to the editor
will not be displayed in the preview section of the program.
You need to understand the script you added to it, so that you can use the function or command set from the script to define the operation through the function "Button" of the editor by yourself.


Example image of using a function in a script via a button.

Spoiler

However, if you want to simulate the operation of the watchface to test the js script you added, you can do it through the simulator
such as
ZeppPlayer
https://mmk.pw/en/zepp_player/
The ZeppPlayer can simulate about 80% of the operation
and is compatible with ZeppOS1

or
the official ZeppOS Simulator
https://docs.zepp.com/docs/guides/tools ... /download/

The ZeppOS Simulator will simulate correctly, but the settings may be more difficult, but you can see more information here https://docs.zepp.com/docs/guides/tools ... /download/

[rush2112]

@asoo

Thank you for your response! I appreciate your detailed explanation of the steps to follow. I'll give it a try!

[wanders]

@SashaCX75 , is there any chance that you will support the new Amazfit Active 2 round watch? I have yet to see any mention of it in this forum.

[u6gljnuj4l]

@SashaCX75 , is there any chance that you will support the new Amazfit Active 2 round watch? I have yet to see any mention of it in this forum.

I also have the Amazfit Active 2 and would love to see it supported. NOTE: As a workaround for now you can download several of the Amazfit GTR 4 watch faces onto the Amazfit Active 2 (same screen resolution). They all don't work but I have successfully downloaded several of them to my Active 2. I downloaded them to my watch by using Developer Mode on Zepp app and scanning QR code.

[SashaCX75]

In order to add support for the Amazfit Active 2 I need to see at least examples of these watch faces first.

Most likely this model will be added. But if the GTR 4 watch faces are suitable for the Amazfit Active 2, it's not a critical update and it's not a priority. That's why I haven't looked into it yet.

[SushiSeb]

Running into this issue when trying to import this gtr 3 watch face to convert. Any ideas?

Spoiler

[taw_bip]

I use 12-hour format. I have a watchface that shows sunrise/sunset times but it uses 24-hour format. Is there a way to fix?

[SashaCX75]

@SushiSeb It's hard to tell without seeing the watch face. Most likely one or more images are encoded in a format not supported in the editor.

@taw_bip When using the standard widget, sunrise / sunset data does not respond to time format changes. This can only be corrected by using your own code.

[taw_bip]

@taw_bip When using the standard widget, sunrise / sunset data does not respond to time format changes. This can only be corrected by using your own code.

@SashaCX75 The watchface I'm looking at is this one:
https://amazfitwatchfaces.com/gtr/view/41938
Can you advise?

[apgeo]

does anyone know how to add new fonts to the program? There is the 'add new font' button but it gives an error and you can only use the original font

[SashaCX75]

@apgeo
The others do not complain about this function working. So maybe you are doing something wrong. For example, you are trying to add a font that is already in the project folder.

[Fladis]

I was working normally in the SW and than I tried to pack the WF and an error occured:

Spoiler

See the end of this message for details on invoking
just-in-time (JIT) debugging instead of this dialog box.

************** Exception Text **************
System.IO.IOException: Access to the path 'D:\Watch_Face_Editor_(ZeppOS)old\Temp' is denied.
at System.IO.Directory.DeleteHelper(String fullPath, String userPath, Boolean recursive, Boolean throwOnTopLevelDirectoryNotFound, WIN32_FIND_DATA& data)
at System.IO.Directory.Delete(String fullPath, String userPath, Boolean recursive, Boolean checkHost)
at Watch_Face_Editor.Form1.DeleteDirectory(String target_dir)
at Watch_Face_Editor.Form1.Unpack_Zip(String fullFileName)
at Watch_Face_Editor.Form1.button_unpack_zip_Click(Object sender, EventArgs e)
at System.Windows.Forms.Control.OnClick(EventArgs e)
at System.Windows.Forms.Button.OnClick(EventArgs e)
at System.Windows.Forms.Button.OnMouseUp(MouseEventArgs mevent)
at System.Windows.Forms.Control.WmMouseUp(Message& m, MouseButtons button, Int32 clicks)
at System.Windows.Forms.Control.WndProc(Message& m)
at System.Windows.Forms.ButtonBase.WndProc(Message& m)
at System.Windows.Forms.Button.WndProc(Message& m)
at System.Windows.Forms.Control.ControlNativeWindow.OnMessage(Message& m)
at System.Windows.Forms.Control.ControlNativeWindow.WndProc(Message& m)
at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam)


************** Loaded Assemblies **************
mscorlib
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9290.0 built by: NET481REL1LAST_C
CodeBase: file:///C:/Windows/Microsoft.NET/Framework/v4.0.30319/mscorlib.dll
----------------------------------------
Watch_Face_Editor_(ZeppOS)
Assembly Version: 13.0.0.0
Win32 Version: 13.0.0.0
CodeBase: file:///D:/Watch_Face_Editor_(ZeppOS)old/Watch_Face_Editor_(ZeppOS).exe
----------------------------------------
System.Windows.Forms
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9251.0 built by: NET481REL1LAST_C
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/System.Windows.Forms/v4.0_4.0.0.0__b77a5c561934e089/System.Windows.Forms.dll
----------------------------------------
System
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9282.0 built by: NET481REL1LAST_C
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/System/v4.0_4.0.0.0__b77a5c561934e089/System.dll
----------------------------------------
System.Drawing
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9037.0 built by: NET481REL1
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/System.Drawing/v4.0_4.0.0.0__b03f5f7f11d50a3a/System.Drawing.dll
----------------------------------------
Newtonsoft.Json
Assembly Version: 13.0.0.0
Win32 Version: 13.0.3.27908
CodeBase: file:///D:/Watch_Face_Editor_(ZeppOS)old/Libs/Newtonsoft.Json.DLL
----------------------------------------
System.Configuration
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9037.0 built by: NET481REL1
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/System.Configuration/v4.0_4.0.0.0__b03f5f7f11d50a3a/System.Configuration.dll
----------------------------------------
System.Core
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9277.0 built by: NET481REL1LAST_B
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/System.Core/v4.0_4.0.0.0__b77a5c561934e089/System.Core.dll
----------------------------------------
System.Xml
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9037.0 built by: NET481REL1
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/System.Xml/v4.0_4.0.0.0__b77a5c561934e089/System.Xml.dll
----------------------------------------
Accessibility
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9037.0 built by: NET481REL1
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/Accessibility/v4.0_4.0.0.0__b03f5f7f11d50a3a/Accessibility.dll
----------------------------------------
System.Numerics
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9037.0 built by: NET481REL1
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/System.Numerics/v4.0_4.0.0.0__b77a5c561934e089/System.Numerics.dll
----------------------------------------
System.Runtime.Serialization
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9241.0 built by: NET481REL1LAST_C
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_MSIL/System.Runtime.Serialization/v4.0_4.0.0.0__b77a5c561934e089/System.Runtime.Serialization.dll
----------------------------------------
System.Data
Assembly Version: 4.0.0.0
Win32 Version: 4.8.9214.0 built by: NET481REL1LAST_B
CodeBase: file:///C:/WINDOWS/Microsoft.Net/assembly/GAC_32/System.Data/v4.0_4.0.0.0__b77a5c561934e089/System.Data.dll
----------------------------------------
ControlLibrary
Assembly Version: 1.0.0.0
Win32 Version: 1.0.0.0
CodeBase: file:///D:/Watch_Face_Editor_(ZeppOS)old/Libs/ControlLibrary.DLL
----------------------------------------
ControlLibrary.resources
Assembly Version: 1.0.0.0
Win32 Version: 1.0.0.0
CodeBase: file:///D:/Watch_Face_Editor_(ZeppOS)old/Language/en/ControlLibrary.resources.DLL
----------------------------------------
Watch_Face_Editor_(ZeppOS).resources
Assembly Version: 13.0.0.0
Win32 Version: 13.0.0.0
CodeBase: file:///D:/Watch_Face_Editor_(ZeppOS)old/Language/en/Watch_Face_Editor_(ZeppOS).resources.DLL
----------------------------------------
DotNetZip
Assembly Version: 1.16.0.0
Win32 Version: 1.16.0
CodeBase: file:///D:/Watch_Face_Editor_(ZeppOS)old/Libs/DotNetZip.DLL
----------------------------------------

************** JIT Debugging **************
To enable just-in-time (JIT) debugging, the .config file for this
application or computer (machine.config) must have the
jitDebugging value set in the system.windows.forms section.
The application must also be compiled with debugging
enabled.

For example:

<configuration>
<system.windows.forms jitDebugging="true" />
</configuration>

When JIT debugging is enabled, any unhandled exception
will be sent to the JIT debugger registered on the computer
rather than be handled by this dialog box.

Now I am not able to do anything. Even the unpacking WF. Only open the project.

Anyone know what happend?

Thanks

[SashaCX75]

@Fladis
The first line of the error message says that you cannot access the temporary folder. This may be caused by your OS or firewall settings.
The easiest way to fix it is to try deleting the folder ‘D:\Watch_Face_Editor_(ZeppOS)old\Temp’. You can also try copying the editor to another folder.

[Fladis]

@Fladis
The first line of the error message says that you cannot access the temporary folder. This may be caused by your OS or firewall settings.
The easiest way to fix it is to try deleting the folder ‘D:\Watch_Face_Editor_(ZeppOS)old\Temp’. You can also try copying the editor to another folder.

Thanks for advise, but it didn't work I also tried to download a new copy of the editor, didn't work as well.

[Fladis]

Aaaa. I found a solution. Run it as an administrator! Sorry, It didn't come to my mind earlier. But your note about the firewall does. So thanks

[SashaCX75]

In any case, this is strange behaviour. This is not a system folder so that administrator rights are required to work with it.

[Guydu91]

@apgeo
The others do not complain about this function working. So maybe you are doing something wrong. For example, you are trying to add a font that is already in the project folder.

I have already encountered this problem.
It is possible that the TTF file is corrupted.
So you have to save the JSON as is, then delete the Fonts folder in the Assets folder.
You also have to delete the Fonts folder in the Temp/Assets folder of the editor otherwise the error persists.
I think that some OTF files have been renamed to TTF without doing a real conversion (this is what happened to me).
In this case, just rename this file to OTF then convert it via an online converter to TTF (I use the site https://convertio.co/ ).
Then just reopen the JSON file and start adding the font again with the right file.
Best regards.
Guy.

[SashaCX75]

@Guydu91 When a font is added to a project, it is simply copied to the folder. So if it was simply renamed, it should not cause an error. Perhaps an error may occur when the editor tries to read the name of the font in the properties. But I have not encountered such an error.

When testing this function, I tried adding different fonts. Including those that had TTF extension but were not TrueType. Unfortunately, in most cases the editor could not recognise such fonts, and errors occurred on the watch.