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

[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

Component	Status
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!

[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]

I think it could be related to the preset file filter. .json files are shown when opening a project.

1.png (50.86 KiB) Viewed 2133 times

[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]

Of course. That would be great. I am willing to test it. Thank you!

[SashaCX75]

https://www.dropbox.com/scl/fi/m3j7c4ow ... ljm5w&dl=0

Try this version.

[SashaCX75]

Are you using the editor in English?

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

[SashaCX75]

https://github.com/SashaCX75/AmazFit-Wa ... /tree/test
The source code for the editor is available on GitHub

[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]

@SashaCX75
The new version works (: and shows the zip files correctly now.
Thank you!

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