Initial commit

README.md

@@ -0,0 +1,37 @@
+# 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.
+    ```bash
+    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:
+    ```bash
+    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:
+
+```bash
+./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.