#totp #argon2 #cotp #authenticator #google-authenticator

app cotp

Trustworthy encrypted command line authenticator app compatible with multiple backups

7 releases

0.1.7 Feb 21, 2021
0.1.6 Feb 8, 2021
0.1.5 Jan 10, 2021

#10 in Authentication

Download history 33/week @ 2021-01-02 52/week @ 2021-01-09 9/week @ 2021-01-16 8/week @ 2021-01-23 1/week @ 2021-01-30 31/week @ 2021-02-06 51/week @ 2021-02-13 17/week @ 2021-02-20

61 downloads per month

Custom license


cotp - command line totp authenticator

Actions Status AUR package crates.io Downloads

I believe that security is of paramount importance, especially in this digital world. I created cotp because I needed a minimalist, secure, desktop accessible software to manage my two-factor authentication codes.



cotp is written with simplicity in mind, the interface is quite minimalist and intuitive as command line apps should be.

GIF demo


This program relies on only one database file, encrypted with XChaCha20Poly1305 authenticated encryption and Argon2id for key derivation.


You can import backups (or converted databases) from:

Backup compatibility is growing (check planned features). By typing cotp -ex you can export your database in unencrypted json format.


cotp can generate two-factor authentication coded using HMAC-SHA1, HMAC-SHA256 and HMAC-SHA512, with any digits, to provide a good compatibility to most two-factor authentication systems.

Cross Plaform

Thanks to the glorious Rust Language cotp is easily compilable in every platform supported by rust itself.

So far, I have successfully tested the functionality of the software in the following systems:

  • Arch Linux
  • Alpine Linux 3.12.3
  • Fedora 33
  • Ubuntu 20.04 WSL
  • Windows 10 Pro x64 20H2 Build 19042.746
  • Windows 10 LTSC x64 1809 Build 17763.1637

In addition, cotp has been successfully tested by the community in the following systems:

  • Android (Termux)
  • NixOS


Arch Linux and arch-based distributions

You can install cotp through the Arch User Repository. Before beginning check you already have the required packages:

pacman -S git base-devel

Then choose how you want to proceed:

  • Using an AUR Helper like yay: yay -S cotp

  • Or paru: paru -S cotp

  • Manually cloning AUR repo and make the pkg

     git clone https://aur.archlinux.org/cotp.git
     cd cotp
     makepkg -si

Other distributions, *nix or Windows

Before beginning check that you have the required dependencies to build cotp by yourself:

⚠️Attention The x86_64-pc-windows-gnu rust toolchain is untested and may not compile! Use MSVC instead.

Using crates.io repository

It's possible to install cotp directly through cargo, as it's listed in the crates.io repository.

Just type cargo install cotp and wait for the installation.

Clone the Github repository and manually install

You can build cotp using these commands:

git clone https://github.com/replydev/cotp.git #or https://codeberg.org/replydev/cotp.git
cargo install --path cotp/

How to use

If you are familiar with the command line interface using cotp will not be a problem. Please note that cotp requires at least an 8 chars length password. If you type cotp -h you get some instruction on how to use cotp utilities. For example, the version 0.1.5 prints out this help screen:

cotp v0.1.5
written by @replydev


  -a,--add [ISSUER] [LABEL] [ALGORITHM] [DIGITS]       | Add a new OTP code
  -e,--edit [ID] [ISSUER] [LABEL] [ALGORITHM] [DIGITS] | Edit an OTP code
  -r,--remove [ID]                                     | Remove an OTP code
  -i,--import [APPNAME] [PATH]                         | Import a backup from a given application
  -ex,--export                                         | Export the entire database in a plaintext json format
  -j,--json                                            | Print results in json format
  -s,--single                                          | Print OTP codes in single mode
  -in,--info [ID]                                      | Print info of choosen OTP code
  -h,--help                                            | Print this help

Note that in the --edit command if you type . instead of argument you are specifying not to modify that specific argument.



index issuer label algorithm digits
3 Email_Provider mymail@example.com SHA1 6


cotp -e 3 . myothermail@example.com . 8


index issuer label algorithm digits
3 Email_Provider mymailother@example.com SHA1 8

Database conversion

To import Authy or Google Authenticator databases you need first of all to obtain the respective files in your phone in the paths:

  • Authy: /data/data/com.authy.authy/shared_prefs/com.authy.storage.tokens.authenticator.xml
  • Google Authenticator: /data/data/com.google.android.apps.authenticator2/databases/databases

After that run the correct python script located in the converters/ folder in this source code:

python authy.py path/to/database.xml converted.json

It will convert the database in a json format readable by cotp.

To finish import the database: cotp -i authy path/to/database.json

Planned features

  • Reduce binary size and improve compilation speed by removing useless dependencies.
  • Use Argon2id for key derivation
  • CLI Dashboard
  • Support for:
    • SHA256
    • SHA512
    • Custom digit value
  • Backup compatibility with:
    • Aegis
    • andOTP
    • Authy
    • Google Authenticator
    • FreeOTP
  • Graphical User Interface


I created this project for my own needs, but I would be happy if this little program is useful to someone else, and I gratefully accept any contributions.


~307K SLoC