https://github.com/griffi-gh/zepp-fediclient

Open-source Mastodon client for Amazfit ZeppOS
https://github.com/griffi-gh/zepp-fediclient

Last synced: 9 days ago
JSON representation

Open-source Mastodon client for Amazfit ZeppOS

• Host: GitHub
• URL: https://github.com/griffi-gh/zepp-fediclient
• Owner: griffi-gh
• License: mit
• Created: 2024-05-30T18:14:28.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-07-31T16:21:24.000Z (10 months ago)
• Last Synced: 2024-08-01T02:22:35.694Z (9 months ago)
• Language: JavaScript
• Homepage:
• Size: 1.61 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-zeppos - FediClient - Open-source Mastodon client for ZeppOS. (App / Social Media)

README

        


  

  


  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:




  


    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

    

  



Using the bridge mode:




  


    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, select app-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)