Skip to content

yelsaw/gotp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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
image image image

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 main.go "otpauth://totp/Microsoft:you@youremail.com?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 main.go ~/my-otp-file-path.txt

Returns:

 you@youremail.com → Microsoft

 Token: 423157

 Regenerates in 30 seconds

 Press q to quit

Build tool

Build binaries from source for target OS with

  • make build
  • make linux
  • make darwin
  • make windows
:~/src/gotp$ make

  Command         Description
  -------         -----------
  build           Builds all binaries to BUILD_DIR/{linux,darwin,windows}
  dist            Builds all binaries, archives with LIC_FILE, and creates sha256sum
  linux           Builds binary and outputs to BUILD_DIR/linux
  darwin          Builds binary and outputs to BUILD_DIR/darwin
  windows         Builds binary and outputs to BUILD_DIR/windows
  archive         Create archives for distribution
  checksum        Create sha256sum(s) for distribution
  clean           Remove BUILD_DIR

AUTHOR

Yelsaw (gotp@yelsaw.com)

License

This project is licensed under the MIT license - see the LICENSE file for details.