twofat

README

twofat

Manage TOTP data from CLI

• v0.6.5
• Repo: github.com/pepa65/twofat
• After: github.com/slandx/tfat
• Contact: pepa65 pepa65@passchier.net
• Install: wget -qO- gobinaries.com/pepa65/twofat |sh

Features

• Data saved with AES-GCM encrypt in ~/.twofat.enc, password changeable.
• Display codes of names matching regex, which auto-refresh.
• Add, rename, delete entry, reveal secret, copy code to clipboard.
• Import entries from CSV.
• Displays well in 80-colums (or more) terminals. Maximum NAME length is set to 17.

Build

# While in the repo root directory:
go build

# Or anywhere:
go get -u github.com/pepa65/twofat

# Smaller binary:
go build -ldflags="-s -w"

# More extreme shrinking:
upx --brute twofat*

# Build for various architectures:
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o twofat
CGO_ENABLED=0 GOOS=linux GOARCH=arm go build -ldflags="-s -w" -o twofat_pi
CGO_ENABLED=0 GOOS=freebsd GOARCH=amd64 go build -ldflags="-s -w" -o twofat_bsd
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -ldflags="-s -w" -o twofat_osx
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o twofat.exe

Usage

twofat v0.6.5 - Manage TOTP data from CLI
* Repo:       github.com/pepa65/twofat <pepa65@passchier.net>
* Data file:  ~/.twofat.enc  (depends on binary file name)
* Usage:      twofat [COMMAND]
  COMMAND:
[ show | view ]  [REGEX]
    Show all Codes [with Names matching REGEX] (the command is optional).
list | ls  [REGEX]
    Show all Names [with Names matching REGEX].
add | insert | entry  NAME  [-7|-8]  [-f|--force]  [SECRET]
    Add a new entry NAME with SECRET (queried when not given).
    When -7 or -8 are given, Code length is 7 or 8, otherwise it is 6.
    If -f/--force: existing NAME overwritten, no NAME length check.
totp | temp  [-7|-8]  [SECRET]
    Show the Code for SECRET (queried when not given).
    When -7 or -8 are given, Code length is 7 or 8, otherwise it is 6.
    (The data file is not queried nor written to.)
delete | remove | rm  NAME  [-f|--force]
    Delete entry NAME. If -f/--force: no confirmation asked.
rename | move | mv  NAME  NEWNAME  [-f|--force]
    Rename entry NAME to NEWNAME, if -f/--force: no length checks.
import  FILE  [-f|--force]
    Import lines with "NAME,SECRET,CODELENGTH" from CSV-file FILE.
    If -f/--force: existing NAME overwritten, no NAME length check.
export  FILE                Export all entries to CSV-file FILE.
reveal | secret  NAME       Show Secret of entry NAME.
clip | copy | cp  NAME      Put Code of entry NAME onto the clipboard.
password | passwd | pw      Change data file encryption password.
version | --version | -V    Show version.
help | --help | -h          Show this help text.