Common Gamemode Issues
Why is my SD Card / Drive not detected in Gamemode
Anatase automatically mounts all ext4 and btrfs drives when you enter gamemode, regardless of whether they are external or internal. Make sure your drive is formatted using one of those formats. If not, head to desktop mode and use the partition manager to format it to ext4 (ext4 is better for compatibility with official SteamOS; btrfs is better for compatibility with Windows via WinBtrfs). Afterwards, if Steam does not detect your drive as a library, open Steam in desktop mode and create a Steam library there.
SD cards created in other operating systems such as SteamOS are supported and will work automatically. NTFS, exfat, fat32 drives can cause Steam to corrupt the drive library when it installs compatibility data, so they are not automounted for your safety. A recent bug in the Steam client makes unmounting drives not work so it is recommended to shutdown before unplugging your SD card.
How do I install Emudeck
The Emudeck Beta supports Anatase. Until it becomes stable, you may use RetroDeck.
How do I install Sunshine
You can download this desktop file to install Sunshine. Double click it, press install, and enter your user password (empty passwords auto-accept). Use the same desktop file to remove or update Sunshine. This desktop file is unofficial and provided by Anatase, so please report installation failures and other issues here. It only supports Anatase.
The desktop file downloads and runs this script.
You may download, review, make executable, and run the script directly.
The script downloads the latest Sunshine AppImage from Sunshine's official
Github and extracts int under /opt. It enables KMS support (the good stuff
for HDR), makes sunshine autostart, and works in Gamemode. By using the
desktop shortcut, you ensure you always use the latest version of the script.
How do I install Faugus
Install Faugus from Flathub. Then, run the following command to enable steam shortcut support in Faugus:
sudo flatpak override io.github.Faugus.faugus-launcher --talk-name=org.freedesktop.Flatpak
How do I install Epic Games Launcher
The Epic Games Launcher is packaged by Anatase and provided for you to use in e.g., Gamemode. Install it from Discover (search Epic Games Launcher), add it as a non-Steam game by right clicking (holding) the desktop shortcut and selecting Add to Steam. Touch screen support needs to be enabled manually by opening Controller settings in Steam, selecting Edit Layout -> Action Sets -> Default [Gear Icon] -> Add Always-On command -> System -> Touchscreen Native Support. Otherwise mouse emulation will be used, preventing you from touch scrolling and opening games. Launching games individually (as with Heroic) is not currently supported.
How do I install Heroic Games Launcher
Consider using Epic Games Launcher as it is supported by Epic for Epic Games. If not, install it from Discover and do not use the Appimage. You may add it as a Non-Steam game to access in gamemode and use its add to Steam game setting to access your games directly. Do not override the proton version from Steam. When you are using Heroic, it uses its own proton and trying to set a different Proton from the Steam menu will cause it not to launch.
How do I install Waydroid
You may follow the official instructions for Silverblue/Kinoite
to layer waydroid in your installation. This will disable automatic updates and
you will need to update manually using sudo rpm-ostree update. Moreover, you
may have issues in gamemode. Better Android integration will be investigated in
the future.
Why does X application not work in gamemode
Third party application support in gamemode is constantly improving. If an application or game does not launch correctly in gamemode, open a support thread in discord. Compatibility with Faugus, Heroic Games launcher, ProtonPlus, flatpaks, non-Steam game executables in your home directory, and Spaces applications is already implemented, but rare edge cases might still not be handled correctly.
Here, there is one exception. Steam cannot see files under .var/app that are
managed by Flatpak. So, if you install a game via PortProton or Heroic and try
to launch it directly via its executable, you will see a /run/user/... file
and it will not work. Either launch the game via the flatpaks themselves, or
use Faugus for direct .exe files, because it installs games under ~/Faugus.
Help, my device no longer boots because X
By default, Anatase saves the previous version of the OS in a separate fallback
slot. When your device starts, you can hold shift to show the Anatase bootloader
(GRUB) and select the previous version with the arrow keys and Enter.
If your device crashes within 3 minutes of startup, the next time it starts you will see the bootloader. If you are on a handheld and do not have access access to a keyboard, holding the power button while Anatase starts to turn it off and repeating three times will advance to the fallback version automatically. You can then update to discard the broken version.
My speakers sound flat, can I tune them (with a DSP)?
If you want to tune your speakers with a custom equalizer, you can use the excellent Easy Effects application in desktop mode. A community member has provided presets here for you to try while e.g., watching a gameplay video on YouTube.
Once EasyEffects is installed it will always automatically load when gamemode starts and apply your preset. It is not possible to add EasyEffects as a non-Steam game because it is running in the background.
How do I use different layouts with my desktop keyboard?
If you have a desktop keyboard, it will follow the layout settings you have
set in the OS and desktop mode. Configure a keyboard layout in Desktop settings
then return to gamemode. If you have multiple layouts, you can use Start+Space
to switch between them, or set up a custom key binding in desktop mode
(Start+Space will be disabled).
Using eGPUs in Gamemode
Anatase supports eGPUs and is actively tested for with an Nvidia eGPU. To use an eGPU with Anatase, shutdown your device. Connect your eGPU and a display cable (if you want to use an external monitor) and start your device. To disconnect your eGPU or change the display output, poweroff your device and make the relevant cable changes. Hotplug and dynamic display switching are not currently supported in gamemode.
Do not use third party scripts such as all-ways-egpu. They can destabilize your installation and create issues that are hard to diagnose. If you experience issues with your eGPU configuration, open a support thread or Github issue instead.
The Steam Keyboard in desktop has incorrect scaling
This is a known issue with the Steam keyboard on Wayland. First, you should consider using the keyboard built into Anatase, as it will only get better. If not, because to quote a user "I do not want to put my cheesy fingers on this gorgeous OLED panel", you can lower your desktop scaling to 150% or lower. This will fix the keyboard, but might not be ideal for visibility.
How do I get CEC support
Consumer Electronics Control (CEC) is an auxiliary feature of HDMI that allows your device to turn on and off your TV and switch inputs. It also allows the remote control of your TV to control your device. Anatase supports CEC using the native kernel implementation. Currently, this means that you need a Steam Machine or the UGREEN DP to HDMI 2.1 8k adapter. The UGREEN adapter is supported on AMD, Intel, and Nvidia GPUs (so everything) and can do 4k 144hz 10bit HDR VRR, ensuring crisp visuals.
With native CEC support, you can use the remote arrow buttons to navigate gamemode, and double tapping the back button will open the Sidebar, with a tripple tap opening Handheld Daemon. In addition, if your TV is off, starting your device or waking it from sleep will wake up your TV and switch to the correct input. If your TV was turned on by Anatase, entering sleep will also turn it off.
Support can be added relatively easily for legacy USB HDMI passthrough adapters, such as the Pulse Eight USB - CEC Adapter. However, this adapter is only HDMI 2.0 (4k 60hz only), can interfere with the HDMI signal, and costs 3x as much.
Note that using USB-C to DisplayPort before the UGREEN adapter, which is required for handhelds, degrades signal quality, and the adapter itself is not perfect, which can cause black screens. Prefer certified HDMI 2.1 cables up to 2 meters in length and preferably 1 meter to compensate for this loss. When you buy a cable, scan the QR code on the packaging to verify it is certified.
How do I get HDMI 2.1 support
Anatase supports HDMI 2.1 on all handhelds, Intel GPUs, and Nvidia GPUs. The only device without HDMI 2.1 support is native HDMI ports on AMD GPUs, where support will be added in 2-3 months once it is considered stable.
Handhelds do not have HDMI ports so they do not benefit from the 7.2 kernel patches by AMD. Instead, they output a DisplayPort signal over USB-C, which is converted by your dock to HDMI. Therefore, support for HDMI 2.1 features such as 4k 144hz 10bit HDR VRR will always need an adapter or dock. There are currently no docks with full HDMI 2.1 functionality (full is considered as 2.1 48 FRL, CEC, VRR, and ALLM).
PCONs (the converters that create the HDMI signal) are advancing rapidly, and the UGREEN DP to HDMI 2.1 8k adapter is currently the best option. There are no other adapters or docks that utilize the same chipset at the time of this writing. Once they are available, this FAQ will be updated. Until then, it is recommended to buy a dock with a native DisplayPort 4k 120hz+ output, a UGREEN adapter, and a certified HDMI 2.1 cable that is up to 2 meters in length (preferably 1 meter). This way, you can retain the dock and cable while replacing the cheaper adapter once better ones become available.
How do I wake my device with a bluetooth controller
Bluetooth wake support is an upcoming feature in Anatase. There are some wake policy issues that need to be resolved first before it can be rolled out by default (devices such as bluetooth headphones waking up the device, random wake-ups, wake-ups on battery). However, if you are an HTPC user and want to wake your device with a bluetooth controller, you can use the following rules. These will work for the majority of handhelds. First, use nano to open a udev rules file.
sudo nano /etc/udev/rules.d/99-bluetooth-wake.rules
Then, add the following line to the file:
# Foxconn/Hon Hai 0489:e0e2
ACTION=="add|change", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", DRIVERS=="usb", ATTR{idVendor}=="0489", ATTR{idProduct}=="e0e2", TEST=="power/wakeup", ATTR{power/wakeup}="enabled"
# MediaTek MT7922 Bluetooth module 0489:e0d9. Lenovo Legion Go
ACTION=="add|change", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", DRIVERS=="usb", ATTR{idVendor}=="0489", ATTR{idProduct}=="e0d9", TEST=="power/wakeup", ATTR{power/wakeup}="enabled"
# Intel AX210 Bluetooth 8087:0032. Win 5, Aya 3, Aokzoe A1x ...
ACTION=="add|change", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", DRIVERS=="usb", ATTR{idVendor}=="8087", ATTR{idProduct}=="0032", TEST=="power/wakeup", ATTR{power/wakeup}="enabled"
# Intel BE200 Bluetooth 8087:0037. Claw 7 AI
ACTION=="add|change", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", DRIVERS=="usb", ATTR{idVendor}=="8087", ATTR{idProduct}=="0037", TEST=="power/wakeup", ATTR{power/wakeup}="enabled"
Ctrl+X, Y, Enter to save and exit. Then, reboot. If a rule for your modem
is missing, open a support thread.