Features:
- Supports Mastodon API (/Sharkey) (Misskey support planned)
- Viewing timelines (Local/Public/Home)
- Viewing posts/post replies
- Profile pictures (dynamically generated tga; loaded asynchronously)
- Viewing post image attachments
- Viewing user profiles
- Posting (with a t-9 style keyboard)
- Authentication (optional, OAuth)
- Localization
- Amazfit Band 7 (Zepp OS 1.0)
(Screenshots may be out of date)
Supported languages (contributions welcome):
- English (en-US)
- Ukrainian (uk-UA) (device-side only)
- Polish (pl-PL) (device-side only)
Prerequisites:
- Make sure your device is supported (check the list above)
- Activate the Developer Mode is in the Zepp app (click for guide)
- Install Node.js/npm
- Install
zeus(npm i @zeppos/zeus-cli -g)
Warning: Make sure DEPLOYMENT_TYPE is set to "real" in configuration.js.
(Optional) Some options can only be changed at compile-time, check/modify configuration.js as needed
Build and install from source:
-
Run
zeus previewin the project directory- If prompted, select your device from the list
- This should build the application, upload it and generate a temporary QR code
- Open the Zepp App on your phone
- Go to "Profile" -> "My devices" -> (tap on your device) -> "Developer Mode"
- Switch to the "Mini Program" tab and tap the Plus (+) icon in the top-right corner
-
Select the "Scan" option and scan the QR code generated by
zeus(step 1)- If you're unable to scan the QR code using your camera, use the "Open G..." button (in the top-right corner, on the "Scan" screen) to select a screenshot of the code instead
-
Run
zeus loginand follow the on-screen instructions.- Make sure to use the same Zepp account as in the Zepp app on your phone.
- If you accidentally used a wrong account, use
zeus logoutand try again
- Open the Zepp App on your phone
- Go to "Profile" -> "My devices" -> (tap on your device) -> "Developer Mode"
- Switch to the "Mini Program" tab and tap the Plus (+) icon in the top-right corner
- Select the "Bridge" option and wait for it to connect
-
Run
zeus bridgein the project directory
-
Once it starts, type in the following commands:
-
connect(if prompted, selectapp-Android, wait for it to connect) -
install(this may take up to a couple of minutes) -
exitto exit the bridge mode
-
-
Follow the steps 2-5 again to disable the bridge mode in the Zepp App.
This should disconnect the watch from the bridge server.
(Alternatively, you can just wait a couple of hours, the app will disconnect bridge mode automatically)