Skip to content

Troubleshooting

  • Service log: ~/.local/state/xtux/service.log. Game starts, the game bridge (tokens, licenses) and errors of xtux-service end up here, also when you start games from the launcher.
  • Terminal: xtux-cli prints progress and errors directly.
  • More detail: XODUS_LOG sets the log filter, for example XODUS_LOG=debug xtux-cli run "...". Wine’s own output can be widened with WINEDEBUG.

When you report a problem, add the game, your distribution, GPU and driver, and the relevant part of the log. Remove tokens and personal data first.

Variable Effect
XTUX_DIRECT=1 Run the command inside xtux-cli instead of through xtux-service; output goes to the terminal
XTUX_IDLE_TIMEOUT=<seconds> How long xtux-service waits idle before it exits (default 300, 0 keeps it running)
XTUX_SERVICE=<path> Use this xtux-service binary instead of the one next to xtux-cli
XTUX_SKIP_SMBIOS=1 Register the PC without the firmware information, see password prompts

See Sign-in and password prompts: it is either your keychain or the one-time registration of the PC.

“cannot read the device license from the keychain”

Section titled ““cannot read the device license from the keychain””

The keychain is locked or not running. Unlock KWallet or GNOME Keyring and try again. Make sure a Secret Service provider runs in your session (gnome-keyring-daemon or kwalletd).

“… is neither a game folder nor an installed game”

Section titled ““… is neither a game folder nor an installed game””

run did not find the name in your library. Check xtux-cli list, the library_dirs in the settings, and that the Windows partition is mounted.

The same game is in two library folders. Start it by path, as the message shows.

run needs the Wine binary, either as the second argument or as wine in the settings (launcher: Settings).

The game shows a black screen or no intro video

Section titled “The game shows a black screen or no intro video”

Make sure the prefix was set up with xtux-cli prefix init and that you start the game with the Tux-Force Wine build; it contains the video decoder setup and runtime the games need. Check the compatibility list for known problems with the game.

Run xtux-cli prefix init again: it adds the Microsoft root certificates games expect. Check the service log for errors of the game bridge.

xtux-cli crashes with “illegal instruction”

Section titled “xtux-cli crashes with “illegal instruction””

xTux uses the AES instructions of the CPU to decrypt game packages. CPUs older than about 2011 do not have them.