XIVLauncherWrapper/README.md

38 lines
1.2 KiB
Markdown

# 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:**
Create the configuration directory and copy the example config.
```bash
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 (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.