https://github.com/ranjbar-dev/goauth
terminal based totp authenticator
https://github.com/ranjbar-dev/goauth
Last synced: 12 days ago
JSON representation
terminal based totp authenticator
- Host: GitHub
- URL: https://github.com/ranjbar-dev/goauth
- Owner: ranjbar-dev
- Created: 2025-10-01T10:11:52.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-10-01T10:13:58.000Z (10 months ago)
- Last Synced: 2025-10-10T02:47:54.963Z (10 months ago)
- Language: Go
- Size: 34.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GoAuth - TOTP Authenticator CLI
A beautiful command-line TOTP (Time-based One-Time Password) authenticator written in Go.
## Features
- 📱 Generate TOTP codes from YAML config
- 🎨 Colorful table display
- ⏱️ Auto-refresh every second
- ⏳ Shows remaining time for each code
- 🔒 30-second TOTP period
## Installation
```bash
go mod download
go build .
```
## Configuration
Edit `config.yml` to add your accounts:
```yaml
accounts:
- id: 1
name: GitHub
username: username
site: site.com
secret: JBSWY3DPEHPK3PXP
```
**Note:** Replace the example secrets with your actual TOTP secrets (base32 encoded).
## Usage
Run the application:
```bash
./goauth
```
Or specify a custom config file:
```bash
./goauth myconfig.yml
```
## Display
The app shows a beautiful table with:
- **ID**: Account ID
- **Name**: Account name
- **Username**: Account username
- **Site**: Website/service
- **Code**: 6-digit TOTP code (formatted as XXX XXX)
- **Time**: Remaining seconds (color-coded: red ≤5s, yellow ≤10s, default >10s)
Press `Ctrl+C` to exit.
## Dependencies
- `github.com/pquerna/otp` - TOTP generation
- `github.com/fatih/color` - Colored terminal output
- `gopkg.in/yaml.v3` - YAML configuration parsing
## screenshots
