https://github.com/ZoLArk173/Authenticator

A 2FA app for Zepp OS powered smart watch
https://github.com/ZoLArk173/Authenticator

2fauth zeppos

Last synced: 3 months ago
JSON representation

A 2FA app for Zepp OS powered smart watch

• Host: GitHub
• URL: https://github.com/ZoLArk173/Authenticator
• Owner: ZoLArk173
• License: mit
• Created: 2022-08-18T14:37:13.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-08-14T08:39:49.000Z (about 1 year ago)
• Last Synced: 2024-04-09T03:13:10.926Z (7 months ago)
• Topics: 2fauth, zeppos
• Language: JavaScript
• Homepage:
• Size: 303 KB
• Stars: 19
• Watchers: 2
• Forks: 6
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-zeppos - Authenticator - An 2FA app for Zepp OS. (Libraries / Lib)

README

        
# Authenticator

An 2FA app for Zepp OS

# Features

- Display 2FA codes on the Zepp OS enabled watches.

- Manage 2FA codes inside Zepp app settings page.

# Usage

After install the app, go to Authenticator setting under "More Settings" on Zepp app. You can add 2FA URI to the list by tapping the blue button.

Now, the URI must be formatted as following:

```

otpauth://totp/{ACCOUNT_NAME}?secret={SECRET}&issuer={ISSUER}

```

- `{ACCOUNT_NAME}`: The account name, e.g. [email protected]

  - Notice that some character like `:` or `@` will be converted to other code when you copy. You can edit it if it doesn't display properly.

- `{SECRET}`: The secret key

- `{ISSUER}`: The issuer of the code, which will be display as the title. e.g. Google

After adding URI, you can open the Authenticator app on the watch. The watch will sync the data from the phone every time it launched. You may see the 2FA 6-digit code on the screen!

# Future Improvements

This app is a prototype. There are a lot of things can be improved.

- Cannot rearrange 2FA codes.

- Cannot import URI without manual edit.

- Won't auto update every 30 secs.

- The UI of the settings page is less than desired.

- The UI on the GTS 3 is less than desired.

# Notes

Some part of code is come from [demos of Zepp OS developer documentation](https://github.com/zepp-health/zeppos-samples).

2FA code calculation part is come from [iamyuthan/2FA-Solver](https://github.com/iamyuthan/2FA-Solver).

Special thanks to them!

# Random

There are only several apps that available to Zepp OS enabled watches. And some of them are kind of useless or games. It is kind of disappointing that Zepp OS is capable of running third-party apps while maintaining the excellent battery life, while there are only a few useful apps in the App Store. Then a 2FA app comes to mind,  a useful application that can show 6-digit code handy when you login. It is also my first time developing with JavaScript, which you can tell from by terrible coding style in this project.