Skip to content

Latest commit

 

History

History
49 lines (35 loc) · 1.37 KB

README.md

File metadata and controls

49 lines (35 loc) · 1.37 KB

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