/ free utility · open source

Google Auth Extractor

Exporta tus cuentas TOTP de Google Authenticator a TXT, Aegis, 2FAS o CSV.

Export your Google Authenticator TOTP accounts to TXT, Aegis, 2FAS or CSV.

Python 3.10+ Windows macOS Linux MIT
/ why

Why does this tool exist?

Google Authenticator exporta las cuentas en un formato propietario (otpauth-migration://) que ninguna otra app puede leer directamente. Cada código QR contiene hasta 10 cuentas. Esta herramienta decodifica esos QR y extrae las claves TOTP para que puedas importarlas donde quieras.

Google Authenticator exports accounts in a proprietary format (otpauth-migration://) that no other app can read directly. Each QR code holds up to 10 accounts. This tool decodes those QR codes and extracts the TOTP secrets so you can import them anywhere.

/ features

Everything it includes.

Paste otpauth-migration:// URL directly
Upload an image or screenshot of the QR
Scan a screen region with your mouse
Accumulates accounts across scans
Automatic deduplication
Copy Issuer, Name or Secret
Spanish and English interface
Clear the list to start fresh
Export to TXT, Aegis, 2FAS, CSV
100% local — no data leaves your computer
/ screenshots

The tool in action.

The tool in action. The tool in action. The tool in action. The tool in action. The tool in action.
/ installation

Installation.

1. Clone the repository
git clone https://github.com/joseqwrtt/Google_auth_extractor.git
cd Google_auth_extractor

📌 Requirements: Python 3.10 or higher. During installation on Windows, check "Add Python to PATH".

2. Install dependencies
pip install customtkinter pillow pyzbar opencv-python mss

🐧 Linux / macOS: You also need the native zbar library:

# Ubuntu / Debian
sudo apt install libzbar0

# macOS
brew install zbar
/ usage

How to run it.

Run
python Google_auth_extractor.py

💡 Windows with multiple Python versions:

C:\Python311\python.exe Google_auth_extractor.py

Or create a run.bat file:

python "%~dp0Google_auth_extractor.py"
pause
/ guide

Step by step.

01

Export from Google Authenticator

Open Google Authenticator → menu (⋮) → Transfer accounts → Export accounts → select the accounts → one or more QR codes will appear (max 10 accounts per QR).

02

Import into the app (pick a mode)

🔗 URL mode

Scan the QR → copy the otpauth-migration://offline?data=... URL → paste it → Extract accounts

🖼️ Image mode

Screenshot of the QR → Select image → Read QR and extract

📷 Screen scan mode

Show the QR → Select region → draw a rectangle → automatic extraction

💡 If you have more than 10 accounts, repeat the process for each QR. Accounts accumulate and duplicates are ignored.

03

Export

Once all your accounts are in the list, click the button for the format you need:

TXT · .txt Aegis · .json · Android 2FAS · .2fas · Android/iOS CSV · Bitwarden, 1Password
/ dependencies

What it uses under the hood.

customtkinter — graphical interface pillow — image reading pyzbar — QR decoding (primary) opencv-python — QR decoding (fallback) mss — multi-monitor capture
/ help

Troubleshooting.

The screen scanner doesn't work

pip install pillow pyzbar opencv-python mss
sudo apt install libzbar0   # Ubuntu
brew install zbar           # macOS

Multiple Python versions on Windows

C:\Python311\python.exe -m pip install customtkinter pillow pyzbar opencv-python mss

Error importing pyzbar on Windows

pyzbar requires native libraries. If it fails, opencv-python is used as an automatic fallback.

/ security

No internet connection.

No network connections
TOTP secrets stay on your computer
Full source code available for audit

MIT license.

Use it, modify it and distribute it freely.

View repository →