GPD Handheld Compatibility

Bazzite
1

This is the old documentation, please view the new documentation.

GPD Win 4

gpdwin4
gpdwin41835×873 110 KB

Status: Gold

Installation Guide

Read the Installing Bazzite on Handheld PCs documentation.

Post-Installation Setup

  • Complete the Bazzite Portal
  • Login to Steam
  • Reboot device
  • Configure the HHD Overlay by opening it with QAM button
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode (See “Desktop Controls” section below)
    • Xbox + X (This can be remapped)
    • GPD devices also have a physical switch you can toggle to enable a separate desktop/mouse mode.

Optional Tweaks

  • Adjust RGB with Steam Gaming Mode in Handheld Daemon
  • Adjust the scaling of the UI in the Display Settings
  • Set a charge limit in HHD with Handheld Daemon
  • Install Decky + the CSS Loader plugin and then in Desktop Mode, open the “Terminal” application and enter:
ujust install-hhd-controller-glyph-theme

Workarounds / Known Issues

  • Games can sometimes default to 800p resolution.
    • Manually change the resolution per game in the Steam Settings > Properties > Game Resolution to either Native or other higher resolutions.
  • Fix controls and gyro after suspend-resume cycles (confirmed to work on both the 7840u and 6800u variants).
    • Run these commands in a host terminal.
  • Back buttons may need to be manually remapped before they are usable.

External Resource

For more information, check out the GPD Win Tips and Tricks guide which includes useful scripts for this handheld.

GPD Win Max 2

placeholder_gpdwinmax2

Status: Gold

Post-Installation Setup

  • Complete the Bazzite Portal
  • Login to Steam
  • Reboot device
  • Configure the HHD Overlay by opening it with QAM button
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode (See “Desktop Controls” section below)
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode. (See “Desktop Controls” section below)
    • Xbox + X (This can be remapped)
    • GPD devices also have a physical switch you can toggle to enable a separate desktop/mouse mode
  • Steam Gaming Mode Display settings that are recommended to be changed:
    • Use Native Color Temperature - Enabled

Optional Tweaks

  • Adjust RGB with Steam Gaming Mode in Handheld Daemon
  • Adjust the scaling of the UI in the Display Settings
  • Set a charge limit in HHD with Handheld Daemon
  • Install Decky + the CSS Loader plugin and then in Desktop Mode, open the “Terminal” application and enter:
ujust install-hhd-controller-glyph-theme

Workarounds / Known Issues

  • Suspend-resume works on the WM2 6800u model after disabling the fingerprint scanner, but 7840u and newer models have only partially working suspend-resume.
    • Read about the issue here for details on suspend-resume issues for the newer WM2 devices.
  • If you install your OS on an m2 2230 SSD in the secondary drive slot, it can cause suspend issues.
    • You should install your OS onto the primary internal SSD only.
  • Games can sometimes default to 800p resolution
    • Manually change the resolution per game in the Steam Settings > Properties > Game Resolution to either Native or other higher resolutions.
  • Gyro is non-functional.
  • Back buttons may need to be manually remapped before they are usable,

External Resource

For more information, check out the GPD Win Tips and Tricks guide which includes useful scripts for this handheld.

TDP Controls

TDP
TDP1920×1201 168 KB

There are a few options for TDP Controls that work with Bazzite:

  • The HHD-overlay supports TDP controls.
    • Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
  • SimpleDeckyTDP supports TDP, GPU, Power Governor, and among other settings.
  • PowerControl supports TDP, GPU, and fan controls on select devices.

How do I open the HHD Overlay?

Overlay
Overlay1920×1201 188 KB

Emulation Mode
Emulation Mode2288×1440 390 KB

Press, hold, or double-tap the Quick Access Menu button.

Note: GPD devices do not support double-tapping the QAM button!

Controller Information

For most handheld hardware, besides the Steam Deck, emulation of a DualSense controller is used for full functionality. Double tap or hold the side menu button to access settings for controller emulation including switching to an Xbox controller with reduced functionality.

If your device has paddles, you will want to use the DualSense Edge controller. It’s disabled by default because some games do not map it correctly.

Some games and emulators may need Steam Input disabled to work correctly with your controls.

Desktop Controls

Desktop Mode Controller Layout: It may not exist by default if Steam doesn’t setup your handheld controller properly. This can be fixed in Steam’s controller settings.

desktop_controls_step_1
desktop_controls_step_1850×722 58.9 KB

desktop_controls_step_2
desktop_controls_step_21280×800 38.9 KB

desktop_controls_step_3
desktop_controls_step_31280×800 59.1 KB

Make sure to apply the desktop controls when you select them.

Contributing

This page is a wiki, edit it to add any relevant information you may have regarding the handheld and your experience with Bazzite on it. Make sure to follow proper documentation guidelines and contributing guidelines before adding any edits.

See also: Steam Gaming Mode Overview

← Back to Handheld Wiki