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]

Further support for the editor has been discontinued due to the loss of the computer.

[GIK-Team]

Further support for the editor has been discontinued due to the loss of the computer.

Привіт! Може, є якісь варіанти і ми можемо чимось допомогти?

[TaZoUn3t]

hi guys,
i'm new here and i try to create my own watch face.
thank you for this beautiful software, it will help lots of noobs like me ^^.
Consider the situation, i really hope you are all safe...

Now i'm trying to pack my watch face, but i have a big error :



i have this message for all images of the watch face. i really don't understand how it could be, so...

Is someone knows how to fix it ?

EDIT :

I solved the problem moving the forder of the editor from the desktop to C:
like i said before, i'm a noob ^^

[rondolfo]

Further support for the editor has been discontinued due to the loss of the computer.

Thank gods you're still alive! I imagine you have other life priorities right now and probably forever more, but I for one would be happy to contribute to a new computer when things settle down for you. Please stay safe!
R

[shivman1990]

Hi Guys..i want to create my first watchface for zepp os. Can someone please make online tutorial on how to do a basic watchface? i have the tool but struggling to make sense of it. Thank you very much

[Farron]

shivman1990

Every single part, whether number, pointer, background or marker must be present as .png. You can also take the images from templates and resize them accordingly or design them yourself.
The editor helps you only to arrange everything sensibly.
Good luck

[shivman1990]

@shivman1990

Every single part, whether number, pointer, background or marker must be present as .png. You can also take the images from templates and resize them accordingly or design them yourself.
The editor helps you only to arrange everything sensibly.
Good luck

Thanks for your help. Which is the best source to find templates ?

[Mixmaxmux]

I wanted to congratulate for your work.
I wanted to ask you, if possible, how to implement smooth seconds.
using this tool, perhaps starting from a watchface that already implemented.

[Evilmind_04]

Further support for the editor has been discontinued due to the loss of the computer.

Damn ! I hope you're still okay.
Stay safe my friend.

[FeRu]

Did anyone notice that after FW update for GTR3 and GTR3Pro moon phases stoped working?
Or they working fine and this is only some kind bug in my watch....

[babigiov]

Did anyone notice that after FW update for GTR3 and GTR3Pro moon phases stoped working?
Or they working fine and this is only some kind bug in my watch....

Ciao Feru
I just upgraded to firmware 8.37.3.2 on GTR3 Pro and moon image in the watchface is correct. Could you please provide some more details about the malfunction?
Have you checked if the problem persists even with the store's Sun & Moon watchface?

[FeRu]

Ciao Feru
I just upgraded to firmware 8.37.3.2 on GTR3 Pro and moon image in the watchface is correct. Could you please provide some more details about the malfunction?
Have you checked if the problem persists even with the store's Sun & Moon watchface?

With sun and moon wf moon phases are not working also. In every wf with moon phases is empty area
I tried restart watch, reconnecting with phone etc and still no luck.

[babigiov]

With sun and moon wf moon phases are not working also. In every wf with moon phases is empty area
I tried restart watch, reconnecting with phone etc and still no luck.

Maybe try to wait a few days hoping it is a synchronization problem between the mobile app and some servers.
For example, a couple of days ago it happened to me that the sunrise and sunset times were wrong and the next day everything was back to normal.
We cross our fingers and I wish you everything works out
Ciao

[Max88]

Guys, do you know if there is a tool to extract and rebuild bin for amzfit bip U ?

[asoo]

Guys, do you know if there is a tool to extract and rebuild bin for amzfit bip U ?

Editor on web. ( only layout )
https://tnxec2.github.io/amazfit-gts2mi ... ce-static/

source for editor ( can use offline )
https://github.com/Tnxec2/amazfit-gts2m ... ace-static

Huaim online editor
https://watchface.huami.com/create

source for make main.exe to pack and unpack "BIN"
https://github.com/Tnxec2/py_amazfit_to ... e/GTS2mini

main.exe
viewtopic.php?p=12537#p12537

[Max88]

Guys, do you know if there is a tool to extract and rebuild bin for amzfit bip U ?

Editor on web. ( only layout )
https://tnxec2.github.io/amazfit-gts2mi ... ce-static/

source for editor ( can use offline )
https://github.com/Tnxec2/amazfit-gts2m ... ace-static

Huaim online editor
https://watchface.huami.com/create

source for make main.exe to pack and unpack "BIN"
https://github.com/Tnxec2/py_amazfit_to ... e/GTS2mini

main.exe
viewtopic.php?p=12537#p12537

Thank you for infos. About main.exe I haven't understood how to use it.

[asoo]

Spoiler

Guys, do you know if there is a tool to extract and rebuild bin for amzfit bip U ?

Editor on web. ( only layout )
https://tnxec2.github.io/amazfit-gts2mi ... ce-static/

source for editor ( can use offline )
https://github.com/Tnxec2/amazfit-gts2m ... ace-static

Huaim online editor
https://watchface.huami.com/create

source for make main.exe to pack and unpack "BIN"
https://github.com/Tnxec2/py_amazfit_to ... e/GTS2mini

main.exe
viewtopic.php?p=12537#p12537

Thank you for infos. About main.exe I haven't understood how to use it.

you can see command line main.exe by Type main /help or main -h in cmd ( Dos mode )

Spoiler

Spoiler

Codice: Seleziona tutto

d:\#GTS2mini-BipU>main -h
usage: main [-h] [--vergelite] [--gtr {42,47}] [--gtr2 {42,47}] [--gts] [--gts2] [--trexpro]
            [--oldformat] [--gts2mini] [--bipu] [--trex] [--x] [--file FILE [FILE ...]] [--to_raw]
            [--from_raw] [--border_alignment]

optional arguments:
  -h, --help            show this help message and exit
  --vergelite           force VergeLite watchface
  --gtr {42,47}         force GTR watchface
  --gtr2 {42,47}        force GTR2 watchface
  --gts                 force GTS watchface
  --gts2                force GTS2 watchface
  --trexpro             force TRexPro watchface
  --oldformat           force old json format for GTS2 or GTR2
  --gts2mini            force GTS2 Mini watchface
  --bipu                force Bip U watchface
  --trex                force T-REX watchface
  --x                   force AmazfitX watchface
  --file FILE [FILE ...]
                        watchface.bin - unpacks watchface images and config watchface.json - packs
                        config and referenced images to bin file
  --to_raw              save raw header and resources
  --from_raw            generate bin from raw folder
  --border_alignment    draw border around aligned objects in preview

Ex. command line unpack file BipU ( BIN )

Spoiler

Ps.
I think if asking about Bip U, I suggest you open a new topic in forum about Bip u viewforum.php?f=6 because this question may not be related to this topic.

[demiurg1]

Does anyone know any program to automatically convert watch faces from GTR 2 to GTR 3? They have the same size of watch faces. I would like to convert my projects for GTR 2 to GTR 3. Because these are my projects, so if necessary, I can disable eg editable zones.

[demiurg1]

Does anyone know any program to automatically convert watch faces from GTR 2 to GTR 3? They have the same size of watch faces. I would like to convert my projects for GTR 2 to GTR 3. Because these are my projects, so if necessary, I can disable eg editable zones.

[demiurg1]

Hello. I have been designing watch faces for Amazfit smartwatches for quite a long time. First there were watch faces for the GTR 47, then for the GTR 2 and now for the GTR 3. Due to for the possibility of using authentic animations, not quasi animations, as I did for the GTR 2, I was tempted to make a project using the online tool from HUAMI (Amazfit manufacturer). I made the project and uploaded the watch face to my GTR 3 using the QR-code displayed on the website (https://developer.zepp.com/#/home). The watch face works and it's OK. However, I would like to share it with other GTR 3 users who are not registered Amazfit watch face designers. I have the option to generate and download a file with a watch face design. In the case of my watch face it is some zipped file "VR MONTBLANC clex G3.zab" which contains: another zipped file "amazfit-gtr-3.zpk" and a file "manifest.json". This * .zpk file contains 2 consecutive zipped files: "app-side.zip" and "device.zip". The first one contains only the "app.json" file, and the second one contains 2 "assets" directories (with PNG images unreadable for me) and the "watchface" directory with the "amazfit-gtr-3" directory containing only one "index.js" file and in addition to this directory also 2 additional files: 'app.json' and 'app.js'. Does anyone know anything about what can be done next? If interested, I can try to send someone the "amazfit-gtr-3.zpk" file.
I am a fan of the watch face editing program from SashaCX75. I have always shared the watch faces made in it without any problems, and now I don't really know how to do it. Of course, these dials without animation and without editable zones will still be made with the SashaCX75 tool and made available in the traditional way through this website.

[SashaCX75]

demiurg1
The "device.zip" file (which contains the "assets" directory) is the watch face. To check, you can try downloading it to your watch or open it in my editor.

[SashaCX75]

Recently, the structure of the watch faces created on the Huami website has changed slightly, so they may not open in my editor.

[demiurg1]

Recently, the structure of the watch faces created on the Huami website has changed slightly, so they may not open in my editor.

=======================
Failure to load the file "device.zip" into your editor.
Unfortunately, this "device.zip" file downloaded from Huami's website in your editor does not open. There are only errors from the very beginning until the end of trying to load the watch face into your editor. However, all my designed graphics (including animation files) were properly unpacked to the "Watch_face \ device \ assets" directory. Unfortunately, the "json" file did not appear. I uploaded it to the "manually" directory, and then unpacked graphics appeared in your editor, but without any settings. The "device.zip" file was uploaded to the watch without any problems. Therefore, it is a half-success, because I can make such a watch face available, but not via this website.

[don1yoor]

Hello Guys I need help. How to create animated watchface for GTS 3

[1mylord]

The needle and cycle of the heart rate do not work the same.
This is because the needle is divided into six sections and acts like an image.
If possible, request that the needle and cycle work together.