- Notifications
You must be signed in to change notification settings - Fork1
Open-source Mastodon client for Amazfit ZeppOS-based watches
License
NotificationsYou must be signed in to change notification settings
griffi-gh/zepp-fediclient
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
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 sureDEPLOYMENT_TYPE
is set to"real"
in configuration.js.
(Optional) Some options can only be changed at compile-time, check/modifyconfiguration.js
as needed
Build and install from source:
- Run
zeus preview
in 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 login
and 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 logout
and 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 bridge
in 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)exit
to 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)
About
Open-source Mastodon client for Amazfit ZeppOS-based watches
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Releases
No releases published
Uh oh!
There was an error while loading.Please reload this page.