https://github.com/sammy-t/avdu
A utility to view one-time passwords generated from Aegis Authenticator backups.
https://github.com/sammy-t/avdu
2fa auth authentication otp totp
Last synced: about 1 year ago
JSON representation
A utility to view one-time passwords generated from Aegis Authenticator backups.
- Host: GitHub
- URL: https://github.com/sammy-t/avdu
- Owner: Sammy-T
- License: gpl-3.0
- Created: 2024-07-10T08:46:30.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-11T12:14:31.000Z (almost 2 years ago)
- Last Synced: 2024-09-11T18:19:27.500Z (almost 2 years ago)
- Topics: 2fa, auth, authentication, otp, totp
- Language: Go
- Homepage: https://pkg.go.dev/github.com/sammy-t/avdu
- Size: 72.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# avdu
Aegis Vault Desktop Utility is a Go module and basic command line interface for generating
one-time passwords from an [Aegis Authenticator](https://github.com/beemdevelopment/Aegis) vault backup or export file.
The desktop app version can be found at .
> [!NOTE]
> HOTP is not implemented due to syncing concerns.
## CLI
```bash
avdu -h
```
## Import the module
Import into go file(s)
```go
import "github.com/sammy-t/avdu"
```
Update modules
```bash
go mod tidy
```
## Development
### Run the CLI
```bash
# Run in the current directory.
go run ./cmd/avdu
# Run using the plaintext test file.
go run ./cmd/avdu -p test/data/aegis_plain.json
# Run using the encrypted test file. (Enter password "test" when prompted.)
go run ./cmd/avdu -p test/data/aegis_encrypted.json -e
```
### Build the CLI
```bash
go build -C ./cmd/avdu
```
The binary will output to the `cmd/avdu/` directory.
### Install the CLI
```bash
go install ./cmd/avdu
```