Wiki/wiki-rtd/docs/wiki_bugs/known-issues.md

Known issues

What follows is a list of known issues. For a list of reported bugs please check here on github: RetroDECK issues

Emulator / Engine Issues

PPSSPP

Retroachievements you can login / logout / enable hardcore mode normally from the emulators interface. It is right now not configurable in the Configurator (as it works a bit differently than the other emulators), we hope to have a solution for it later.

RetroArch

Borders are in some few cases disappearing in the latest RetroArch version. A workaround is to reset RetroArch from the Configurator

RetroArch: Gambatte

Quitting the core with the Quit radial function makes the core swap the palette while playing GB.

OpenBOR

The standard implementation RetroDECK uses does not work and is currently not compatible. We are going to redesign it in an future update.

Ryujinx - Warning

Cannot handle the symlinks correctly (it never could do it perfect before) in the new updates (this affects all of Linux). Thus our saves, firmware (nand) and keys folder are currently symlinked in retrodeck folders do not work.

The RetroDECK Team is working with the Ryujinx Team to fix this permanently in Ryujinx and hopefully got a solution soon.

The consequences is that: Ryujinx don't recognize any keys and firmware as it cannot resolve the symlink, so the games are not starting.

A temporary but very dangerous workaround we really don't recommend doing is to manually replace the symlinks with actual folders. But you must backup them as the next version or if you reset Ryujinx via the Configurator will remove the real folders and replace them with symlinks again, and in this case will erase all the saves, keys and firmware!

The manual work around should be to replace:

- Saves folder `bis` with `retrodeck/saves/switch/ryujinx/nand`
- The `sdcard` with `retrodeck/saves/switch/ryujinx/sdcard`
- The "firmware" folder `system` with `retrodeck/bios/switchch/keys`
- The actual firmware folder `bis/system/Contents/` with `retrodeck/bios/switch/firmware`

However, keep in mind that RetroDECK Team will not assume any responsibility for data loss and we recommend our users to wait until Ryujinx have fixed it on their side.

External Controller issues

Known Issues: External Controllers - Steam Deck

• Sometimes the emulators / engines gets confused on what controller is player 1 and takes the docked Steam Deck as player 1 and not the external controller. You can solve this by going into the Reorder Controllers interface in Steam and try switching between Player 1 or Player 2.

Known Issues: External Controllers - Linux Desktop

Linux Desktop via Steam Input is complex. There are a lot of variables and the RetroDECK Team don't have the ability to test for all of them:

• What kind of packages are installed.
• What kind of drivers you have installed.
• What distro you are using.
• What desktop you are using.
• If you are running X11 or Wayland.
• If you have a Steam Deck based Distro with Valves "Game Mode".

We are trying to keep track of all the issues here and have reported several to Valve:

https://github.com/XargonWan/RetroDECK/issues/716

Bug: Destop Profiles take preset over Game Profile

Since the one of the recent Steam Client updates, there is a bug that causes Steam to take the Desktop Profile instead of the Game Profile. Sometimes it even takes both inputs and sends double inputs for every action.

Possible solutions by our users and team members:

• Try to turn off the RetroDECK's Steam Input: Select RetroDECK in Steam -> Properties -> Controller -> Disable Steam Input. Then go to Steam -> Settings -> Controller -> Desktop Profile and Apply the RetroDECK Layout under Templates for the controller you are using.
• Going into big picture and launching RetroDECK from there.
• Starting big picture, exiting big picture and then launching RetroDECK from the Desktop Client.

Bug: Missing Radials in certain systems

The radial menus on certain Linux Systems are hidden behind the game window or the Steam overlay (they still work and you can navigate them).

We thought about doing a temporary none radial profiles for each controller to get around this bug.
But later changed our minds as we would have even more input configs to maintain, with a risk they become permanent.

External Controller Issues - GZDOOM

GZDOOM have some kind of conflict with Steam Input in when more then one controller that causes input looping in menus. Make sure that the controller you are using is set as Player 1 else use Reorder Controllers interface in Steam to make it Player 1.

We are still investigation the cause of it, if you know of a solution please contact the RetroDECK Team.

Hotkey Issues

Not all Emulators has hotkey support; some have partial support; some has none and some has a majority implemented

The plan is to map as much as we can into the RetroDECK Hotkey System below. We are also patching in Emulator Hotkeys with the RetroDECK Framework (if possible) to be compatible with the system. If an emulator later adds better hotkey support, we plan to map it towards the same functions for a unified experience across as many emulators as possible.

• RPCS3 hotkeys/shortcuts do not work and they are a new experimental feature. To exit you must shut down RPCS3 from the Switch Window inside the Steam Deck interface or quit the application on Desktop.
• CEMU has almost no hotkey support.
• XEMU has no hotkey support.

External Controller Issues - Steam Deck

• Sometimes the emulators / engines gets confused on what controller is player 1 and takes the docked Steam Deck as player 1 and not the external contrller. You can solve this by going into the Reorder Controllers interface in Steam and try switching between Player 1 or Player 2.

External Controller Issues - Linux Desktop

Linux Desktop via Steam Input is complex. There are a lot of variables and the RetroDECK Team don't have the ability to test for all of them:

• What kind of packages are installed.
• What kind of drivers you have installed.
• What distro you are using.
• What desktop you are using.
• If you are running X11 or Wayland.
• If you have a Steam Deck based Distro with Valves "Game Mode".

We are trying to keep track of all the issues here and have reported several to Valve:

https://github.com/XargonWan/RetroDECK/issues/716

Bug: Destop Profiles take preset over Game Profile

Since the one of the recent Steam Client updates, there is a bug that causes Steam to take the Desktop Profile instead of the Game Profile. Sometimes it even takes both inputs and sends double inputs for every action.

Possible solutions by our users and team members:

• Try and use the RetroDECK Profile as the Desktop Profile and turning off the Game Profile.
• Going into big picture and launching RetroDECK from there.
• Starting big picture, exiting big picture and then launching RetroDECK from the Desktop Client.

Bug: Missing Radials in certain systems

The radial menus on certain Linux Systems are hidden behind the game window or the Steam overlay (they still work and you can navigate them).

We thought about doing a temporary none radial profiles for each controller to get around this bug.
But later changed our minds as we would have even more input configs to maintain, with a risk they become permanent.

External Controller Issues - GZDOOM

GZDOOM have some kind of conflict with Steam Input in when more then one controller that causes input looping in menus. Make sure that the controller you are using is set as Player 1 else use Reorder Controllers interface in Steam to make it Player 1.

We are still investigation the cause of it, if you know of a solution please contact the RetroDECK Team.