If you experience any problems with the forum (it is not visible, there is no way to post messages, or some functionality does not work), please let us know.
If you have problems with registration or you did not receive confirmation letter, let us know and we will activate your account manually.
If you get an "The submitted form was invalid. Try submitting again" error, delete cookies, then try again.

ZeppOS Player 2

This forum is designed to discuss and develop tools creating watch faces.

Moderators: asoo, lvpokka, Internal error, Watchmens

Forum rules
All communication in this branch should only be in English.
To discuss tools that are not in this section, use the “Watchfaces tools (discussion)” forum.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

ZeppOS Player 2

Post by Lattenknaller »

Hi everyone,

Since melianmiko's Zepplayer hasn't been updated for 3 years, I decided to create a modern version.
All currently available watches are selectable, and it also includes special features such as animations, smooth second, circle second, etc. Both short and long tabs are supported.
It’s an alternative to the original ZEPP Simulator, which some users have had trouble with. It includes standard .GIF creation, where you can select the number of frames and the speed. The highlight is the screen recording feature, where you can test your watch face and, for example, execute color changes or other scripts supported by the player.

ZeppOS Player 2
Newest Release
Download v2.4.3
CHANGELOG
- Fixed stale diagnostics after watchface reloads and project switches. Warning/error entries and compatibility counters now reset for the newly loaded watchface, so resolved warnings disappear automatically after an auto-reload without requiring Refresh/F5.

v2.4.2
- Fixed project auto-reload so the first external file change is applied reliably. File changes are now briefly debounced until the project change token is stable, then exactly one runtime restart is performed.
- Fixed GIF dimensions after switching to a watch face for a different device size. Selecting a new watch face now performs a full runtime restart after device-profile detection, so GIF capture immediately uses the new screen dimensions without requiring a manual Restart Watchface/APP.

v2.4.1
- Added Random Auto-Increment as a separate playback mode. Simulated values are randomized independently while smooth-second and SECOND-based time remain synchronized to real time.
- Normal Auto-Increment and Random Auto-Increment are mutually exclusive and can be switched directly from the left toolbar.
- Fixed COMPASS CHANGE/CURRENT events so watch faces receive a Zepp-compatible compass result object, including calibration_status and direction_angle.
- Expanded the finished-watch-face runtime compatibility layer with HRV, BioCharge/HybridCharge, separate Beaufort wind and km/h wind-speed data, additional modern and legacy Zepp data types, sensors, widgets, and safer fallbacks for unknown data types.
- Improved modern app.json target selection, asset-path handling, intrinsic image sizing, and protection against zero-size render canvases.
- Added END_X/END_Y layout properties, layoutChange callbacks, API-level 4-style direct widget property access, typed SysPro persistence, and additional runtime compatibility modules.
- Fixed getForecastWeather initialization so watch faces using forecast data no longer fail during the initial resume_call, and stored forecast weather icons are now returned correctly.
- Forecast editor changes now immediately re-run WIDGET_DELEGATE resume_call so script-driven forecast displays update at once; per-day weather icon selection has also been restored.
- Moon phase now changes during normal Player playback as well as during randomized GIF recording.
Older Versions
VERSION 2.3
Download v2.3.4
CHANGELOG
2.3.4 · September 17, 2026
- Corrected TEXT_IMG angle rendering so that the configured X/Y coordinates remain the widget origin after rotation.
2.3.3 · September 17, 2026
- Combined compatibility reports and live performance diagnostics in a single analysis window.
- Metrics for live render time, widgets, assets, memory, errors, and warnings have been added
- Added watch face-specific reports for unsupported hmUI properties and current runtime issues.
- “Compatibility & Performance” has been integrated as a fixed third Studio window; the Explorer has been moved to the fourth position; and one-click report export has been added.
- The rendering of rotated TEXT_IMG elements for the Zepp OS “angle” property has been corrected.
- The display of circular TEXT/TEXT_FONT elements for “start_angle,” “end_angle,” “radius,” and “mode” has been corrected to match the inner/outer direction and alignment in the watch face editor, including the output of TEXT_FONT “unit_type.”
2.3.2 · September 16, 2026
- A full-featured editor for the seven-day weather forecast has been added, with separate entries for current, high, and low temperatures, as well as a weather icon for each day.
- The values from the forecast editor are now fed directly into the simulated Zepp OS weather forecast API.
- Translations for the forecast editor have been added for all six included languages, and the “Translations.xlsx” file has been synchronized.
2.3.1 · September 16, 2026
- All six user interface translations have been moved to separate language files for easier maintenance and review.
- Tooltip localization has been expanded so that dynamically assigned title attributes now use the selected user interface language.
2.3 · September 16, 2026
- The Status Editor now indicates whether each value is actually required by the loaded watch face.
- Compact function indicators have been added without altering the approved layout of the Status Editor: green means “used by the watch face,” a gray border means “supported but not used,” and yellow means “not yet supported.”
- The dial usage diagnostics are reset every time a different project is loaded to prevent outdated status information.
- Placeholder controls for custom scripts, which previously could be edited without affecting the dial, have been disabled; they are now explicitly marked as not yet supported, rather than appearing to function.
- The Studio layout has been redesigned and now includes a fixed preview area measuring 650 × 820, an 800 × 820 Status Editor/Console stack with a 70/30 split, and a flexible, full-height Object Explorer.
- Automatic tool rearrangement has been added when the Status Editor, Console, or Object Explorer is hidden.
- The Status Editor has been divided into tabs.
- Translated drop-down values have been added for time, months, days of the week, weather conditions, and forecast days.
VERSION 2.2
Download Release 2.2.1
CHANGELOG
- 33 standardized watch skins in 800 × 800 format with corrected alignment have been added.
- Support for Amazfit Active 3 Premium, Active Edge, Cheetah Square, and GTS 3, as well as additional hardware IDs for existing models, has been added.
- Czech has been added, and a revised Thai translation has been integrated.
Missing translations for the labels in the Status Editor have been restored in all supported languages.
VERSION 2.1
Download Release 2.1.3
CHANGELOG
- Older generated callbacks such as “checkConnection,” “minute_circle_call,” and “hour_circle_call” no longer interrupt the watch face initialization.
- Zepp groups with a size of zero now render their child elements correctly, restoring generated multi-day weather forecasts.
- Russian and Ukrainian have been added as user interface languages.
- Animations on watch faces, in the editor, and in custom scripts continue to run when “Auto-Increment” is disabled, while second hands, “smooth_second,” and SECOND-based circles remain frozen.
- “Smooth Second” hands remain fixed in still-image preview mode and run in real time during auto-incrementing without affecting the speed of other preview values.
- The link in the footer of the original ZeppPlayer now opens the official GitHub repository.
VERSION 2.0
Release Start
Translate missing language
TRANSLATE for v2.4
Translations.xlsx
For a new language fill out the Excel file and send it to me via private message.
Rename ROW 5 in the new column and fill it out completely. Keep the placeholders in {curly braces} unchanged. Then fill out the table at the bottom of the “Languages” tab (note can be left blank)
Please post any errors, requests, suggestions, etc., here in the forum and not via private message. Private messages with this content will be deleted without a response.
A detailed description of the issue in English is required.
Last edited by Lattenknaller on 22 Sep 2026, 05:26, edited 26 times in total.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

MarioLie wrote: 16 Sep 2026, 09:07
I will add HAYLOU and Redmi models.
Preview
Image
Added HUAWEI WATCH GT
Huawei
Image
That won't happen; it is and will remain a ZeppOS-Player for Amazfit watches. But thanks anyway.
User avatar
asoo
Posts: 2226
Joined: 03 Jan 2019, 01:48
Location: ͼͽ Thailand ͼͽ
Has thanked: 441 times
Been thanked: 2142 times
Contact:

Post by asoo »

I found the issue if use some widget's property, it will displaying not correctly in the simulator:
- Text image: The simulator displays incorrectly if the `angle` property is used.
- Text font: The simulator displays incorrectly if the `start_angle` and `end_angle`and `unit_type` property are used.
Please refer to the attached image.
Best regards,
Preview issue
somefunction.png
somefunction.png (294.92 KiB) Viewed 540 times
ͼͽ To request please use the interrelated forum in action ͼͽ
Please do not PM to me for requests ported watchface.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

I'll take a look at that. I was actually just about to release version 2.3 with the complete redesign of the windows. But feature updates take priority.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

ZeppOS Player 2.3.4

Download v2.34
CHANGELOG
2.3.4 · September 17, 2026
- Corrected TEXT_IMG angle rendering so that the configured X/Y coordinates remain the widget origin after rotation.
2.3.3 · September 17, 2026
- Combined compatibility reports and live performance diagnostics in a single analysis window.
- Metrics for live render time, widgets, assets, memory, errors, and warnings have been added
- Added watch face-specific reports for unsupported hmUI properties and current runtime issues.
- “Compatibility & Performance” has been integrated as a fixed third Studio window; the Explorer has been moved to the fourth position; and one-click report export has been added.
- The rendering of rotated TEXT_IMG elements for the Zepp OS “angle” property has been corrected.
- The display of circular TEXT/TEXT_FONT elements for “start_angle,” “end_angle,” “radius,” and “mode” has been corrected to match the inner/outer direction and alignment in the watch face editor, including the output of TEXT_FONT “unit_type.”
2.3.2 · September 16, 2026
- A full-featured editor for the seven-day weather forecast has been added, with separate entries for current, high, and low temperatures, as well as a weather icon for each day.
- The values from the forecast editor are now fed directly into the simulated Zepp OS weather forecast API.
- Translations for the forecast editor have been added for all six included languages, and the “Translations.xlsx” file has been synchronized.
2.3.1 · September 16, 2026
- All six user interface translations have been moved to separate language files for easier maintenance and review.
- Tooltip localization has been expanded so that dynamically assigned title attributes now use the selected user interface language.
2.3 · September 16, 2026
- The Status Editor now indicates whether each value is actually required by the loaded watch face.
- Compact function indicators have been added without altering the approved layout of the Status Editor: green means “used by the watch face,” a gray border means “supported but not used,” and yellow means “not yet supported.”
- The dial usage diagnostics are reset every time a different project is loaded to prevent outdated status information.
- Placeholder controls for custom scripts, which previously could be edited without affecting the dial, have been disabled; they are now explicitly marked as not yet supported, rather than appearing to function.
- The Studio layout has been redesigned and now includes a fixed preview area measuring 650 × 820, an 800 × 820 Status Editor/Console stack with a 70/30 split, and a flexible, full-height Object Explorer.
- Automatic tool rearrangement has been added when the Status Editor, Console, or Object Explorer is hidden.
- The Status Editor has been divided into tabs.
- Translated drop-down values have been added for time, months, days of the week, weather conditions, and forecast days.
Last edited by Lattenknaller on 17 Sep 2026, 10:12, edited 1 time in total.
User avatar
asoo
Posts: 2226
Joined: 03 Jan 2019, 01:48
Location: ͼͽ Thailand ͼͽ
Has thanked: 441 times
Been thanked: 2142 times
Contact:

Post by asoo »

Thank you very much for adding this feature.
However, it appears that in the "Text image" section, the X and Y coordinates are displayed incorrectly after rotating the image.
Please see the attached image.
with Angle
ang1.png
ang1.png (227.22 KiB) Viewed 506 times
without Angle
without Angle, it's no issue
ang2.png
ang2.png (194.89 KiB) Viewed 506 times
ͼͽ To request please use the interrelated forum in action ͼͽ
Please do not PM to me for requests ported watchface.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

Damn, thought I'd tested all the variations. A hotfix is online v2.3.4.
User avatar
SashaCX75
Posts: 832
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 15 times
Been thanked: 1045 times
Contact:

Post by SashaCX75 »

Screenshot
Image
Image
The text is cut off on the right-hand side
If you enable ‘Object Browser’, it isn’t visible. There might be a scroll bar at the bottom, but it isn’t visible.
The blocks are much too tall. That’s why a scroll bar is always displayed on the right, even if you hide all the blocks.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

Thanks, I noticed that today, too, when I had to use my laptop for a moment. There will be a scaling update with the 2.4 release.
User avatar
asoo
Posts: 2226
Joined: 03 Jan 2019, 01:48
Location: ͼͽ Thailand ͼͽ
Has thanked: 441 times
Been thanked: 2142 times
Contact:

Post by asoo »

I am not sure if I am checking this correctly.
In the Zepp Player, if the alarm is set to 0 (rather than 0:00), the program does not display the "Alarm ON" icon.
However, in the ZeppOS Player, I cannot find a way to make the icon "Alarm ON" status non appearing.
Sample image
alarm.png
alarm.png (714.02 KiB) Viewed 441 times
ͼͽ To request please use the interrelated forum in action ͼͽ
Please do not PM to me for requests ported watchface.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

Right, my mistake.
For the alarm, there is now an additional option: 0 = OFF
When set to 0, ALARM_CLOCK still correctly returns false
This causes the “Alarm ON” status icon to disappear
Any time, such as 07:00, 09:30, etc., still means the alarm is active
Comes with version 2.4
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

Since v2.4 will take a while, I've already fixed a few bugs in 2.3.4.
- ALARM can now be set to 0-OFF
- Various custom scripts have been fixed
- Scaling for lower resolutions
Just download 2.3.4 again. The file has been replaced on the server.
taw_bip
WF maker
Posts: 136
Joined: 12 Apr 2018, 16:29
Has thanked: 136 times
Been thanked: 21 times
Contact:

Post by taw_bip »

Thanks for all the work on this. Maybe it's something simple I'm not understanding, but how do you re-open a watchface after it's been added to the projects folder?
User avatar
asoo
Posts: 2226
Joined: 03 Jan 2019, 01:48
Location: ͼͽ Thailand ͼͽ
Has thanked: 441 times
Been thanked: 2142 times
Contact:

Post by asoo »

taw_bip wrote: 18 Sep 2026, 15:21
Thanks for all the work on this. Maybe it's something simple I'm not understanding, but how do you re-open a watchface after it's been added to the projects folder?
You mean, once you've created the watchface folder inside the project folder, how do you open that watchface—is that right?

If yes, After you finish copying the files, simply click the "rescan projects folder..." button or F5. The watchface you copied to the project folder will then be added to the list.
Preview
cap2.png
cap2.png (95.19 KiB) Viewed 401 times
ͼͽ To request please use the interrelated forum in action ͼͽ
Please do not PM to me for requests ported watchface.
taw_bip
WF maker
Posts: 136
Joined: 12 Apr 2018, 16:29
Has thanked: 136 times
Been thanked: 21 times
Contact:

Post by taw_bip »

Ah, yes. Now I see. I'm not sure how I missed that before. Thank you!
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

ZeppOS Player 2.4

Download v2.4.2
CHANGELOG
- Fixed project auto-reload so the first external file change is applied reliably. File changes are now briefly debounced until the project change token is stable, then exactly one runtime restart is performed.
- Fixed GIF dimensions after switching to a watch face for a different device size. Selecting a new watch face now performs a full runtime restart after device-profile detection, so GIF capture immediately uses the new screen dimensions without requiring a manual Restart Watchface/APP.
Last edited by Lattenknaller on 22 Sep 2026, 05:28, edited 2 times in total.
User avatar
SashaCX75
Posts: 832
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 15 times
Been thanked: 1045 times
Contact:

Post by SashaCX75 »

screenshot
Image
Translation is missing from the project folder selection dialogue.
The compatibility block does not fit on the screen. With this block configuration, the Object Explorer block is not visible at all.
User avatar
SashaCX75
Posts: 832
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 15 times
Been thanked: 1045 times
Contact:

Post by SashaCX75 »

I’m not sure what’s causing it, but I’ve noticed some odd behaviour. I’m editing a file in the projects folder. The changes aren’t visible in the player until I perform some action that triggers a screen refresh. Then I change that same file back in the projects folder. And the change appears in the player automatically after a slight delay, without me having to do anything else.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

SashaCX75 wrote: 21 Sep 2026, 16:52
screenshot
Image
Translation is missing from the project folder selection dialogue.
The compatibility block does not fit on the screen. With this block configuration, the Object Explorer block is not visible at all.
I'll finish the translation. As for the other problem, you can zoom in on the window. Set it to 90% (or even smaller) in the top-right corner, and you should be able to see the windows. Otherwise, you can also hide windows using the four buttons.
SashaCX75 wrote:
I’m not sure what’s causing it, but I’ve noticed some odd behaviour. I’m editing a file in the projects folder. The changes aren’t visible in the player until I perform some action that triggers a screen refresh. Then I change that same file back in the projects folder. And the change appears in the player automatically after a slight delay, without me having to do anything else.
I'll take a look at that. Version 2.4.2 is coming anyway, because Asoo found another bug.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

User avatar
SashaCX75
Posts: 832
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 15 times
Been thanked: 1045 times
Contact:

Post by SashaCX75 »

Spoiler
Image
In the error report, this warning remains even if I switch to a dial that did not previously display such a warning.
User avatar
asoo
Posts: 2226
Joined: 03 Jan 2019, 01:48
Location: ͼͽ Thailand ͼͽ
Has thanked: 441 times
Been thanked: 2142 times
Contact:

Post by asoo »

SashaCX75 wrote: 21 Sep 2026, 19:29
Spoiler
Image
In the error report, this warning remains even if I switch to a dial that did not previously display such a warning.
I’ve encountered this issue as well; I have to press the refresh button or F5 every time I fix an error reported in the "warning" section to clear the notification. Otherwise, the notification persists even after the error has been resolved.
Spoiler
issuewr.PNG
issuewr.PNG (19.2 KiB) Viewed 186 times
ͼͽ To request please use the interrelated forum in action ͼͽ
Please do not PM to me for requests ported watchface.
Lattenknaller
Posts: 180
Joined: 09 Aug 2022, 08:43
Location: Hamburg
Has thanked: 62 times
Been thanked: 174 times
Contact:

Post by Lattenknaller »

ZeppOS Player 2.4

Download v2.4.3
CHANGELOG
- Fixed stale diagnostics after watchface reloads and project switches. Warning/error entries and compatibility counters now reset for the newly loaded watchface, so resolved warnings disappear automatically after an auto-reload without requiring Refresh/F5.
Post Reply

Return to “Watchfaces tools”

Who is online

Users browsing this forum: No registered users and 2 guests