XA Sub Manager

Overview

XA Sub Manager watches and drives your fleet of FFXIV accounts from one compact window. It reads each account's AutoRetainer / XA Database / Lifestream data — showing every character, submarine, and retainer at a glance — and, when you turn automation on, launches, logs in (including 2FA), arranges, and closes clients on a schedule so your submarines and ventures keep cycling without you babysitting them.

It is a single self-contained XA Sub.exe — no .NET or other runtime to install, no telemetry. Automation is off by default; nothing launches or closes until you press Start Automation.

Key Features:

Multi-account dashboard — characters, subs & retainers at a glance
Sequential launch / login (incl. 2FA) / arrange / close automation
Visual multi-monitor window-layout editor & dynamic grid
Animated Empire View of every submarine by ETA and rank
Optional token-gated web dashboard with live client video
Discord / Pushover notifications and crash logging

Technical Details

Local & Private:

• Reads plugin data, never modifies it — it does launch, arrange, and close game clients (that's the point of automation)
• No telemetry, no account, no login — nothing is uploaded
• Optional web dashboard is off by default and binds to 127.0.0.1
• Outbound traffic only for the Discord / Pushover notifications you configure
• Saved config.json is locked to an owner-only ACL; 2FA secrets can live in Windows Credential Manager instead of the file
• Privacy toggle masks names for shareable screenshots

⚠️ Exposing the web dashboard beyond this PC requires a token; for remote access put it behind a TLS reverse proxy / firewall allow-list and use a long random token. Forwarding the port to the open internet without those is unsafe.

Data Sources:

• AutoRetainer configurations
• XA Database SQLite files
• Lifestream housing data

Requirements:

• Windows 10/11 x64, or a Linux Wine prefix (experimental)
• XIVLauncher with the relevant plugins (AutoRetainer, etc.) configured per account
• For 2FA: XIVLauncher's "Enable XL Authenticator app/OTP macro support" turned on
• For window resizing/layout: run FFXIV in windowed mode

Comprehensive Features

Multi-Account Dashboard

• Summary cards & accounts list
• Cross-account character search & sort
• Details pane: jobs, currencies, subs, retainers
• Configurable row highlights

Automation

• Sequential launch → login → arrange → close
• Per-account manage toggle & scheduled hours
• Force-crash recovery for frozen clients
• Automatic FFXIV patch handling (opt-in)

2FA & Launch Flow

• TOTP from Windows Credential Manager
• Delivered to XIVLauncher's OTP endpoint
• Autologin validation before launch
• Stuck-launcher recovery

Window Management

• Visual multi-monitor layout editor
• Drag, snap, capture from live windows
• Dynamic grid or run-minimized modes
• Per-account topmost / activate rules

Empire View & Monitoring

• Animated fleet plot by ETA & rank
• Retainer camps & force-close timers
• Sublord DB history (Python-compatible)
• Crash logs & minidumps

Remote & Comfort

• Web dashboard: stats, controls, live client video
• Discord / Pushover notifications
• 13 themes + privacy toggle
• UI scale 100–300% for hi-res monitors

Web Dashboard (Remote Access)

An optional embedded web server gives you a browser dashboard plus a control API — watch stats and start/stop automation, enable/disable accounts, and launch/close clients from a phone or another PC. Off by default.

Enable it in Settings → Web Server (applies live on Save). Open http://127.0.0.1:4269/, enter your token, and you get summary cards, Accounts (Manage / Launch / Close), Characters, an Empire timeline, and a Clients tab with live low-res video of each running client.

Every API call needs the token (constant-time compared)
Cross-origin requests rejected, security headers set
Until you set a token, the API is disabled
LAN binding refuses to start without a token

Installation & Usage

Windows Installer

Download and run the installer
Accept the license agreement
XA Sub Manager installs per-user (no admin needed) with a Start Menu entry
Launch it — your accounts appear; automation stays off until you start it

Windows Portable

Download the portable .zip
Extract anywhere you like
Run XA Sub.exe

Linux (via Wine)

Download the Linux / Wine .zip
Edit run-linux.sh to point at your game's Wine prefix
chmod +x run-linux.sh && ./run-linux.sh

Experimental — same exe under Wine; see the bundled README-LINUX.md for limitations and the same-prefix detection caveat.

First-Run Setup

Single account, default XIVLauncher install? No editing needed. On first launch XA Sub seeds a default Main account and auto-detects your platform's default pluginConfigs folder (%APPDATA%\XIVLauncher\pluginConfigs on Windows, ~/.xlcore/pluginConfigs under Wine/XLCore) — your data appears on the very first run.

For more accounts, open Settings and either Import Settings… (pulls in an existing Auto-AutoRetainer config_*.json wholesale) or add each account's pluginConfigs path + game launcher — every path field has a browse button, and UNC network paths are supported. Nearly every option lives in the four-column Settings window with hover help on each field.

config.json lives next to XA Sub.exe. Updates never touch it — your config, window layouts, and history are preserved. The running version is shown in the title bar and Settings → General.

FAQ

Does it modify my game or get me banned?

It doesn't modify plugin data, but it does automate the game client (launch/login/close). Automating FFXIV can violate the User Agreement and risk your account — see the disclaimer below. Automation is off until you start it.

Do I have to edit config.json before the first run?

No — with a single default XIVLauncher install your data shows up immediately. Edit it (or use Import Settings) only to add more accounts or change defaults.

Is there a native Linux build?

No — it's a Windows app that runs under Wine on Linux, inside the same prefix you use for XIVLauncher + FFXIV. See the Linux install steps above.

Windows warned me about an unrecognized app.

The binaries are not code-signed, so SmartScreen flags new downloads — choose More info → Run anyway. Verify the SHA-256 checksums in the download box above if you want to be sure.

Can I change the web dashboard port?

Yes — Settings → Web Server, or set WEB_SERVER_PORT (default 4269).

Where's the version?

In the title bar and Settings → General → Version.

Is the source code available?

No. XA Sub Manager is proprietary, closed-source software distributed as compiled binaries. The GitHub repository hosts the project README and license only — downloads come from this page.

Found a bug or have a request?

Reach us on Discord at discord.gg/g2NmYxPQCa.

Licensing & Disclaimer

Use of the software is governed by its End User License Agreement, shown during installation and included with every download. In short:

Free for personal, non-commercial use on your own devices
No redistribution or re-hosting — link people to this page instead
No reverse engineering, modification, or derivative works
Provided as-is, without warranty of any kind

⚠️ Disclaimer: use of third-party tools and automation may violate the FINAL FANTASY XIV User Agreement and can put your account at risk, including suspension or termination. You are solely responsible for how you use this software.

Read the EULA Third-Party Notices

XA Sub Manager includes third-party components, each under its own license — see the Third-Party Notices. Not affiliated with SQUARE ENIX. FINAL FANTASY XIV is a registered trademark of SQUARE ENIX Holdings Co., Ltd.