/freeotp-export

Parse a FreeOTP xml file for import elsewhere

Primary LanguagePythonEuropean Union Public License 1.2EUPL-1.2

FreeOTP-Export

PyPi Version

Rescue your OTP tokens from FreeOTP

Installing

You can install directly through pip: pip install freeotp-export

Alternatively, to install from source, clone the repo or download and unpack a tarball, then...

  • If you already have poetry installed, you can just run: 
    $ poetry run freeotp-export tokens.xml
  • Otherwise, use pip: pip install --upgrade .
  • If you must, running __main__.py may work if you have the dependencies installed.

Usage

Acquire the File

If your phone is rooted, you can just grab the file from /data/data/org.fedorahosted.freeotp/shared_prefs/tokens.xml

Otherwise, start by enabling debugging on the phone and setting up the android platform tools. Grab a backup off the app data by running adb backup org.fedorahosted.freeotp, and when asked for a password, don't enter one.

To read the resulting Android backup file, backup.ab, you can either use android-backup-extractor:

$ abe unpack backup.ab - | tar xv --strip-components=3

Or yolo it by adding the tar header yourself:

$ ( printf "\x1f\x8b\x08\x00\x00\x00\x00\x00" ; tail -c +25 backup.ab ) | tar zxv --strip-components=3

You should then have the token file, tokens.xml.

Read the File

Just run this tool, and it'll give you both the OTP URIs (otpauth://...) and scannable QR codes. Note that Google Authenticator ignores the digits parameter, so it does not work for issuers like Blizzard that use lengths other than 6.

If you used pip install: $ freeotp-export tokens.xml

Or with Poetry: $ poetry run freeotp-export tokens.xml

After importing everything to a new app, be sure to delete tokens.xml and backup.ab, since they contain all of your tokens!