otpauth migration decoder

Convert Google Authenticator data to plain otpauth links

usage

1. get QR code in "Google Authenticator" app (Menu → Transfer accounts → Export accounts → Select accounts → Next)
2. extract link from QR code with your preferred QR codes reading software
3. pass migration link (otpauth-migration://offline?data=...) to this tool

example

$ python decoder.py decode --migration "otpauth-migration://offline?data=CjEKCkhlbGxvId6tvu8SGEV4YW1wbGU6YWxpY2VAZ29vZ2xlLmNvbRoHRXhhbXBsZTAC"

setup from scratch

You need to have some prerequisites installed on system, such as: python, direnv, poetry.

clone project

$ git clone https://github.com/digitalduke/otpauth-migration-decoder.git
$ cd otpauth-migration-decoder

create virtual environment

$ cp .envrc.example
$ direnv allow

activate environment, for example: source .direnv/python-3.11.2/bin/activate.fish and install project requirements

$ poetry install

run tests & checks

$ tox

references

1. otpauth:// URI format
2. Protocol Buffer Basics: Python
3. Authenticator live demo