Prerequisite:
- Turn on Secure Boot
- https://github.com/hhd-dev/hhd?tab=readme-ov-file#extra-steps-gpd-win-devices
- set L4 to SYSRQ and R4 to PAUSE
Decky https://github.com/honjow/GPD-WinControl https://github.com/hhd-dev/hhd-decky
fixes
https://github.com/aarron-lee/gpd-win-tricks/blob/main/win4-gyro-suspend-fix/README.md
It's blank by default. Flatpak apps seems using the dark theme fine out of box.
I changed the setting once and couldn't revert it back, now flatpak apps won't use dark theme.
Current workaround is to add global env var in Flatseal GTK_THEME=adw-gtk3-dark
Note: The default theme in ~/.config/gtk-3.0/settings.ini and ~/.config/gtk-4.0/settings.ini in a new install is empty (no entry)
Alternatively, install org.gtk.Gtk3theme.Breeze then set it in KDE settings
No lock screen feature by default.
Can follow https://github.com/RHOPKINS13/SteamDeckScreenLock, but need to change the exec to
Exec=loginctl lock-session
Ref: https://www.reddit.com/r/kde/comments/av3riz/command_to_lock_the_screen/
Bonus: relax failure unlock timeouts https://gist.github.com/fsworld009/cb9a402ede96fa6087a2562d987e82be#relax-the-rule-to-lock-out-10-mins-after-3-login-fails
Meta+L shortcut: KDE shortcut settings -> add application shortcut -> Select the .desktop file we just created
- Doesn't detect Lutris: run lutris once
- Old GE-Proton version not listed anymore: manual download and extract to ~/.steam/root/compatibilitytools.d/
https://www.reddit.com/r/SteamDeck/comments/10pdz5m/nonsteam_cloud_saves_between_steam_deck_and /
change port from 8080 to 8384 https://www.reddit.com/r/SteamDeck/comments/xjmal2/psa_for_anyone_using_syncthing_and_decky_at_the/
https://github.com/theCapypara/steamdeck-decky-syncthing
Not sure why it's not in one installation but you can copy it from another install (from ~/.local/share/Steam/config/uioverrides/movies)
Built in, but no https://github.com/openvanilla/fcitx5-mcbopomofo
Tried follow the guide to build on fedora distrobox, failed with
CMake Error at /usr/share/cmake/Modules/CMakeCompilerIdDetection.cmake:127 (message):
No preprocessor test for "PathScale"
Call Stack (most recent call first):
/usr/share/cmake/Modules/CMakeDetermineCompilerId.cmake:340 (compiler_id_detection)
/usr/share/cmake/Modules/CMakeDetermineCompilerId.cmake:359 (CMAKE_DETERMINE_COMPILER_ID_WRITE)
/usr/share/cmake/Modules/CMakeDetermineCompilerId.cmake:8 (CMAKE_DETERMINE_COMPILER_ID_BUILD)
/usr/share/cmake/Modules/CMakeDetermineCompilerId.cmake:64 (__determine_compiler_id_test)
/usr/share/cmake/Modules/CMakeDetermineCCompiler.cmake:123 (CMAKE_DETERMINE_COMPILER_ID)
CMakeLists.txt:2 (project)
Use flatpak fcitx5 for now. However this seems to disable the built-in fcitx5 install so I have to install Mozc on flatpak as well, even though it was installed in system already.
The default terminal in vanilla KDE is Konsole. However, Konsole has been removed by in bazzite image even if using KDE flavor.
It was an intended change by devs ublue-os/bazzite#1933
As a result it's better to install Konsole from flatpak.
If you insist installing konsole as system package:
sudo rpm-ostree install konsole
Note that this means every update would require additional step to reinstall konsole and its dependencies. Should be fine in this case since konsole doesn't require any other dependency on top of bazzite image.
Default terminal is set to ptyxis which is the Gnome terminal. To us Konsole, change it to Konsole in KDE settings.
After doing it there will be a new shortcut ~/.local/share/applications/konsole.desktop, can update it to
[Desktop Entry]
Exec=/usr/bin/konsole
Name=Konsole
Type=Application
Icon=utilities-terminal
So it's visible in start menu
Alternatively you can use https://github.com/dnkmmr69420/enable-konsole-on-bazzite
https://universal-blue.discourse.group/t/dual-boot-preliminary-setup-and-post-setup-guide/2743
ujust regenerate-grub
Cannot use Wine game -> Open Bash terminal option (no window opened)
observed from lutris -d that it is trying to run
/usr/bin/ptyxis -e /home/fsworld009/.cache/lutris/run_in_term.sh
Run it manually would result in
Unkwon option -e
Solution is to change Preferences -> Toggle "Advanced" Global options -> Text based game emulator -> change to /usr/bin/konsole
Current blocker: tried (WineGE 8-12 + Sonic P06), the game cannot detect Steam Input. The same setup works when using flatpak Lutris.
Some plugins may be unable to run shell commands due to linked library error. This is observed in two plugins currently:
- decky-recorder: unable to run ffmpeg
ffmpeg: /tmp/_MEIMA8QQr/libssl.so.3: version `OPENSSL_3.2.0' not found (required by /lib64/libcurl.so.4) - decky-syncthing
/usr/bin/flatpak: /tmp/_MEIMA8QQr/libssl.so.3: version `OPENSSL_3.2.0' not found (required by /lib64/libcurl.so.4)
For decky-recorder, I manually grabed the actual commands in terminal, it would work. Further debugging showed that plugin processes have this env var injected:
LD_LIBRARY_PATH=/tmp/_MEIMA8QQr/
If I added it to my terminal session then I can get the same error.
It doesn't seem like decky-loader is injecting this var on purpose, but the main loader is packaged by PyInstaller, which would utilize this env var, according to their doc: https://pyinstaller.org/en/stable/runtime-information.html#ld-library-path-libpath-considerations
For now we will need to manually unset this env var in plugin scripts as workaround.
Need manual patches due to issue mentioned above. https://github.com/fsworld009/decky-recorder-fork/releases/tag/v0.0.1-bazzite-patch
More detailed report SDH-Stewardship/decky-recorder-fork#47 (comment)
Curently enabling recording would break screenshot. Observed the same with the new Steam Game Recording, reported to ValveSoftware/gamescope#1489
The main script is not python, cannot edit directly in bin, but we can change the main.py to launch the bin without this env var:
Update env passed in at https://github.com/theCapypara/steamdeck-decky-syncthing/blob/v0.1.0/main.py#L102 to
env={**dict(os.environ), **{'LD_LIBRARY_PATH': ''}}
Game mode related services
systemctl --user status gamescope-session-plus@steam
systemctl status return-to-gamemode
For testing if the bug is only presented in current build
systenctl --user edit gamescope-session-plus@steam
Add GAMESCOPE_BIN override
[Service]
Environment="GAMESCOPE_BIN=/home/deck/.local/bin/gamescope_sd"
then save and exit. An service override will be created.
Note: doesn't work with gamescope installed on distrobox
Ref: https://serverfault.com/questions/413397/how-to-set-environment-variable-in-systemd-service
Create a container that can run gamescope without root
Ref
distrobox create gamescope --image ghcr.io/ublue-os/fedora-distrobox:latest --init-hooks "install -o 1000 -g 1000 -d /tmp/.X11-unix-new; mount --bind /tmp/.X11-unix-new /tmp/.X11-unix"
dsitrobox enter gamescope
sudo dnf install gamescope-3.14.2-1.fc40.x86_64
distrobox-export -b /usr/bin/gamescope
exit
~/.local/bin/gamescope
However, cannot use this binary as the GAMESCOPE_BIN in gamescope-session, would result in
vulkan: selecting physical device 'AMD Radeon 780M (RADV GFX1103_R1)': queue family 1 (general queue family 0)
vulkan: physical device supports DRM format modifiers
wlserver: [backend/headless/backend.c:67] Creating headless backend
wlserver: [libseat] [libseat/backend/seatd.c:64] Could not connect to socket /run/seatd.sock: No such file or directory
wlserver: [libseat] [libseat/libseat.c:76] Backend 'seatd' failed to open seat, skipping
wlserver: [libseat] [libseat/libseat.c:76] Backend 'logind' failed to open seat, skipping
wlserver: [libseat] [libseat/libseat.c:79] No backend was able to open a seat
wlserver: [backend/session/session.c:83] Unable to create seat: Function not implemented
wlserver: [backend/session/session.c:248] Failed to load session backend
wlserver: Failed to create session
Failed to initialize Wayland session
Failed to create backend.
I assume this is because the process inside distrobox cannot see host init processes
https://www.tecmint.com/understanding-shared-libraries-in-linux/
Add a new file in /etc/ld.so.conf.d for new paths, then run sudo ldconfig to refresh cache
If not using game mode, make sure you go to settings -> compatibility to choose a proton version as default.
Otherwise, Steam will think it cannot run Windows games and delete game files in common folder and and you will need to redownload them.
ublue-os/bazzite#1914 (comment)
Example: downgrade ibus from 1.5.31 to 1.5.30
# Get an empty working folder
$ mkdir ibus-fix && cd ibus-fix
# Download packages
$ wget https://kojipkgs.fedoraproject.org/packages/ibus/1.5.30/6.fc41/x86_64/ibus-1.5.30-6.fc41.x86_64.rpm
$ wget https://kojipkgs.fedoraproject.org/packages/ibus/1.5.30/6.fc41/x86_64/ibus-gtk2-1.5.30-6.fc41.x86_64.rpm
$ wget https://kojipkgs.fedoraproject.org/packages/ibus/1.5.30/6.fc41/x86_64/ibus-gtk3-1.5.30-6.fc41.x86_64.rpm
$ wget https://kojipkgs.fedoraproject.org/packages/ibus/1.5.30/6.fc41/x86_64/ibus-gtk4-1.5.30-6.fc41.x86_64.rpm
$ wget https://kojipkgs.fedoraproject.org/packages/ibus/1.5.30/6.fc41/x86_64/ibus-libs-1.5.30-6.fc41.x86_64.rpm
$ wget https://kojipkgs.fedoraproject.org/packages/ibus/1.5.30/6.fc41/x86_64/ibus-panel-1.5.30-6.fc41.x86_64.rpm
$ wget https://kojipkgs.fedoraproject.org/packages/ibus/1.5.30/6.fc41/noarch/ibus-setup-1.5.30-6.fc41.noarch.rpm
# Perform downgrade
$ sudo rpm-ostree override replace * --remove ibus-xinit
# Reboot to apply changes
# Delete the `ibus-fix` folder if you want toUse official AppImage release.
First tried https://sourceforge.net/p/veracrypt/discussion/general/thread/71c9346768/ adding mount options as described (Settings -> Preferences -> Mount options)
uid=1000,gid=1000,umask=0022
(Use id command to get gid and uid). Doesn't work.
sudo ntfsfix /dev/mapper/veracrypt1
Then remount the partition.
Back to Windows, when mounting the drive, veracrypt warns disk error and prompt to run disk repair. Doing so seems to fix read/write on both Windows and Linux.
(Framework 13) https://docs.bazzite.gg/Installing_and_Managing_Software/Waydroid_Setup_Guide/
Document is outdated, now Waydroid defaults to Android 13 (Lineage 20)
# ujust setup-waydroid -> init
This might take a bit, please be patient
[17:51:33] Found directory /etc/waydroid-extra/images but missing system or vendor image, ignoring...
[17:51:34] Downloading https://sourceforge.net/projects/waydroid/files/images/system/lineage/waydroid_x86_64/lineage-20.0-20250726-VANILLA-waydroid_x86_64-system.zip/download
[Downloading] 830.73 MB/830.79 MB 38199.49 kbps(approx.)[17:51:56] Validating system image
[17:51:57] Extracting to /var/lib/waydroid/images
[17:52:01] Downloading https://sourceforge.net/projects/waydroid/files/images/vendor/waydroid_x86_64/lineage-20.0-20250726-MAINLINE-waydroid_x86_64-vendor.zip/download
[Downloading] 171.9 MB/171.96 MB 38620.67 kbps(approx.)[17:52:06] Validating vendor image
[17:52:06] Extracting to /var/lib/waydroid/images
Need to manually download and place images for Android 11 waydroid/waydroid#1662 (comment)
But Android 13 is better in general.
ujust setup-waydroid
Install gapps + libhoudini
Need to use libhoudini even on AMD GPU.
Game caps at 30fps, it's set by game, nothing can be done here.
Should work, but seems only start working after copy once inside Waydroid.
need to switch to dGPU, and cannot use waydroid-launcher properly (click doesn't work)
Need to reconfig GPU after any ujust setup-waydroid changes
- Volume too low -> change in Settings
- Start button triggers Google assistant -> Change default assistant app to None
- Install GBoard for CHT/JAP input (Shift+Space cycle throughs IMEs)
- Disable bg input? Seems break controller input in multi window mode https://docs.bazzite.gg/Installing_and_Managing_Software/Waydroid_Setup_Guide/#disable-inputs-to-waydroid-when-unfocused
(Optional) Multi window modedow https://docs.waydro.id/usage/install-on-desktops#launch-waydroid-in-multi-window-mode
Some apps like Line are displayed like a regular Linux win. Some games still run in fullscreen, need to workaround with scrcpy in this case, see below.
https://docs.waydro.id/faq/setting-up-a-shared-folder
On Android 11, all apps will have shortcuts automatically creeated in ~/.local/usr/applications, seems not the case
anymore in 13 images.
But we can still manually create with below template
waydroid.com.android.settings.desktop
[Desktop Entry]
Type=Application
Name=Settings
Exec=waydroid app launch com.android.settings
Icon=/home/fsworld009/.local/share/waydroid/data/icons/com.android.settings.png
Categories=X-WayDroid-App;
X-Purism-FormFactor=Workstation;Mobile;
Actions=app_settings;
[Desktop Action app_settings]
Name=App Settings
Exec=waydroid app intent android.settings.APPLICATION_DETAILS_SETTINGS package:com.android.settings
Icon=/home/fsworld009/.local/share/waydroid/data/icons/com.android.settings.png
com.android.settings is the app ID for Settings App. change it to the app you want to launch
Can also use waydroid app list to get all installed apps and their ID.
https://ivonblog.com/posts/waydroid-scrcpy/
Can workaround fullscreen games
Flatpak: guiscrcpy also works
To set custom resolution, use these scrcpy args:
--window-width 2560 --window-height 1440
If Waydroid ADB is not started: https://docs.waydro.id/faq/using-adb-with-waydroid
It seems that mouse only works in internal screen when running waydroid-launch
The only workaround I can find now is to manually start session waydroid session start, then use scrcpy to connect
It seems the Width and height flags used by waydroid-launcher doesn't really work.
We need to instead edit the waydroid prop directly
# permanent
sudo waydroid prop set persist.waydroid.width 1920
sudo waydroid prop set persist.waydroid.height 1080
# Temp
sudo waydroid shell wm size 1920x1080
Then launching scrcpy with the matched resolution would work.
https://www.reddit.com/r/Bazzite/comments/1orvi8f/cant_copy_from_linux_app_to_wine_game/
https://bugs.kde.org/show_bug.cgi?id=511063 Fixed in Plasma 6.5.2
Potential Workaround https://forums.eveonline.com/t/proton-on-wayland-broken-clipboard-paste-potential-fix-for-it/499995
Open a terminal and edit the systemd sleep configuration file with administrative privileges (using sudo or similar). bash sudo nano /etc/systemd/sleep.conf Locate the line containing #HibernateDelaySec=. Uncomment the line (remove the # at the beginning) and set the value to 20min (or 1200 seconds). The file section should look like this:
[Sleep]
# ... other settings
HibernateDelaySec=20min
# ... other settingsSave the file and exit the editor.
Restart the systemd logind service for the changes to take effect immediately without a full reboot. bash
sudo systemctl restart systemd-logind
Need distrobox root container
sudo dnf install apfs-fuse
sudo apfs-fuse -o uid=1000,gid=1000,allow_other /dev/sda1 /mnt/mac_drive
- Create the VeraCrypt volume without a filesystem
- Mount the volume
-
sudo mkfs.ntfs /dev/mapper/veracrypt1
For steam game, need to set DISPLAY in order to have Steam overlay enabled properly:
gamescope -W 1920 -H 1080 & DISPLAY=:1 %command%
Note the value of DISPLAY might change (based on how many monitors are in use?). It's better to run gamescope in terminal once to see the assigned display
> gamescope
...
[gamescope] [Info] wlserver: [xwayland/server.c:107] Starting Xwayland on :1
https://github.com/ewagner12/all-ways-egpu
- Guided setup
- lookup primary eGPU -> set to eGPU (y to confirm)
- lookup iGPU -> set phoenix to iGPU (y to confirm)
- extra options: y for method 1 (for enabling igpu afterboot), 2, and 3
- Add polkat rule for fallback to igpu https://github.com/ewagner12/all-ways-egpu?tab=readme-ov-file#extra-steps