https://github.com/novvember/amazfit-watchfaces
⌚ Watchfaces for round Amazfit smart watches (ZeppOS)
https://github.com/novvember/amazfit-watchfaces
amazfit amazfit-gtr-4 amazfit-gtr-mini smartwatch watch-face watch-faces watchface zepp zeppos
Last synced: about 1 month ago
JSON representation
⌚ Watchfaces for round Amazfit smart watches (ZeppOS)
- Host: GitHub
- URL: https://github.com/novvember/amazfit-watchfaces
- Owner: novvember
- License: gpl-3.0
- Created: 2024-01-06T12:21:18.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-22T21:48:38.000Z (5 months ago)
- Last Synced: 2026-01-23T14:25:53.483Z (5 months ago)
- Topics: amazfit, amazfit-gtr-4, amazfit-gtr-mini, smartwatch, watch-face, watch-faces, watchface, zepp, zeppos
- Language: JavaScript
- Homepage:
- Size: 67.4 MB
- Stars: 43
- Watchers: 3
- Forks: 5
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
# Watchfaces for Amazfit Smartwatches
Here you'll find a variety of watchfaces I've designed for my round Amazfit watch. Some are my original creations, while others are inspired by designs I've seen on other devices or images online, and I've developed them for Zepp OS.
Most of these watchfaces are adaptive, ensuring compatibility with any device featuring a round display. Additionally, most require ZeppOS 2 or higher. Further details are available below.
## Bug Reports, Support, and Feature Requests
I strive to ensure that my watchfaces are as bug-free as possible, but issues can still arise. It's also challenging to test them across all possible watch models and operating system versions.
If you discover a bug or want to share your experience with my watchfaces, feel free to reach out:
- Create an issue in the adjacent section here: https://github.com/novvember/amazfit-watchfaces/issues
- Email me directly: n.demitsuri@gmail.com
## Donations
All of my watchfaces are free to use. However, if you'd like to support further development or simply say thank you, you can make a donation: https://boosty.to/novvember/donate
## Watchfaces Gallery
| | | | |
|:---:|:---:|:---:|:---:|
| 
[Text Lines](./src/watchfaces/text-lines/) | 
[Spin](./src/watchfaces/spin/) | 
[Gauge](./src/watchfaces/gauge/) | 
[Bourne](./src/watchfaces/bourne/) |
| 
[Celeste](./src/watchfaces/celeste/) | 
[Nothing Dial](./src/watchfaces/nothing-dial/) | 
[Spin 2](./src/watchfaces/spin-2/) | 
[11 weeks](./src/watchfaces/11-weeks/) |
| 
[Verbarius](./src/watchfaces/verbarius/) | 
[Elaborate](./src/watchfaces/elaborate/) | 
[Sektor](./src/watchfaces/nothing-sector/) | 
[Solar circle](./src/watchfaces/solar-circle/) |
| 
[Anicorn K452 Nemesis](./src/watchfaces/anicorn-k452-nemesis/) | 
[Spin 3](./src/watchfaces/spin-3/) | 
[X-Shock](./src/watchfaces/x-shock/) | 
[Grotesque](./src/watchfaces/grotesque/) |
| 
[Time Machine](./src/watchfaces/time-machine/) | 
[Concentric Data](./src/watchfaces/concentric-data/) | 
[Opposite Time](./src/watchfaces/opposite-time/) | 
[Sometimes](./src/watchfaces/sometimes/) |
| 
[Rider 1991](./src/watchfaces/rider-1991/) | 
[Kinetik](./src/watchfaces/kinetik/) | 
[Repelling Radial](./src/watchfaces/repelling-radial/) | 
[Modular](./src/watchfaces/modular/) |
| 
[Ara](./src/watchfaces/ara/) | 
[Symmetry Broken](./src/watchfaces/symmetry-broken/) | 
[Regulus](./src/watchfaces/regulus/) | 
[Horizon](./src/watchfaces/horizon/) |
| 
[Circlock](./src/watchfaces/circlock/) | 
[Needle](./src/watchfaces/needle/) | 
[Astro](./src/watchfaces/astro/) | 
[Gyroscope](./src/watchfaces/gyroscope/) |
| 
[Slices of Time](./src/watchfaces/slices-of-time/) | 
[Horizon 2](./src/watchfaces/horizon-2/) | 
[Glyph Matrix](./src/watchfaces/glyph-matrix/) | 
[Enigma](./src/watchfaces/enigma/) |
| 
[Typeface](./src/watchfaces/typeface/) | 
[Typeface 2](./src/watchfaces/typeface-2/) | 
[Corsa](./src/watchfaces/corsa/) | 
[Gradient Watch](./src/watchfaces/gradient-watch/) |
| 
[Asterisk Artclock](./src/watchfaces/asterisk-artclock/) | 
[Nonius](./src/watchfaces/nonius/) | 
[Segment 34](./src/watchfaces/segment-34/) | 
[Outbound](./src/watchfaces/outbound/) |
| 
[Gear Time](./src/watchfaces/gear-time/) | 
[Flux](./src/watchfaces/flux/) | 
[Fluid Pixels](./src/watchfaces/fluid-pixels/) | 
[Regarder](./src/watchfaces/regarder/) |
| 
[atan2](./src/watchfaces/atan2/) | 
[Echo](./src/watchfaces/echo/) | 
[Spin 4](./src/watchfaces/spin-4/) | |
## Repository Structure
```
├── scripts/ # Utility scripts
├── src/
│ ├── watchfaces/ # Watchface mini-projects
│ │ ├── face-1/
│ │ ├── face-2/
│ │ ├── face-3/
│ │ └── ...
│ └── types/ # Type declarations
└── README.md
```
## Watchface Installation Instructions
### Variant 1: Official Store (Easy)
1. Locate the watchface in the official Zepp store via the Zepp app. Most of these watchfaces are available there. But there is no search or direct links :(
2. Install it directly from the store.
### Variant 2: Unofficial Store (A Bit More Complex)
1. Visit the unofficial Zepp repository where some of my watchfaces previously available in the official store are automatically added:
https://mmk.pw/en/zepp_explorer/explorer/watch/?filters=%7B%22publisher%22:%201640%7D
2. Download the watchface or use the QR code provided.
### Variant 3: Zip File Installation (Medium Complexity)
This method is suitable for older versions of Zepp OS where you can install a side app using a zip file.
1. Visit the [releases page](https://github.com/novvember/amazfit-watchfaces/releases) of this repository.
2. Download the latest release by selecting the appropriate `.zip` file for your smartwatch model from the list below:
- **Default:** Amazfit GTR Mini - `...-MHS-416x416.zip`
- Amazfit GTR 4 - `...-NXP-466x466.zip`
- Amazfit GTR 3 - `...-NXP-454x454.zip`
- Amazfit GTR 3 Pro - `...-NXP-480x480.zip`
3. Transfer the downloaded file to your smartphone.
4. Utilize any compatible app to install the watchface from your phone's internal storage.
### Variant 4: QR Code Installation (More Complex)
1. Find and download the zip file as described in the previous variant.
2. Search online for a method to convert the zip file to a zpk file, then generate a QR code.
3. Use the QR code to install the watchface in developer mode within the Zepp app.
### Important Notes!
- Some texts are displayed with custom fonts. It requires devices with ZeppOS 2 and higher and is not compatible with older models like the GTR 3 and GTR 3 Pro.
- Please restart the watch after installation to ensure proper font display.
## Development Resources
### Getting Started
- [Official quick start guide](https://docs.zepp.com/docs/guides/quick-start/)
- Developer Environment Setup:
* Node.js (NB: maybe not all versions would work with `@zeppos/zeus-cli`)
* `npm i @zeppos/zeus-cli -g` (NB: need to be installed globally for `zeus` command)
### Useful Links
- [Zepp OS Watchface API](https://docs.zepp.com/docs/watchface/api/hmUI/createWidget/)
- [Official Watchface Maker](https://watchface.zepp.com/create)
- [GTR 4 Watchface Community on 4pda.to](https://4pda.to/forum/index.php?showtopic=1055207)