XIVLauncher OTP Wrapper

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

Features

• Auto-Detection: Automatically detects if you are using the native xivlauncher-core (Arch/AUR) or the Flatpak version.
• OTP Injection: Generates TOTP codes and sends them to the launcher's internal server.
• URL Support: Accepts standard Base32 secrets OR full otpauth:// URLs (e.g. from QR codes).
• Auto-Configuration: Prompts to fix launcher.ini settings if they are incorrect.

Installation (Steam Deck / Linux Desktop)

The easiest way to install is using the provided installer script.

1. Run the Installer:

   ./installer.sh
   

2. Enter Secret: When prompted, enter your TOTP Secret or paste a full otpauth:// URL.

What it does:

• Creates ~/.config/xivlauncher-wrapper/config.json.
• Installs the wrapper to ~/.local/bin/xivlauncher-wrapper.
• Installs a .desktop file to ~/.local/share/applications/ so it appears in your application menu.

Steam Integration (Steam Deck)

1. Switch to Desktop Mode.
2. Open Steam.
3. "Games" -> "Add a Non-Steam Game to My Library".
4. Select "XIVLauncher Wrapper" from the list.
5. Return to Gaming Mode and launch "XIVLauncher Wrapper".

Manual Setup

1. Configure:

   mkdir -p ~/.config/xivlauncher-wrapper
   cp config.example.json ~/.config/xivlauncher-wrapper/config.json
   nano ~/.config/xivlauncher-wrapper/config.json
   

   • secret: Enter your TOTP secret key or otpauth:// URL.
   • launcher_cmd: (Optional) The command to launch XIVLauncher. If omitted, the wrapper will auto-detect it.

2. Make Executable:

   chmod +x wrapper.py
   

3. XIVLauncher Settings: Ensure that "Enable XL Authenticator app/OTP macro support" is enabled in XIVLauncher settings. The wrapper will check for this and prompt you if it's disabled.

Usage

Simply run the wrapper:

./wrapper.py

Or launch "XIVLauncher Wrapper" from your application menu/Steam.