Zepp OS gadgets¶

The following list includes all implemented features for Zepp OS devices. The actual supported features can vary for each device.

List of supported gadgets by Gadgetbridge which runs Zepp OS:

Implemented features¶

These features are supported by Gadgetbridge and apply to all Zepp OS watches included in this page. Note that actual available features per device depends on the device capabilities.

List of features supported by Gadgetbridge

Set time
World Clocks
Activity sync
- Activity (steps, HR)
- Heart Rate Variability (HRV)
- PAI
- Resting heart rate
- Sleep times
- Sleep stages (more accurate in Zepp OS 3.5 and above)
- Sleep respiratory rate
- Sleep score (for supported devices)
- SpO2 (blood oxygen)
- Stress (automatic and manual measurements)
- Body temperature (for supported devices)
- VO2 Max
- Workouts (summary, details)
  - gpx files include heart rate and segments on pause/resume
Canned Messages (Calls, SMS, Notifications). Request from watch on connection.
Alarms - Set / Request / Notification on change from watch
Calendar (create, delete, request events, set location, event notification delay)
Vibration Patterns (Set only, no request from watch)
User Info
Camera remote
- This simulates a volume press to take a photo in a camera app that is open
Notifications
- Send to watch
- Delete notifications on phone/watch when deleted on the other
- Calls
- Answer phone calls on watch
- Custom notification icons
- Reply to notifications from watch
- Pictures (only supported devices)
Workout
- Start/stop on phone when it starts/stops on watch
- Send GPS to watch (for watches without GPS)
Reminders (set, request from watch)
Contacts (for phone calls from watch)
Music
- Music Info
- Volume
- Music buttons
Device actions (fall asleep, wake up)
Real-time heart rate
Real-time steps
Find Phone from watch
- Stop on watch when stopped on phone
- Toggle between ring / vibrate
Battery Info
HTTP requests (we handle them selectively - for now only weather)
Set and request all configs. Non-extensive list:
- Display Items / Shortcuts
- Heart Rate
  - High-accuracy sleep tracking
  - Sleep breathing quality
  - All-day HR measurement, with high and low alerts
  - Stress monitoring, relaxation reminders
  - All-day SPO2 monitoring / low SPO2 alert
- Fitness goal / goal notification
- Password
- Language / react to change on band
- Screen brightness / timeout
- Screen On on notifications
- Distance / temperature unit
- Inactivity warnings (enabled, schedule, dnd, dnd schedule)
- Lift wrist (mode, schedule, sensitivity)
- Always on Display (mode, schedule)
- Night mode (mode, schedule)
- Do Not Disturb (mode, schedule)
- BT connection advertisement
- 3rd party realtime HR access
- Activity monitoring
- Auto-brightness
- Always-on Display Style
- Sound and Vibration
  - Alert tone
  - Cover to Mute
  - Volume
  - Vibrate for alerts
  - Crown vibration
  - Text to Speech
- Workout detection (category, alert, sensitivity)
- Keep screen on during a workout
- GPS
  - Presets, bands, combination, satellite search
  - AGPS expiry reminder
  - AGPS updates
- Sleep mode (sleep screen, smart enable)
- Long press upper button
- Short press lower button
- Control center display items (swipe from top of screen)
- Wearing direction
- Offline Voice
Install watchfaces
- Displays preview included in file
Install firmware upgrades (full and partial)
Install applications (both zip and zab files)
Install agps updates (EPO and UIHH files)
Upload GPX routes
Setting watchface from phone
Morning Updates
Shortcut cards (resident application settings)
Contact management
Taking screenshots (not supported on Mi Band 7)
Stress Sync and charts
PAI Sync and charts
Membership / loyalty cards with Catima
Sleep as Android integration
Logs from watch apps
Weather (daily, hourly)
Sun & Moon
Phone silent mode from watch
Download voice memos (for supported devices without wifi)
Developer settings
- Fetch watch OS debug logs
- Toggle wi-fi hotspot (supported watches)
- Toggle FTP server (supported watches)
- Display js app logs in Gadgetbridge logs

Known issues and limitations¶

Open issues

Do not forget to check any other open issues in the project repository.

3rd party realtime heart rate access is not working, even with the vendor app. This means that other apps such as OpenTracks will not be able to use these devices for heart rate measurement
Weather is missing some data, due to Gadgetbridge's own limitations
- Only works for a single location
- No tide support
Notification icons require high MTU (enable in device settings)
Updating reminders database when requesting from band is not implemented
Sleep data is sometimes off in older Zepp OS versions (before 3.5)

Missing features¶

App integrations
Calendar: repeating events
Heart rate manual measurement from phone
Music on device memory
- Already supported for devices without wifi, but it is unstable in Bluetooth LE mode. See the BT Classic section to upload larger music files.
Configure date and time format from phone
Application Management (experimental)
- Known issues: allows uninstall system apps (dangerous), does not always refresh the UI
Some configuration options on phone:
- Wake Up Alarm
- Sleep Mode
- Bedtime Reminders

Missing data synchronization¶

Sleep SpO2 (breath quality monitoring)
Max HR (no UI)
Manual HR measurements (no UI)

Missing integrations with built-in apps¶

Alexa (experimental feature)
Female Health / Cycle Tracking
Maps
Readiness
Sleep schedule
To-Do List
Zepp Coach
Zepp Flow
Voice replies (speech to text)

Maps upload¶

For devices that allow map download through bluetooth (devices without wifi), it is possible to upload map files.

The map files should consist of a zip file, with the following structure:

11
├── <latitude>
│   ├── <longitude>.img
│   ├── ...
│   └── <longitude>.img
└── <latitude>
    ├── <longitude>.img
    ├── <longitude>.img
    ├── ...
    ├── <longitude>.img
    └── <longitude>.img
...

Where:

11 is fixed, and corresponds to the OSM zoom level
Each img file corresponds to a tile
<latitude> and <longitude> is the tile number matching the OSM slippy map tilename for the zoom level 11, between 0 and 2048.

Tiles are in Garmin img format and can be encoded with tools like mkgmap.

Due to Gadgetbridge limitations, it is currently not possible to upload a zip file larger than 2MB in Bluetooth LE mode. You can try switching to BT Classic to upload larger files.

BT Classic¶

The nightly currently supports experimental BT Classic (also known as btrfcomm) connection for newer devices. BT Classic provides faster communication, and allows for the upload of larger files. Some devices that are known to use this connection type:

Amazfit Active 2
Amazfit Balance (in recent firmware versions)

Since most devices still support BT LE, that is currently the default, as it should be more stable.

You can enable BT Classic in the Connection settings, under "Force connection type".

If you have any feedback on BT Classic - either it working well or any issues - please open an issue or reach out on Matrix.

More information for developers¶

Check Zepp OS extras to enable experimental features and get more details for developers.