https://github.com/bitsfdb/termiauth
Terminal Based Authenticator
https://github.com/bitsfdb/termiauth
Last synced: 15 days ago
JSON representation
Terminal Based Authenticator
- Host: GitHub
- URL: https://github.com/bitsfdb/termiauth
- Owner: bitsfdb
- Created: 2025-07-01T20:43:41.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-08-12T14:14:53.000Z (10 months ago)
- Last Synced: 2026-02-02T02:35:25.927Z (4 months ago)
- Language: JavaScript
- Size: 44.9 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
---
# termiauth
terminal-based authenticator
i got tired of those clunky authenticator apps, so i made my own in javascript (because why the heck not).
just clone this repo and get started:
```bash
git clone https://github.com/sponge104/termiauth.git
cd termiauth
npm install -g .
```
install dependencies:
```bash
npm install
```
run the app:
```bash
termiauth
```
to import your codes from a txt json(not fully supported) please move your file to the termiauth/ directory .txt formats are
```bash
otpauth://totp/GitHub:Example?algorithm=SHA1&digits=6&issuer=GitHub&period=30&secret=SecretHere&icon=SVG%2FGithub.svg
```
---
you can import exports from oneauth (haven’t tested others much yet). ping me on github if you want me to support more.
i kinda forgot this you can make this globally by using this setup
after installing go to package.json it should look something like this
add a bin field after main like this
```json
"bin":{
"termiauth": "./termiauth.mjs"
},
```
now it should look like this
now you can run termiauth anywhere in your pc by just typing this in any terminal
```bash
termiauth
```
no stupid tracking — just a minimal terminal authenticator app :)
---
## version history
* **v1.0** — the base app with passphrase protection
* **v1.1** — added security question recovery for forgotten passphrases
* **v1.2** — added hashed and salted storage so even if someone gets on your machine, your secrets stay safer \:D
---
*feel free to open issues or pull requests on github if you want to chat or request features!*