YoAuth is a local, pure terminal command line TOTP generator, used for 2FA verification of accounts such as github, google or microsoft
You can directly download the corresponding package from Release of this project, depressed and use it directly
Users can also compile from the source code without download package. There are many options to choose
- Directly use the script compilation in the project
- Use the C package management system to download dependencies and compile
For the sake of simplicity, users who are not familiar with C package management can also easily to compile, here only introduces the way of directly using build script in project
Gurantee Cmake and git already installed
This step is optional. By Default, YoAuth will download and compile openssl, the advantage of this is that it can generate a portable package, it can be directly copied and used on the same system; the disadvantage is that the compilation step will take more time.
User also can choose to use system package management to install openssl
-
close openssl build
Modifybuild.shin the project root directory, findbuild_openssl=1and change it tobuild_openssl=0 -
ubuntu
sudo apt install openssl libssl-dev
- arch linux
sudo pacman -S openssl
Run build.sh in the root directory of the project, after running, dist/yoauth*.tar.gz will be generated in the root directory
For the first use, run the yoauth command directly, you will be prompted to enter the password twice, and an encrypted file storing the TOTP key will be generated locally. When no other options are entered, the default folder name will be used. Because all content of YoAuth is stored locally, please be sure to remember the password you entered, once lost, it will not be retrieved
For example, the 2FA verification of github needs to be added currently, assuming the key is: NBSWY3DPO5XXE3DE
yoauth add -a github -k NBSWY3DPO5XXE3DE
For example, currently you need to delete the account key of github
yoauth delete -a github
All verification codes need to be listed, just run yoauth directly
When you need to filter accounts, you can use the list command. For example, you currently want to filter out the verification codes that contain the google string in the account.
yoauth list -f google
When you need to back up/migrate keys, there are two methods:
By default, the file storing the key is in the data folder of the user's decompressed directory, and the user can directly copy it to other places for backup
Users can also export all keys into plaintext for migration
yoauth dump -o ./backup.txt