Running games
Your library
Section titled “Your library”xTux looks for games in the folders of library_dirs in ~/.config/xtux/settings.toml (see
Installation). Every folder in there that contains a game counts, whether xTux
downloaded it or the Windows Xbox app installed it.
xtux-cli listAtomfall Xbox app 701B45CA /mnt/windows/XboxGames/AtomfallFarming Simulator 25 (PC) xTux 69445d50 /home/you/.local/share/xtux/games/LS25xtux-cli list --paths prints only the folders, for scripts.
Starting a game
Section titled “Starting a game”Start a game by its name, its folder name or its path. With shell completion set up, Tab completes the names:
xtux-cli run "Farming Simulator 25 (PC)"xtux-cli run /mnt/windows/XboxGames/AtomfallWine, prefix and market come from the settings. You can pass them for a single run instead:
WINEPREFIX=~/Games/other-prefix xtux-cli run -m DE "Atomfall" ~/wine-tux-force-x86_64/bin/wine| Option | Effect |
|---|---|
[WINE] |
Wine binary, defaults to wine from the settings |
-e, --exe <exe> |
Start a different executable of the game than the one in MicrosoftGame.config |
-m, --market <market> |
Store market for the license, for example DE |
-- <args...> |
Replace the game arguments saved in the per-game settings for this run |
Before the game starts, xTux fetches its license from Microsoft, so only games your account is entitled to start. Ctrl+C asks the game to quit, as closing it on Windows would.
If the same game is installed twice (for example once by Windows and once by xTux), run lists both folders and asks
you to pick one by path.
Windows Xbox app installs (dual boot)
Section titled “Windows Xbox app installs (dual boot)”Games the Windows Xbox app installed, usually in XboxGames on a Windows partition, run straight from there. Mount
the partition (most desktops do this when you open it in the file manager) and add its XboxGames folder to
library_dirs; drives under /mnt, /media and /run/media/$USER are found automatically.
xTux reuses these installs without copying them. The launcher also offers Delete game…: after confirmation, it removes the entire game folder, including Windows installs and any saves inside that folder. Windows then needs to repair or reinstall that game.
One install format
Section titled “One install format”xTux uses the same folder layout as the Windows Xbox app for its own downloads too:
<game>/Content/... the game files<game>/<CONTENT-ID> package header (license, keys, file list), named by the content id<game>/<CONTENT-ID>.xvi bookkeeping of the Windows Xbox app (only in its installs)So one folder format works everywhere. Whether the Windows Xbox app accepts an install made on Linux has not been tested yet.
Moving older installs
Section titled “Moving older installs”Installs made by Xodus or early xTux versions keep the game files directly in the folder with a
.xodus-streaming.msixvc file. They still run. To move one into the common layout:
xtux-cli migrate ~/.local/share/xtux/games/LS25migrate only renames files inside the folder, so it is quick and needs no extra space.
Downloading a game
Section titled “Downloading a game”xtux-cli streaming 9NXN8GF8N9ZQ ~/.local/share/xtux/games/LS25The source is the game’s store id (the code at the end of its Microsoft Store web address) or a content id. If a
product has several packages, xTux asks which one. --parallel <n> sets the number of parallel downloads. Ctrl+C
stops the download.
Download queue
Section titled “Download queue”The launcher and CLI share the service’s persistent download queue. Add a Store ID from the catalog, optionally with a configured library folder as the destination:
xtux-cli downloadsxtux-cli downloads add 9NXN8GF8N9ZQxtux-cli downloads pause 1xtux-cli downloads resume 1xtux-cli downloads up 1xtux-cli downloads down 1xtux-cli downloads remove 1xtux-cli downloads clearUse the actual queue ID shown by xtux-cli downloads in place of 1. Jobs run one at a time; the service
continues while the launcher is closed and restores the queue after restart. remove can delete a partial
installation created by that job; clear removes completed queue entries, not installed games.
Per-game Wine, prefix, executable, arguments and environment settings saved in the launcher also apply to CLI launches. See Launcher.