Lisoveliy/TOTPFit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v1.3 Fix of Google Authenticator migration support #9

Merged
Lisoveliy merged 5 commits from dev into main 2025-07-24 03:18:36 +02:00
Conversation 0 Commits 5 Files Changed 13 +170 -94
13 changed files with 170 additions and 94 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@ -1,17 +1,15 @@
# TOTPFIT
### Another 2FAuthenticator based on TOTP for Zepp Amazfit GTS 4
### Another 2FAuthenticator based on TOTP for Zepp Amazfit GTS 4 with Google Authenticator migration Support
![alt text](docs/assets/image2.png)
### Features:
- Supports of otpauth links with parameters "issuer", "algorithm", "digits", "period"
- Addition/Edition/Deletion of TOTPs from mobile settings app
- Addition/Edition/Deletion of TOTPs from mobile app
- Support of google migration links formated: ```otpauth-migration://offline?data=...``` (At this stage with only 6 digits and only 30 seconds period)
### Google Migration Support:
- Support of google migration links formated: ```otpauth-migration://offline?data=...``` (BETA)
### Guides:
### Screenshots:
[How to add 2FA TOTP records (keys) on app](/docs/guides/how-to-add-totps/README.md)
![alt text](docs/assets/image2.png)
![alt text](docs/assets/image.png)
#### This repo has mirror for issues on [GitHub](https://github.com/Lisoveliy/totpfit)

2
app.json
View File

@ -6,7 +6,7 @@
"appType": "app",
"version": {
"code": 1,
"name": "1.2.2"
"name": "1.3"
},
"icon": "icon.png",
"vender": "zepp",

37
docs/guides/how-to-add-totps/README.md Normal file
View File

@ -0,0 +1,37 @@
# How to add 2FA TOTP records (keys) on app
### If you use default 2FA otpauth:// links
To add 2FA TOTP records using 2FA TOTP QR-Codes, you must scan QR-Code of service providing 2FA and scan (decode) it to a URI. If you have screenshot of QR-Code -- scan it on any app providing scan from image, ex: Search screen on Google Assistant. For example, this QR-Code will represent next URI string:
![QR Code with URI](image.png)
Copy this URI string and paste it to app using button *"Add new TOTP record"*:
![Add new TOTP record popup](image-2.png)
Then press OK, record will appear on page
![Added record](image-4.png)
You can edit your otpauth:// records using button "Change TOTP link". Your previous record will be replaced with a new otpauth:// link entered on text field, and previous link will not be shown on field.
### If you use google migrations (otpauth-migration:// links)
To add 2FA TOTP recods using migration from Google Authenticator app, you must go to menu, select "Transfer accounts" -> "Export accounts"
Select codes then screenshot QR code and and scan (decode) it to a URI. Use any app providing scan from image, ex: "Search screen" function (Google Lens) on Google Assistant.
For example, this QR-Code will represent next URI string:
![Google lens scan from Google Authenticator](image-5.png)
After scaning copy this URI string and paste it to app using button *"Add new TOTP record"*:
![Add new TOTP record using otpauth-migration](image-6.png)
Then press OK, all selected records on Google Authenticator will appear on page
![Added records from otpauth-migration](image-7.png)
You can edit your records using button "Change TOTP link". Your previous record will be replaced with a new otpauth:// link entered on text field, and previous link will not be shown on field.

BIN
docs/guides/how-to-add-totps/image-2.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 22 KiB

BIN
docs/guides/how-to-add-totps/image-4.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 17 KiB

BIN
docs/guides/how-to-add-totps/image-5.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 448 KiB

BIN
docs/guides/how-to-add-totps/image-6.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 27 KiB

BIN
docs/guides/how-to-add-totps/image-7.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 27 KiB

BIN
docs/guides/how-to-add-totps/image.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 44 KiB

6
lib/protobuf-decoder/varintUtils.js
View File

@ -1,5 +1,5 @@
export function decodeVarint(buffer, offset) {
let res = this.BigInt(0);
let res = 0;
let shift = 0;
let byte = 0;
@ -10,8 +10,8 @@ export function decodeVarint(buffer, offset) {
byte = buffer[offset++];
const multiplier = this.BigInt(2) ** this.BigInt(shift);
const thisByteValue = this.BigInt(byte & 0x7f) * multiplier;
const multiplier = 2 ** shift;
const thisByteValue = (byte & 0x7f) * multiplier;
shift += 7;
res = res + thisByteValue;
} while (byte >= 0x80);

2
package.json
View File

@ -1,6 +1,6 @@
{
"name": "totpfit",
"version": "1.2.2",
"version": "1.3",
"description": "Another 2FAuthenticator based on TOTP for Zepp Amazfit GTS 4",
"main": "app.js",
"author": "Lisoveliy",

87
setting/index.js
View File

@ -2,6 +2,16 @@ import { getTOTPByLink } from "./utils/queryParser.js";
let _props = null;
const colors = {
bg: "#101010",
linkBg: "#ffffffc0",
secondaryBg: "#282828",
text: "#fafafa",
alert: "#ad3c23",
notify: "#555555",
bigText: "#fafafa"
};
AppSettingsPage({
build(props) {
_props = props;
@ -9,9 +19,23 @@ AppSettingsPage({
props.settingsStorage.getItem("TOTPs") ?? "[]"
);
const totpEntrys = GetTOTPList(storage);
const addTOTPsHint = storage.length < 1 ?
Text({
paragraph: true,
align: "center",
style: {
paddingTop: "10px",
marginBottom: "10px",
color: colors.text,
fontSize: 16,
verticalAlign: "middle",
},
},
"For add a 2FA TOTP record you must have otpauth:// link or otpauth-migration:// link from Google Authenticator Migration QR-Code"
) : null;
const createButton = TextInput({
placeholder: "otpauth://",
label: "Add new OTP Link",
placeholder: "otpauth(-migration)://",
label: "Add new TOTP record",
onChange: (changes) => {
let link = getTOTPByLink(changes);
if (link == null) {
@ -19,29 +43,32 @@ AppSettingsPage({
return;
}
if(Array.isArray(link))
if (Array.isArray(link))
storage.push(...link);
else storage.push(link);
updateStorage(storage);
},
labelStyle: {
backgroundColor: "#14213D",
backgroundColor: colors.notify,
display: "flex",
alignItems: "center",
justifyContent: "center",
margin: "10px",
flexGrow: 1,
fontSize: "20px",
color: "#FFFFFF",
color: colors.text,
borderRadius: "5px",
position: storage.length < 1 ? "absolute" : null, //TODO: Сделать что-то с этим кошмаром
bottom: storage.length < 1 ? "0px" : null,
left: storage.length < 1 ? "0px" : null,
right: storage.length < 1 ? "0px" : null
},
});
var body = Section(
{
style: {
backgroundColor: "black",
backgroundColor: colors.bg,
minHeight: "100vh",
},
},
@ -52,22 +79,34 @@ AppSettingsPage({
textAlign: "center",
},
},
Text(
storage.length < 1 ? addTOTPsHint : Text(
{
align: "center",
paragraph: true,
style: {
marginBottom: "10px",
color: "#fff",
color: colors.bigText,
fontSize: 23,
fontWeight: "500",
verticalAlign: "middle",
},
},
"TOTPS:"
"TOTP records:"
)
),
...totpEntrys,
createButton,
View({
style: {
display: "flex",
justifyContent: "center"
}
},
Link({
source: "https://github.com/Lisoveliy/totpfit/blob/main/docs/guides/how-to-add-totps/README.md"
},
"Instruction | Report issue (GitHub)")
),
]
);
return body;
@ -80,12 +119,12 @@ function GetTOTPList(storage) {
storage.forEach((element) => {
const elementId = counter;
const textInput = TextInput({
placeholder: "otpauth://",
label: "Change OTP link",
placeholder: "otpauth(-migration)://",
label: "Change TOTP link",
onChange: (changes) => {
try {
let link = getTOTPByLink(changes);
if(Array.isArray(link))
if (Array.isArray(link))
return;
storage[elementId] = link;
@ -95,7 +134,7 @@ function GetTOTPList(storage) {
}
},
labelStyle: {
backgroundColor: "#14213D",
backgroundColor: colors.notify,
textAlign: "center",
display: "flex",
alignItems: "center",
@ -103,7 +142,7 @@ function GetTOTPList(storage) {
margin: "10px",
flexGrow: 1,
fontSize: "20px",
color: "#E5E5E5",
color: colors.text,
borderRadius: "5px",
},
});
@ -111,8 +150,9 @@ function GetTOTPList(storage) {
{
align: "center",
style: {
color: "#ffffff",
fontSize: "16px",
color: colors.text,
fontSize: "18px",
fontWeight: "500"
},
paragraph: true,
},
@ -126,29 +166,30 @@ function GetTOTPList(storage) {
updateStorage(storage);
},
style: {
backgroundColor: "#ba181b",
backgroundColor: colors.alert,
fontSize: "18px",
color: "#ffffff",
color: colors.text,
height: "fit-content",
margin: "10px",
},
label: "DEL",
label: "Delete",
});
const text = Text(
{
style: {
color: "#ffffff",
color: colors.text,
fontSize: "14px",
},
align: "center",
},
`${element.hashType} | ${element.digits} digits | ${element.fetchTime} seconds | offset ${element.timeOffset} seconds`
`${element.hashType} | ${element.digits} digits | ${element.fetchTime} seconds | ${element.timeOffset} sec offset`
);
const view = View(
{
style: {
textAlign: "center",
border: "2px solid white",
backgroundColor: colors.secondaryBg,
//border: "2px solid white",
borderRadius: "5px",
margin: "10px",
},

20
setting/utils/queryParser.js
View File

@ -6,9 +6,9 @@ const otpauthScheme = "otpauth:/";
const googleMigrationScheme = "otpauth-migration:/";
export function getTOTPByLink(link) {
if(link.includes(otpauthScheme))
if (link.includes(otpauthScheme))
return getByOtpauthScheme(link)
if(link.includes(googleMigrationScheme))
if (link.includes(googleMigrationScheme))
return getByGoogleMigrationScheme(link)
return null;
@ -21,7 +21,7 @@ function getHashType(algorithm) {
else return "SHA-1";
}
function getByOtpauthScheme(link){
function getByOtpauthScheme(link) {
try {
let args = link.split("/", otpauthScheme.length);
let type = args[2]; //Returns 'hotp' or 'totp'
@ -31,7 +31,7 @@ function getByOtpauthScheme(link){
args[3].split(":")[0]?.split("?")[0]; //Returns client
let secret = args[3].split("secret=")[1]?.split("&")[0]; //Returns secret
let period = args[3].split("period=")[1]?.split("&")[0]; //Returns period
let digits = args[3].split("digits=")[1]?.split("&")[0]; //Returns digits
let digits = args[3].split("digit=")[1]?.split("&")[0]; //Returns digits
let algorithm = args[3].split("algorithm=")[1]?.split("&")[0]; //Returns algorithm
let offset = args[3].split("offset=")[1]?.split("&")[0] ?? 0; //Returns offset
@ -40,7 +40,7 @@ function getByOtpauthScheme(link){
if (secret === undefined) throw new Error("Secret not defined");
if(issuer == client){
if (issuer == client) {
issuer = args[3].split("issuer=")[1]?.split("&")[0];
}
@ -51,8 +51,8 @@ function getByOtpauthScheme(link){
secret,
issuer,
client,
digits,
period,
Number(digits),
Number(period),
Number(offset),
getHashType(algorithm)
);
@ -62,7 +62,7 @@ function getByOtpauthScheme(link){
}
}
function getByGoogleMigrationScheme(link){
function getByGoogleMigrationScheme(link) {
let data = link.split("data=")[1]; //Returns base64 encoded data
data = decodeURIComponent(data);
@ -72,7 +72,7 @@ function getByGoogleMigrationScheme(link){
let protoTotps = [];
proto.parts.forEach(part => {
if(part.type == TYPES.LENDELIM){
if (part.type == TYPES.LENDELIM) {
protoTotps.push(decodeProto(part.value));
}
});
@ -80,7 +80,7 @@ function getByGoogleMigrationScheme(link){
let totps = [];
protoTotps.forEach(x => {
let type = x.parts.filter(x => x.index == 6)[0]; //find type of OTP
if(type.value !== '2'){
if (type.value !== '2') {
console.log("ERR: it's a not TOTP record")
return;
}