• Administrator
  •  
    Support Ukraine
    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.
     

Running the AmazFit Watch Face Editor (ZeppOS) on Linux via Wine – Full Guide

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.
Post Reply
citizenserious
Posts: 8
Joined: 19 Apr 2025, 17:56
Location: μπ
Has thanked: 1 time
Been thanked: 2 times
Contact:

Running the AmazFit Watch Face Editor (ZeppOS) on Linux via Wine – Full Guide

Post by citizenserious »

First of all, thanks to @SashaCX75 again for this great tool. I’m a Linux-only user and wanted to share my experience getting the Watch Face Editor (ZeppOS) viewtopic.php?t=2743 running successfully under Fedora 42 using Wine. This should work similarly on other distributions.

🧰 Step-by-step setup process

1. Install Wine and Winetricks (via package manager)

On Fedora:

Code: Select all

sudo dnf install wine winetricks
This will install the latest native Wine (in my case: wine-10.4 (Staging)).

2. Create a clean Wine prefix

Code: Select all

export WINEPREFIX=~/wine-amazfit-editor
export WINEARCH=win32
winecfg
- Set Windows version to Windows 7 in the winecfg dialog.

3. Install .NET Framework 4.8

Code: Select all

winetricks dotnet48
⚠️ You’ll need to go through several Microsoft .NET installers (4.0 through 4.8). Accept all licenses and click “Finish” each time. Do not install optional extras.

📦 Installing the Watch Face Editor

Extract the ZIP file (Watch_Face_Editor_(ZeppOS)_v13.1.zip) to a clean folder without spaces or special characters:

Code: Select all

mkdir -p ~/WineApps/WatchFaceEditor
unzip "~/Downloads//Watch_Face_Editor_(ZeppOS)_v13.1.zip" -d ~/WineApps/WatchFaceEditor

▶️ How to start the editor

You can start the editor with:

Code: Select all

WINEPREFIX=~/wine-amazfit-editor wine "home/YOURUSER/WineApps/WatchFaceEditor/Watch_Face_Editor_(ZeppOS).exe"
⚠️ If the filename contains spaces or parentheses, always quote it properly.
Replace YOURUSER with your username.
🖼 Desktop integration (optional)

If you want to launch it from your app menu, create a small shell script like this:

Code: Select all

#!/bin/bash
export WINEPREFIX="$HOME/wine-amazfit-editor"
wine "$WINEPREFIX/drive_c/Program Files/WatchFaceEditor/Watch_Face_Editor_(ZeppOS).exe"
Then create a .desktop file pointing to this script, and place it in ~/.local/share/applications/.

🧩 Summary
ComponentStatus
Wine Compatibility✅ Good
.NET 4.8 support✅ Working via Winetricks
Watch Face Editor GUI✅ Launches and works
Desktop launcher✅ Works
Hope this guide helps other Linux users to run the Amazfit Watch Face Editor smoothly under Wine! 🐧
Last edited by citizenserious on 10 May 2025, 21:50, edited 6 times in total.
User avatar
SashaCX75
Posts: 812
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 13 times
Been thanked: 1007 times
Contact:

Post by SashaCX75 »

The editor uses standard file selection dialogs, so it is strange that they cause problems.
Is this problem only with the *.zip file selection dialog or with all dialogs?
If you open files not through a dialog but in the context menu of the file choose to open it with the editor (I don't know how it looks like in Linux) does it work?
citizenserious
Posts: 8
Joined: 19 Apr 2025, 17:56
Location: μπ
Has thanked: 1 time
Been thanked: 2 times
Contact:

Post by citizenserious »

I think it could be related to the preset file filter. .json files are shown when opening a project.
1.png
1.png (50.86 KiB) Viewed 2133 times
User avatar
SashaCX75
Posts: 812
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 13 times
Been thanked: 1007 times
Contact:

Post by SashaCX75 »

If you are interested in this, I can try to see what the difference in filters is and make a test version. At least add all files to the selection. But it will be necessary for you to check whether this variant works or not.
citizenserious
Posts: 8
Joined: 19 Apr 2025, 17:56
Location: μπ
Has thanked: 1 time
Been thanked: 2 times
Contact:

Post by citizenserious »

Of course. That would be great. I am willing to test it. Thank you!
User avatar
SashaCX75
Posts: 812
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 13 times
Been thanked: 1007 times
Contact:

Post by SashaCX75 »

Are you using the editor in English?
citizenserious
Posts: 8
Joined: 19 Apr 2025, 17:56
Location: μπ
Has thanked: 1 time
Been thanked: 2 times
Contact:

Post by citizenserious »

Yes, I use it in English.
One request though. Could you please make a reproducible build with the code visible on GitHub or similar in the future? I have trust issues.

I will test your version in a virtual machine for now.
User avatar
SashaCX75
Posts: 812
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 13 times
Been thanked: 1007 times
Contact:

Post by SashaCX75 »

https://github.com/SashaCX75/AmazFit-Wa ... /tree/test
The source code for the editor is available on GitHub
citizenserious
Posts: 8
Joined: 19 Apr 2025, 17:56
Location: μπ
Has thanked: 1 time
Been thanked: 2 times
Contact:

Post by citizenserious »

Yes I know, and I thank you for that, but I downloaded the editor from Google Drive or Dropbox, which could be anything else, than the code on GitHub.
No one can be sure that it is the same code. There is just no way of verifying.
Don't get me wrong, but in most cases if you download a .exe from Dropbox, its malware, especially if the language is set to Russian.
citizenserious
Posts: 8
Joined: 19 Apr 2025, 17:56
Location: μπ
Has thanked: 1 time
Been thanked: 2 times
Contact:

Post by citizenserious »

@SashaCX75
The new version works (: and shows the zip files correctly now.
Thank you!
User avatar
SashaCX75
Posts: 812
Joined: 26 Oct 2019, 15:18
Location: Ukraine
Has thanked: 13 times
Been thanked: 1007 times
Contact:

Post by SashaCX75 »

Okay. I'll fix it in the next version.
The problem was caused by extra spaces in the filter. On Windows it works but Linux seems to be more sensitive to the format of the caption in the filter.
Post Reply

Return to “Watchfaces tools”

Who is online

Users browsing this forum: No registered users and 2 guests