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]

What is the url to add a shortcut to the training history screen?...

Code: Select all

hmApp.startApp({url: 'SportRecordListScreen', native: true });
hmApp.startApp({url: 'SportScreen', native: true });

There are buttons like this in the editor.

[Zecodorna]

What is the url to add a shortcut to the training history screen?...

Code: Select all

hmApp.startApp({url: 'SportRecordListScreen', native: true });
hmApp.startApp({url: 'SportScreen', native: true });

There are buttons like this in the editor.

There is already an image in the background of the display...is it possible to make the button transparent?...

[SashaCX75]

@Zecodorna Set a transparent image on the button

[gingerbeardman]

Is it possible to set alignment "Primary-secondary Relationship: follow" like in watchface website?

Does anybody use that?

[asoo]

Is it possible to set alignment "Primary-secondary Relationship: follow" like in watchface website?

Does anybody use that?

I'm not sure if I understand correctly
In the editor, there is a section that works similar to watchfaceMaker
In Digital time,
in the minute section, there is a selection [ ] Follow the hour
And in the seconds section, there is a selection [ ] Follow the minute

And in the Date section, if you want to display it as numbers, there is something similar to what you want
You can choose "Day/Month/year by font"

I hope my answer is what you asked.

Spoiler

[gingerbeardman]

Thanks I'll try it.

Ideally I want to do it on things other than hours and minutes. Like date and day.

I'll check my app is the latest version.

I'm using Amazfit Band 7, zepp os 1.0, so I think I can't use TTF font only system font? I'm happy to be wrong about this.

[conan777]

thanks a lot sasha, but how to test the wf?

If you are asking how to install a watch face on a watch, here are the instructions
viewtopic.php?t=3873

Hello, I've followed the steps to install a watchface on my BIP 6, having done it for a GTS4, and it works fine, but I can't get the buttons to work. Is there anything special that needs to be done differently with previous versions of the program? I followed the same steps as I did previously for the BIP 5, but it doesn't work.

[asoo]

Hello, I've followed the steps to install a watchface on my BIP 6, having done it for a GTS4, and it works fine, but I can't get the buttons to work. Is there anything special that needs to be done differently with previous versions of the program? I followed the same steps as I did previously for the BIP 5, but it doesn't work.

If you want to check the problem like this, it is best to send the file that you have the problem with. Because if you don't send the file, I guess that those who want to help you will not be able to answer the problem.
And if possible, please open a new thread with a topic related to the issue you are having with the watchface you created.

As far as I tested, the 13.1 program can create Bip6 faces, including shortcuts and buttons, correctly.Just pack it as GTS4 and it can be used with Bip6.
So if the face file you created has the problem as you reported, I would recommend attaching the file you are having trouble with so that those who want to help can check it to find the error.

The button and shortcut section, as far as I have tested. There is nothing new. in the last beta still do that same as 13.1 in all respects.

[conan777]

Thank you very much, I see that it works now, I'm making another one and I hope that when I finish it I'll also manage to get it working.

[conan777]

Asso, could you send me the sphere files so I can save it?

[asoo]

Asso, could you send me the sphere files so I can save it?

?????
If you mean the watchface's file I edited in the thread you asked about, you can found link download is under the QR-Code.
viewtopic.php?p=20319#p20319
Why don't you ask in the topic that you opened?
This question it not about the editor at all. If you still ask about your watchface issue in Editor Topic , I won't answer. Becuase It makes the topic confusing.

[conan777]

Sorry, when I hit reply I thought I was in the topic I had started, I hadn't realized.

[EmaPolice]

Hi, how to unpack whatchface from zepp store?

https://mmk.pw/en/zepp_explorer/6553856/141750/

[asoo]

Hi, how to unpack whatchface from zepp store?

https://mmk.pw/en/zepp_explorer/6553856/141750/

The editor cannot unpack correct the watchface file that encode.
When you unpack watchface file that encode.
You will only receive the images used to create the watchface.
You must use the images to create a new watchface by yourself.

The watchface you mentioned in the link is a watchface that is encoded in a script, so as far as I know you can only do what I said.

[Emiliomc]

Hi, I'm trying to figure out if it's possible to do something with a watchface on my Amazfit GTS 4 device using SashaCX7's app. The GTS 4's screen can be turned on by pressing the crown button or by raising my arm. I'd like to have the option (which the GTS 4's settings don't offer) to turn the screen on by tapping the screen, like a smartband. I thought about creating a watchface with a black AOD and setting the GTS to "Always On." I also wanted to add a button to the AOD (which the app doesn't allow) that would turn the screen on when clicked. Also, there's no such option to add a button.

Do you have any ideas for how to do what I want?

[SashaCX75]

@Emiliomc You can try to add a listener for the image instead of the button. But I think it will not help. Most likely gesture tracking in AOD mode is disabled at the firmware level.
https://docs.zepp.com/docs/1.0/referenc ... tListener/

[Emiliomc]

Thanks. I'll try it when I can. Although it's probably what you're saying... That it's not possible. A few days ago I contacted Zepp requesting an update regarding the screen turning on via touch, but they most likely won't respond and won't update it. I'll try your suggestion. See if I have any luck.

[C2M]

Hi all,

I'm getting the following error while trying to pack a watch face in the editor. I get the same error when generating a gif.

Unhandled exception has occurred in your application. If you click Continue, the application will ignore this error and attempt to continue. If you click Quit, the application will close immediately.
Index was out of range. Must be non-negative and less than the size of the collection.
Parameter name: index.

When I click on Details I get the following message:

Spoiler

Code: Select all

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

************** Exception Text **************
System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection.
Parameter name: index
   at System.ThrowHelper.ThrowArgumentOutOfRangeException(ExceptionArgument argument, ExceptionResource resource)
   at Watch_Face_Editor.Form1.IMG_NUMBER_Year_Options(hmUI_widget_IMG_NUMBER img_number_year, String show_level, Int32 tabOffset)
   at Watch_Face_Editor.Form1.AddElementToJS(Object element, String show_level, String& variables, String& items, String& scale_update_function, String& resume_call, String& pause_call, String& time_update, String& text_update, String& fonts_cache, String& compass_update, String& compass_error, String& weather_few_days, String& weather_few_days_end)
   at Watch_Face_Editor.Form1.JsonToJS(String& variables, String& items)
   at Watch_Face_Editor.Form1.button_pack_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.9300.0 built by: NET481REL1LAST_C
    CodeBase: file:///C:/Windows/Microsoft.NET/Framework/v4.0.30319/mscorlib.dll
----------------------------------------
Watch_Face_Editor_(ZeppOS)
    Assembly Version: 13.1.0.0
    Win32 Version: 13.1.0.0
    CodeBase: file:///C:/XXX/Watchface%20Editor/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:///C:/XXX/Watchface%20Editor/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.9297.0 built by: NET481REL1LAST_C
    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:///C:/XXX/Watchface%20Editor/Libs/ControlLibrary.DLL
----------------------------------------
ControlLibrary.resources
    Assembly Version: 1.0.0.0
    Win32 Version: 1.0.0.0
    CodeBase: file:///C:/XXX/Watchface%20Editor/Language/en/ControlLibrary.resources.DLL
----------------------------------------
Watch_Face_Editor_(ZeppOS).resources
    Assembly Version: 13.1.0.0
    Win32 Version: 13.1.0.0
    CodeBase: file:///C:/XXX/Watchface%20Editor/Language/en/Watch_Face_Editor_(ZeppOS).resources.DLL
----------------------------------------
Magick.NET-Q16-AnyCPU
    Assembly Version: 7.17.0.0
    Win32 Version: 7.17.0.1
    CodeBase: file:///C:/XXX/Watchface%20Editor/Libs/Magick.NET-Q16-AnyCPU.DLL
----------------------------------------
DotNetZip
    Assembly Version: 1.16.0.0
    Win32 Version: 1.16.0
    CodeBase: file:///C:/XXX/Watchface%20Editor/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.

If I click on continue the packing never finishes and no zip file is created.

Any idea what could be the cause of this?

Thanks a lot

[SashaCX75]

@C2M Send the project in which the error occurs so that we can investigate it.

[C2M]

Here it is (heavily inspired by Distant Peaks from Avoska1988).

Thank you for your help!

[SashaCX75]

@C2M You have elements on your AOD that refer to the image ‘temp_0’ which does not exist. Fix it.

[C2M]

This fixed it. I don't use AOD so I completely forgot about it... Rookie mistake.

Thanks a lot!

[gingerbeardman]

(Also mentioned on Zepp Discord)

Interesting finding regarding zepp store distribution of watch faces created using this tool.

- I built a watch face with this tool
- I submitted it to Zepp using Zeus cli
- It was approved and has had thousands of downloads in the past couple of weeks
- Today, it was removed/unapproved because the exported code uses Logger.

changes
- Easy 4 line change (one logger include/define, three logger calls)
- Version number bump, to fix error "The installation package version is too low"
- `zeus build` and reupload

so
- Maybe the watch face app can be updated to include this change?
- Maybe Zepp system could replace Logger with console.log automatically?

[Zepp Open Platform] watch face approval failed

Dear developer:

The watch face DIN you submitted has not been approved due to the following reasons:

Reason for Removal: The current watch face uses the Logger module, which may be unavailable in certain system environments, potentially causing the watch face to fail to load.
Suggested Fix: Please replace all instances of Logger in the source code with console.log to enhance compatibility and ensure proper loading. Once updated, you may resubmit it for review.

. Please understand and resubmit the watch face access request.

[SashaCX75]

@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.

[killmeplsok]

Hey, I just got a new watch 2 days ago and finds the official watch faces inadequate, and after some research I found this wonderful thread and tool to started working on my own watch face, it's been wonderful so far, but it's still a first time for me so I might be asking some stupid question (I have not been able to find related questions about this so far).

I was trying to work on a watch face that focuses on sleep tracking, so I was trying to get certain data such as BODY_TEMP and SLEEP working.

Based on my research on Zepp's documentation I might be able to rely on these 2 data:
hmSensor.id.SLEEP -> hmUI.data_type.SLEEP
hmSensor.id.BODY_TEMP -> hmUI.data_type.BODY_TEMP

But I couldn't find it anywhere on the tool's UI, am I missing something here?