Skip to content

Launcher

The xTux Launcher (xtux-launcher) is the graphical front end of xTux. Browse your installed games, start them from the library and explore the Store catalog.

Terminal window
xtux-launcher

Account details and personal paths are redacted in these screenshots.

xTux Launcher library with installed games, Play buttons and compatibility indicators
LibraryInstalled games, install sources and compatibility at a glance.

1 / 3 — Library

Personal paths and runtime logs are also redacted in the game detail view. Click a screenshot to open the enlarged overlay; use the arrows or swipe to browse, and Escape or the close button to return.

Download branded social-media versions of all three views.

  • Library: installed games from the configured library folders, as a cover grid or list. Search, refresh, Play/Stop controls, install-source labels, license errors and file-based anti-cheat indicators are available.
  • Game details: artwork, Play/Stop, the last launch log and per-game Wine binary, prefix, executable, arguments and environment variables. Empty settings inherit the global defaults; Save persists changes.
  • Store: browse PC Game Pass and owned titles; filter by Game Pass, Owned, Installed or Installable only. A title page shows artwork, description, package information and a screenshot gallery. A catalog listing is not proof that your account is entitled to play a title; Microsoft checks the license at launch.
  • Downloads: choose a configured library folder from a Store title and add an install to the service’s queue. View progress, network/disk activity, pause, resume, reorder and remove jobs, or clear finished entries. The service processes one queued install at a time and saves the queue across restarts.
  • Settings: global Wine binary, shared prefix and library folders, plus theme, accent, background, app icon, online artwork and the optional title-name-based anti-cheat estimate for Store titles.
  • Logs: view and reload the service log. The game detail page shows the last game log separately.
  • About: version, license, project links and third-party licenses.
  • Sign in: opens Microsoft’s sign-in window in a separate helper process.

The status bar shows game starts, exits and errors. Closing the launcher does not stop the service’s queued downloads.

Open a Store title, choose Install, select a library folder and choose Add to downloads. Titles without a supported PC package cannot be installed. A Store title with a local install offers Play.

Delete game… on an installed game’s page deletes its entire game folder after confirmation. This also applies to Windows Xbox app installs; Windows will need to repair or reinstall them afterwards. Local saves inside that folder are deleted too. This action does not simply hide a game from the library.

Update checks and verification of an already installed game are not available in the launcher yet. Flatpak packaging and automatic first-launch prefix setup remain planned. Prepare each prefix using xtux-cli prefix init before using it.

Global and per-game settings share $XDG_CONFIG_HOME/xtux/settings.toml (normally ~/.config/xtux/settings.toml) with the CLI. Per-game settings are keyed by the game folder, not the Store ID. A shared prefix is the default; choose a separate prefix in a game’s settings if needed and initialize it first.

Terminal window
xtux-launcher --page store
xtux-launcher --page settings
xtux-launcher --game "Farming Simulator 25 (PC)"
xtux-launcher --play "Farming Simulator 25 (PC)"

--page accepts library, store, settings, about and logs. --game opens an installed game’s page; --play starts it. If a game is installed more than once, use its folder path.

Online artwork uses the public Microsoft Store catalog and caches images under ~/.cache/xtux/art. Choose Only from the game folder to disable new online artwork loads. Installed games are checked for anti-cheat files. Store title-name guesses are optional, off by default and unverified per title; they are not community compatibility reports.

The service log is normally ~/.local/state/xtux/service.log; game logs are under ~/.local/state/xtux/logs/. The queue is stored in ~/.local/state/xtux/downloads.json. These paths follow XDG_STATE_HOME when set.

The launcher does not contain the game logic itself. It talks to xtux-service, the same background service xtux-cli uses, and starts it when needed. That way the command line and the launcher always behave the same. See Architecture.