This application can run ZeppOS apps & watchfaces in your browser. Useful for homebrew development, faster and more flexible than the official ZeppOS Simulator, but a bit less compatible.


  • Windows 10+, or macOS Catalina+, or any Linux with python
  • Chromium-based browser, plain Chromium or Google Chrome is best. Firefox isn't fully supported.


Download archive for your operating system, unpack them somewhere.

Windows/macOS-users, just run ZeppPlayer from there.

Linux-users must suffer a bit more. Install python3 and python3-venv packages, then run ./start.sh inside application directory. This script will create venv, download all dependencies and run player. Just wait a bit.

How to add custom watch faces or apps

Just place them to projects directory. If you have them as bin file, rename it to zip and unpack.

In windows/linux, this directory is near application executable. In macOS, it was located in ~/Library/Application Support/ZeppPlayer. Easiest way to find it, just select <file manager> option in project picker (top left corner of player in browser). For troubleshooting you can run application with dev argument (eg ./start.sh dev), this will enable logging.

How to exit application

Find Zepp Player icon in system tray. Right-click them and select Exit.


  • Avoid defining variables without var/let/const. This variables become global, and modern browsers didn't allow that;
  • Real device (Smart Band 7) have some troubles with math, eg division and comparing. That limitations can't be emulated, so just keep in mind;
  • If you add _name prop to widget config, that name will be visible in Explorer. Example can be found in included Demo watch face.

(extra) Install as nodeJS package for CLI use

NodeJS and npm is required for that.

Open terminal/command prompt in application dir, type (macOS users must download linux-package to do that):

npm i
npm i -g .

Wait a while. After that, you can in any other command prompt use zepp-preview to generate previews.

zepp-preview [command]

    zepp-preview <projects...>  Preview a list of projects

        --help     Show help                                             [boolean]
        --version  Show version number                                   [boolean]
        --gif      With GIF preview                                      [boolean]
        --png      With PNG preview                      [boolean] [default: true]
    -o             Output path, {} will be replaced with current project path
                                                        [string] [default: "{}"]
thumb_up 7 thumb_down 0 chat Comments (0) favorite Donate