decrypt-otpauth-files

This tool allows for decrypting the encrypted backups/account files created by OTP Auth for iOS.

If you find problems with the file format (in particular security related issues), do not hesitate and file an issue.

This is a fork of the original repository at CooperRS/decrypt-otpauth-files with a aim to get the script working out of the box with modern Python versions.

Requirements

• Python 3.12
• uv
• An encrypted OTP Auth backup/account file

Usage

1. Clone repository

git clone https://github.com/CooperRS/decrypt-otpauth-files.git
cd decrypt-otpauth-files

2. Install dependencies

$ uv sync

3. Decrypt your OTP Auth file

# Decrypt a full backup file
$ uv run python decrypt_otpauth.py decrypt_backup --encrypted-otpauth-backup <path to your OTP Auth backup>

# Decrypt a single account export
$ uv 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.

Credits

Inspired by ewdurbin and his evacuate_2STP repo.