enables auto-OTP on linux
Find a file
2026-01-09 22:58:56 +01:00
.gitignore chore: update .gitignore and remove __pycache__ 2026-01-09 22:58:56 +01:00
config.example.json Initial commit 2026-01-09 22:54:55 +01:00
README.md Initial commit 2026-01-09 22:54:55 +01:00
wrapper.py Initial commit 2026-01-09 22:54:55 +01:00

XIVLauncher OTP Wrapper

This is a simple wrapper script for Linux that launches xivlauncher-core and automatically injects your One-Time Password (OTP) when the launcher requests it.

Setup

  1. Configure: Copy the example config and edit it with your details.

    cp config.example.json config.json
    nano config.json
    
    • secret: Enter your TOTP secret key (in Base32 format, usually provided when you set up your authenticator app).
    • launcher_cmd: The command to launch XIVLauncher (default: xivlauncher-core).
  2. Make Executable: Ensure the script is executable:

    chmod +x wrapper.py
    
  3. XIVLauncher Settings: Ensure that "Enable XL Authenticator app/OTP macro support" is enabled in XIVLauncher settings.

Usage

Simply run the wrapper instead of the launcher:

./wrapper.py

The script will:

  1. Launch XIVLauncher.
  2. Wait for the launcher to start its local HTTP server (port 4646).
  3. Generate the current OTP code.
  4. Send it to the launcher automatically.