README
¶
One-Time Password (OTP) App
Why another OTP app?
Authy (by Twillio) stopped supporting their desktop application in mid-2024. Upon launch of the app the message "Device Removed" was received and there's no way to reconnect due to the message "The device does not meet the minimum integrity requirements," thus began the GOTP project for simple desktop use.
Authy Desktop Death Rattle
| EOL | Device Removed | Min requirements |
|---|---|---|
What to expect?
This is a no frills OTP application which only supports TOTP. In the future this project may become more end-user friendly, but for now it's bare-bones and has no support or docs other than whatever is provided herein, which right now isn't much :)
Limitations
As mentioned, only supports Time-based one-time password not HMAC-based one-time password
Getting started
Navigate to the Releases Page and download the code, or use a pre-compiled binary for your OS.
- Linux (Tested on Debian)
- Darwin (Tested on Intel and M-series)
- Windows (Tested on W11)
OR
Clone the repo, build or run the app.
OTP code from URL otpauth provided is an example of a parsed QRCode from a service.
go run app/gotp.go "otpauth://totp/Microsoft:[email protected]?algorithm=SHA1&digits=6&issuer=Microsoft&period=30&secret=VXYU6YKSNBZELU23"
OR
Use OTP code from file path. Make sure your file has a string similar to URL example.
go run app/gotp.go ~/my-otp-file-path.txt
Returns:
[email protected] → Microsoft
Token: 423157
Regenerates in 30 seconds
Press q to quit
Build tools
Build binaries from source from app/ for target OS with
make buildmake linuxmake darwinmake windows
:~/src/gotp/app$ make
Command Description
------- -----------
build Build to BUILD_DIR/{linux,darwin,windows}
dist Build bins, create archives, and checksums
linux Build bin to BUILD_DIR/linux
darwin Build bin to BUILD_DIR/darwin
windows Build bin to BUILD_DIR/windows
archive Create archives for distribution
checksum Create checksum for distribution
verify Verify checksums
clean Remove DIST_DIR BUILD_DIR
AUTHOR
Yelsaw ([email protected])
License
This project is licensed under the MIT license - see the LICENSE file for details.
Documentation
Source Files