Initial commit

README.md

@@ -0,0 +1,33 @@
+# 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
+pipenv run python decrypt_otpauth.py --encrypted-otpauth-backup <path to your OTP Auth backup>
+```
+
+## 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`.
+
+## Credits
+
+Inspired by [ewdurbin](https://github.com/ewdurbin) and his [evacuate_2STP](https://github.com/ewdurbin/evacuate_2stp) repo.