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

# How-to: Report a Problem and Known Issues

<img src="../../wiki_icons/pixelitos/edit-delete.png" width="75">

## Before you report a Problem

Before you report something, read the following.

### Do not! Report Directly to Third-Party System Developers 🛑  

Report any component: `emulator` , `engine` or `system` related issues in RetroDECK directly to the developers of those systems.

**Example:**

If you find odd behavior in an emulator, don't go to the emulator's socials or support channels to report it. Instead, use the RetroDECK support channels.

If the RetroDECK Team believes the issue is caused by a built-in component, they, and not the user, will then report and discuss it with the developers of that system.

### Is the Problem Already Reported?

- Check [RetroDECK - Github Issues](https://github.com/RetroDECK/RetroDECK/issues) for reported problems.
- Check if it is a known issue in the emulator/engine/system you are using on their bug reporting channels and wait until RetroDECK updates the componenet in an upcomming update. 
- Check the The `FAQ ❔` section of this wiki.

## How-to: Reporting an Problem

- RetroDECK's main issue tracker is on [RetroDECK - Github Issues](https://github.com/RetroDECK/RetroDECK/issues). 
- We try to keep it clean and only have “real” issues. 
- General guidance or help is available on the socials, wiki, and the rest of the RetroDECK community.


### General rule of thumb is:

- If you want to discuss something, do not understand, want to ask a question, or need general guidance, start with the 🤝-community-support channel on Discord or Matrix. The community or sometimes the RetroDECK Team will answer here.

- If you think it is something bigger or are semi-certain about the issue but lack technical knowledge and want a deeper discussion, use the 🆘-support channel on Discord. The RetroDECK Team mostly discusses things here, but certain community members might join.

- If you know what the issue is and maybe even have found a solution, submit it directly on GitHub.

The RetroDECK Team tries to spread any knowledge, tips, or clarifications from Discord or other RetroDECK communities to the Wiki via separate articles or updating the FAQ. 

### Discord & Matrix

Discord and Matrix are used for more guidance-type issues and community support.

[Discord](https://discord.gg/WDc5C9YWMx)

[Matrix](https://matrix.to/#/#retrodeck:matrix.org)

### RetroDECK - Github Issues

[RetroDECK - Github Issues](https://github.com/RetroDECK/RetroDECK/issues)
GitHub is RetroDECK's main issue tracker where development and known issues are submitted by the community and the RetroDECK team from reports on Discord or other community channels.

## Known issues - Systems

What follows is a list of known issues.

### PPSSPP

**Issue:** Retroachievements login/logout and hardcore mode are not configurable in the Configurator.
**Solution:** Currently, it can be managed from the emulator's interface.

### RetroArch

**RetroArch: Gambatte**

**Issue:** Quitting the core with the `Quit` radial function makes the core swap the palette while playing GB.

### Ryujinx

**Issue:** Cannot handle symlinks correctly, affecting saves, firmware, and keys.
**Solution:** TBA

### GZDOOM

**Issue:** Conflict with Steam Input causing input looping in menus.
**Solution:** Ensure the controller is set as Player 1 or use the Reorder Controllers interface in Steam.

### Steam Sync

**Issue:** Sometimes fails to associate controller templates to Steam entries.
**Solution:** Users must set it manually if needed.

### ES-DE

**Issue:** ES-DE Configurations submenu doesn't support translations yet.
**Solution:**  Translations will be implemented in the future.

## Known issues - Steam Input

### RetroDECK Hotkeys

**Issue:** Not all emulators have hotkey support; some have partial support, some have none, and some have a majority implemented.
**Solution:** The plan is to map as much as possible into the RetroDECK Hotkey System and patch in Emulator Hotkeys with the RetroDECK Framework to be compatible with the system as they get the functionality .

- `CEMU` has almost no hotkey support.
- `XEMU` has no hotkey support.
- `Vita3k` has no hotkey support.
- `Ryujinx` has almost no hotkey support.

### Missing Radials in Linux Desktop

**Issue:** Radial menus are hidden behind the game window or Steam overlay on certain Linux systems.
**Solution:** Has been reported to Valve by RetroDECK Team.

### Steam Input: - Who is Player 1?

**Issue:** Emulators/engines/systems get confused about which controller is player 1, sometimes taking the docked Steam Deck as player 1 instead of the external controller.
**Solution:** Use the Reorder Controllers interface in Steam to switch between Player 1 and Player 2.

## Known issues - Linux Desktop

### KDE Discover

**Issue:** Shows the wrong version when updating Flatpak applications due to a caching error.
**Solution:**  Force a cache update by going to `Discover` -> `Settings` -> and unchecking and checking Flathub again.