Skip to content

Tool to migrate from Google Authenticator to any other 2FA generator

License

Notifications You must be signed in to change notification settings

bkeiren/GAuthExport

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 

Repository files navigation

GAuthExport

Tool to migrate accounts from Google Authenticator to any other 2FA generator, without removing and re-registering 2FA!

This tool parses the QR code(s) that the "Export Accounts" feature of the Google Authenticator app generates, extracts relevant data, and then generates a new QR code for each extracted account. The generated QR code can be scanned with any 2FA generator app to import that account. All this without having to remove and re-add 2FA through the account's management portal!

Usage

The tool supports ingesting either images containing the QR code generated by Google Authenticator, or the text contents of those QR images. Either inputs are controlled with command line arguments:

Argument Effect Example
--image [PATH] Parse an image containing a QR code generated by Google Authenticator. Can have multiple values. --image input1.png input2.png
--text [TEXT] Ingest the raw text content of a QR code generated by Google Authenticator. Can have multiple values. --text otpauth-migration:\\...
--output_directory [PATH] Controls the output directory in which generated QR codes for extracted accounts are saved. Single value. Optional. By default the output is saved in the current directory of the Python file --output_directory .\my_outputs

Example

  • Step 1: Generate account export QR code in Google Authenticator

Photo of a phone screen with Google Authenticator showing a QR code for the account export feature

For this example, we'll call this image input.png.

  • Step 2: Run the tool

python gauthexport.py --image input.png --output_directory .\output

  • Step 3: Scan the output with your new 2FA generator

Example of QR code generated by app

This image contains the following content: otpauth://totp/username@mail.com?secret=DJVUENBVOAWEIVKAWE&issuer=serviceprovider

and would have been saved to output path: .\output\GAuthExport_username@mail.com_DJVUENBVOAWEIVKAWE_serviceprovider.png

About

Tool to migrate from Google Authenticator to any other 2FA generator

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages