README.md

FediClient

Open-source Mastodon client for Amazfit ZeppOS

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

Supported devices

• Amazfit Band 7 (Zepp OS 1.0)

(PRs welcome)

Screenshots

    

(Screenshots may be out of date)

Localization

Supported languages (contributions welcome):

• English (en-US)
• Ukrainian (uk-UA) (device-side only)
• Polish (pl-PL) (device-side only)

Install (on a real device)

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:

Using preview/QR-code:

1. 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
2. Open the Zepp App on your phone
3. Go to "Profile" -> "My devices" -> (tap on your device) -> "Developer Mode"
4. Switch to the "Mini Program" tab and tap the Plus (+) icon in the top-right corner
5. 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

Using the bridge mode:

1. 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
2. Open the Zepp App on your phone
3. Go to "Profile" -> "My devices" -> (tap on your device) -> "Developer Mode"
4. Switch to the "Mini Program" tab and tap the Plus (+) icon in the top-right corner
5. Select the "Bridge" option and wait for it to connect
6. Run zeus bridge in the project directory
   
7. Once it starts, type in the following commands:
   • connect (if prompted, select app-Android, wait for it to connect)
   • install (this may take up to a couple of minutes)
   • exit to exit the bridge mode
8. 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)