Files
decrypt-otpauth-files/README.md
2017-12-24 08:53:47 -05:00

39 lines
1.2 KiB
Markdown

# decrypt-otpauth-files
This tool allows for decrypting the encrypted backups/account files created by [OTP Auth for iOS](http://cooperrs.de/otpauth.html).
If you find problems with the file format (in particular security related issues), do not hesitate and file an issue.
## Usage
Requires:
- [Python 3.6](https://www.python.org/downloads/)
- [pipenv](https://docs.pipenv.org)
- An encrypted OTP Auth backup/account file
```
git clone https://github.com/CooperRS/decrypt-otpauth-files.git
cd decrypt-otpauth-files
pipenv install
# Decrypt a full backup file
pipenv run python decrypt_otpauth.py decrypt_backup --encrypted-otpauth-backup <path to your OTP Auth backup>
# Decrypt a single account export
pipenv run python decrypt_otpauth.py decrypt_account --encrypted-otpauth-account <path to your OTP Auth account>
```
## Demo
The project contains two OTP Auth exports for demo purposes:
* `backup.otpauthdb`: A complete OTP Auth backup
* `account.otpauth`: One account exported by OTP Auth
The password for both files is `abc123`.
![example gif](demo.gif)
## Credits
Inspired by [ewdurbin](https://github.com/ewdurbin) and his [evacuate_2STP](https://github.com/ewdurbin/evacuate_2stp) repo.