Skip to content

About

Collection of watch faces for Zepp/AmazFit smart watches

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Zepp watch faces

Watch faces for Amazfit watches running Zepp OS, designed for the Balance 3 (480×480 round) and packaged for every round watch on Zepp OS API level 4.2 or later (480×480 and 466×466). Each face lives in faces/ and shares one asset pipeline, runtime helpers and an offline test harness.

Faces

Face
Sextant
Nautical and data-rich: a navy and brass time bar, six editable complications with compass-tick gauges, automatic red night mode, a mono theme and an outline always-on display.
amazfitwatchfaces.com
Twisted Sextant
Sextant with the corner complications turned to run along their gauges, and weather fixed at the top.
amazfitwatchfaces.com

Installing a face

Install from the Zepp store (in the Zepp app, open your watch's watch face store and search for the face's name) or from amazfitwatchfaces.com (links above).

To sideload instead (for testing, or a watch the stores don't offer), use the QR code in the face's README or on the install page: in the Zepp app, turn on Developer Mode (Profile → Settings → About, tap the Zepp logo 7 times), then Profile → your watch → Developer Mode → scan. A sideloaded face doesn't get store updates.

Each face is versioned separately. Its QR code always installs its latest release, and each release (with that face's changelog) appears on the repo's Releases page, so you can watch the repo for release notifications.

Repository layout

faces/<name>/      one watch face: app.json, watchface/ code, design/ generator,
                   assets/ (generated), scenarios/, screenshots/, docs/
lib/js/            shared runtime helpers (formatting, sunrise/sunset, metrics)
lib/py/zfkit/      shared generator helpers (fonts, icon artwork)
tools/             asset runner, offline harness, previews, QR + Pages site, new-face template
fonts/             OFL source fonts

Development

See docs/development.md.

pip install -r tools/requirements.txt && npm install
npm run assets                       # regenerate every face's images + layout
npm test                             # run every face's code against stubbed Zepp OS APIs
npm run previews                     # quick offline renders for prototyping (faces/*/previews)
npm run emu -- start                 # real Zepp OS firmware in QEMU (setup: docs/development.md)
npm run screenshots -- sextant       # retake a face's screenshots on the emulator
npm run new-face -- mynewface        # start a new face from Sextant as a template

License

  • Shared code and tooling (lib/, tools/, CI): MIT.
  • Each face (faces/<name>/): CC BY-NC-SA 4.0. Share and remix it non-commercially with credit, but don't sell it or its derivatives.
  • Face names aren't licensed for reuse.
  • Fonts: SIL Open Font License.

Details are in LICENSE.

About

Collection of watch faces for Zepp/AmazFit smart watches

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages