Google Authenticator Exporter

This app helps to convert exported QR codes from Google Authenticator to otpauth format codes.

Caution

Please, read this segment carefully.

Important Disclaimer

Although I've done some research and fixed some bugs, I cannot guarantee that this app will export and parse all your codes correctly. Please, double and even triple-check all codes this app generates and audit the code yourself.

I have backed up all of my 100+ 2FA codes to printed pages using this app, tested them, and faced no issues. However, to avoid data loss, please verify everything thoroughly.

If you find any bugs, please open an Issue.

Is it secure?

Although this app is frontend-only (meaning it has NO backend, DOES NOT store any data, and runs ONLY on the client), it should NOT be used for:

• Production environments
• The only tool to back up your data

Despite trusting GitHub and GitHub Pages, you can run the code on your own machine in offline mode to process your codes. Do not use this app in any critical or important environments.

This project has not undergone security audits and may contain vulnerabilities and critical, data breaking bugs. It serves as a learning tool and a demonstration of protobuf and TOTP concepts only.

USE AT YOUR OWN RISK.

Features

• Google Authenticator Export format parsing
• Allows exporting codes as text
• Allows saving codes as a JSON file
• Allows printing codes (each code should fit an A5 page)
• Doesn't store any data

Configuration

This app currently has only one ENV parameter, which is VITE_BASE_URL. It changes the base URL of the app and is used in the pages deploy script.

Building

This project has a default Vite build configuration. Just use npm run build to build (or any other package manager).

Developing

The development process is the same as most Vite apps. Just install dependencies and run the development script.

Deploying

Check out Dockerfile and docker-compose.yml:

services:
  gAuthExporter:
    container_name: google-authenticator-exporter
    image: ghcr.io/alpaim/google-authenticator-exporter:latest
    #    build: .
    ports:
      - "80:80"
    networks:
      - gAuthExporterNetwork

networks:
  gAuthExporterNetwork:
    name: gAuthExporterNetwork