Skip to content

Latest commit

 

History

History
45 lines (36 loc) · 2.15 KB

README.md

File metadata and controls

45 lines (36 loc) · 2.15 KB

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.

⚠️ Currently, it supports only TOTP tokens. ⚠️ 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