Aegis-decrypt

A backup decryptor and OTP generator for the vault of the Aegis Authenticator Android app, inspired by asmw/andOTP-decrypt. It allows to decrypt the Aegis vault and export its values in different formats (stdout, CSV, QRCode, Json). It allows to generate TOTP codes on the fly.

:warning: Currently, it supports only TOTP tokens. :warning: A few improvements are in progress:

• export QRCodes in a unique PDF or HTML (simple paper backup)
• support for HOTP format

Usage

python3 aegis-decrypt.py [-h] --vault VAULT [--entryname ENTRYNAME] [--issuer ISSUER] [--output {None,csv,qrcode,json,otp}] [--password PASSWORD]

Exports are created in the folder ./export/ inside the project itself

Development Setup

Pipenv install (recommended)

• Install Pipenv
  • pip install --user pipenv (or use the recommended way from the website)
• Install everything else
  • pipenv install
• Launch the virtualenv
  • pipenv shell
• Update dependencies
  • pipenv update
• Generate requirements.txt output from lock file:
  • pipenv requirements > requirements.txt

Pip install

• pip3 install --user -r requirements.txt

Project Management

Since this repo is spread across several remotes, it may happen that there are some pull/merge request need to be handled locally.

• Add the remote repository URL with a meaningful NAME: git remote add NAME URL
• Create a local BRANCH name from the GitHub pull request ID: git fetch origin pull/$ID/head:$BRANCHNAME

Contributors

• asmw: original andOTP-decrypt repository on GitHub
• scollovati: forked andOTP-decrypt and setup the Aegis-decrypt project
• kvngvikram
• combolek