Skip to content

Latest commit

 

History

History
149 lines (134 loc) · 4.5 KB

README.md

File metadata and controls

149 lines (134 loc) · 4.5 KB

App logo
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

Main menu sceenshot  Timeline screenshot 1  Timeline screenshot 2

(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:

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)