Atlas is a launcher for Titanfall 2, Northstar, and ION.
cargo build
Run from the workspace:
cargo run -- installations
Install the local binary into Cargo's bin directory:
cargo install --path crates/atlas-cli
Atlas also includes a Tauri/Vue desktop app:
cd apps/atlas-gui
npm install
npm run dev
Build installable Linux packages:
cd apps/atlas-gui
npm run build
Regenerate the offline dependency source manifests after changing
Cargo.lock or apps/atlas-gui/package-lock.json:
curl -L https://raw.githubusercontent.com/flatpak/flatpak-builder-tools/master/cargo/flatpak-cargo-generator.py -o /tmp/flatpak-cargo-generator.py
python3 /tmp/flatpak-cargo-generator.py Cargo.lock -o flatpak/cargo-sources.json
pipx run --spec git+https://github.com/flatpak/flatpak-builder-tools.git#subdirectory=node flatpak-node-generator npm apps/atlas-gui/package-lock.json --node-sdk-extension org.freedesktop.Sdk.Extension.node24//25.08 -o flatpak/npm-sources.json
Build and install the source Flatpak locally:
flatpak install --user flathub org.gnome.Sdk//50 org.freedesktop.Sdk.Extension.node24//25.08 org.freedesktop.Sdk.Extension.rust-stable//25.08
flatpak-builder --user --install --force-clean build-dir org.kvxd.atlas.yml
flatpak run org.kvxd.atlas
For a faster local-only rebuild, first build the Tauri binary, then install the wrapper manifest:
npm run build --prefix apps/atlas-gui -- --no-bundle
flatpak-builder --user --install --force-clean build-dir-local flatpak/org.kvxd.atlas.local.yml
flatpak run org.kvxd.atlas
atlas installations
atlas proton-tools
atlas install <installation-id> --distribution <northstar|ion>
atlas uninstall <installation-id>
atlas launch <installation-id> --distribution <vanilla|northstar|ion>
atlas doctor
Manual game directories are accepted by commands that take an installation ID, but they must use --provider steam or --provider ea. Manual Steam paths must match detected Steam metadata.
Install Northstar or ION into a detected Titanfall 2 directory:
cargo run -- install <installation-id> --distribution northstar
cargo run -- install <installation-id> --distribution ion
Only one modded variant can be installed at a time. Use uninstall before switching variants, or --force if you intentionally want to replace the active Atlas-managed variant.
Uninstall removes only files tracked by Atlas from the active previous install:
cargo run -- uninstall <installation-id>
The repository includes a tiny fake Steam root. It is not a game install; it only contains metadata and an empty Titanfall2.exe placeholder so discovery and dry-run launch flows can be exercised.
cargo run -- --steam-root crates/atlas-core/tests/fixtures/demo-steam-root installations
cargo run -- --steam-root crates/atlas-core/tests/fixtures/demo-steam-root proton-tools
To preview launch without starting Steam:
cargo run -- --steam-root crates/atlas-core/tests/fixtures/demo-steam-root launch <installation-id> --distribution vanilla --dry-run
You can also set ATLAS_STEAM_ROOTS using your platform path separator instead of passing --steam-root.