Skip to content

Commit 48e20ce

Browse files
Create README.md
1 parent 43b615f commit 48e20ce

1 file changed

Lines changed: 33 additions & 0 deletions

File tree

README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# TFACGUI
2+
## Web-based variant
3+
4+
TFAC GUI is a 2FA (Two-Factor Authentication) token generator GUI.
5+
6+
It currently supports the following setups:
7+
8+
* TOTP
9+
* Hashing algorithm
10+
* SHA-1 (default)
11+
* SHA-256
12+
* SHA-512
13+
* Token generation interval
14+
* `30` seconds (default)
15+
* Any amount of seconds between `1` and `60`
16+
* Token length
17+
* `6` digits
18+
* Any amount of digits between `1` and `10`
19+
* Custom labelling of TOTP config entries (can be changed retro-actively)
20+
* Import / export of (encrypted) backups of the 2FA key chain
21+
22+
30 seconds with SHA-1 is the de-facto standard for most implementations of 2FA ([Google Auth even ignores most of the parameters when set differently](https://github.com/google/google-authenticator/wiki/Key-Uri-Format#algorithm))
23+
24+
It's a spiritual successor to [TFAC GUI](https://github.com/GlitchedPolygons/TFACGUI), which is essentially the same thing that I wrote in C some time ago, but way, waaay more lightweight and much less portable.
25+
This here only carries its name as a legacy, because it no longer uses the previously utilized C-library [TFAC](https://github.com/GlitchedPolygons/TFAC) that was powering the native [TFAC GUI](https://github.com/GlitchedPolygons/TFACGUI).
26+
27+
This 2FA GUI is written using Blazor WebAssembly and functions 100% statically, zero-knowledge and client-side only.
28+
29+
It has a [`.webmanifest`](https://github.com/GlitchedPolygons/TFACGUI.BlazorWebApp/blob/master/TFACGUI.BlazorWebApp/wwwroot/tfacgui.webmanifest) file that makes it [installable as a PWA](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Installing) on smartphones and computers.
30+
31+
User data is stored in [`localStorage`](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage) but can be purged with a button click, and is only every exported out of the app's context via the export functionality, which requires you to encrypt the exported data with a password.
32+
33+
Hope you enjoy, cheers :D

0 commit comments

Comments
 (0)