Auntnee

TODO:

• support encrypted json (Aegis compatible)
• appimage release
• design an ui

About

This program is an TOTP Authenticator for terminal, initialy the json with all 2FA codes is generated from an apk called Aegis Authenticator, so this program reads the json file generated with the apk and show you 2FA code from the console. Now support creation of empty template and is not demanding the Aegis json.

Support

• creating empty template
• using existing json from Aegis unencrypted
• add new issuer to the json
• delete provided issuer from the json
• change path of json built-in

Instalation

Just run the following command

python3 -m pip install auntnee

Usage

First start

When you first run auntnee it creates a file in $HOME/.auntnee.conf and ask you to specify where are the json file you wana use, if you provide an non-existent file, it will create an empty template ready for add new entries to the json. If you provide an Aegis json, it will use that existen json and let you use it.

 $> python3 -m auntnee
Failed to solve json file
Please enter the route to json file unencrypted: /tmp/mynewfile.json

 $>

After that first run, when you run the command again without any arguments, it will read that json file and start receiving user input

 $> python3 -m auntnee
   ┌─<SEARCH>───────────────────┐
   │                            │
   └────────────────────────────┘

   ┌──<Result>──────────────────┐
   │                            │
   │                            │
   │                            │
   │                            │
   │                            │
   │                            │
   │                            │
   └────────────────────────────┘

Add new issuer

Of curse, right now if you create an empty json template, there is no entries, lets create one.

 $> python3 -m auntnee -a mywebpage.com my_username MY_SITE_KEY_TOTP

 $>

And then lets look for it again.

   ┌─<SEARCH>───────────────────┐
   │myw                         │
   └────────────────────────────┘

   ┌──<Result>──────────────────┐
   │mywebpage.com 798835        │
   │                            │
   │                            │
   │                            │
   │                            │
   │                            │
   │                            │
   └────────────────────────────┘

As you type in the keyboard, the Result list will update automatically.

Delete an issuer

If you want to delete an entry just provide the issuer(or website name like mywebpage.com)

 $> python3 -m auntnee -d mywebpage.com
  1 entries removed
 $>

And then...

   ┌─<SEARCH>───────────────────┐
   │myw                         │
   └────────────────────────────┘

   ┌──<Result>──────────────────┐
   │                            │
   │                            │
   │                            │
   │                            │
   │                            │
   │                            │
   │                            │
   └────────────────────────────┘

The issuer has been removed.

Help

Usage:
 -h | --help	Print this help
 -a | --add	Add a new secrect to de db
 -c | --change	change path of db file
 -d | --del	Delete an entry by issuer (Example: test.com)

Example:
python3 -m auntnee -a mywebpage.com username KEY_TOTP
python3 -m auntnee -c '/path/to/file'
python3 -m auntnee -d mywebpage.com