A grid can not only contain selectable rows with text but also other features like buttons. <br>
For example, in one part of the interface there could just be a list of ROMs but in another there could be various button elements as in the scraping menu.
Enabling the up and down buttons to wrap around would therefore not work consistently as it would sometimes jump to the last row of the grid or to a button at random depending on the layout of the grid.
Every time it would require a different number of button presses depending on the grid layout.
This type of contextual navigation feels very weird in practice, especially when you must press the up button twice to find the underlying cause of a list in some lists but more times in others depending on the button layout.
Go to `ES-DE Menu` -> `ES-DE Configurations` -> `UI Settings` -> `Theme Set` to select the theme you want to use.
### How do I add additional themes?
**From the Theme Downloader**
Go into `ES-DE Menu` -> `ES-DE Configurations` -> `UI Settings` -> `Theme Downloader` from there you can download a wide array of themes.
**From the Internet**
If you find a theme on the internet you would like to use that is not in the `Theme Downloader`.
**NOTE:** Before you begin always check if the theme is compatible with ES-DE.
1. Download the theme.
2. Extract it if it is compressed (.zip or .7z).
3. Put the extracted folder into `retrodeck/ES-DE/themes/`.
4. The end result should look like `retrodeck/ES-DE/themes/<downloaded theme folder>`.
5. Launch RetroDECK and select the theme as normal.
### "Why does the theme I am using not work?" or "Why does the layout look broken?" (black screen with blue text)?
- Please make sure you are specifically using a theme that is compatible with [ES-DE](https://www.es-de.org).
- If you are trying to use a theme that was built for Batocera it will not be compatible.
- ES-DE uses a unique theme engine so themes are not directly portable from Batocera.
See the ES-DE's Guide 📘 for more details.
### Why does the theme layout look squished?
- The Steam Deck has a screen aspect ratio of `16:10` and most themes that you will find are built for an aspect ratio of `16:9`. Depending on the theme's design this may cause the layout to appear squished when using it on the Steam Deck's display.
- All the included themes are built for 16:10 aspect ratio so you should not see this issue with any of them; however, if you are downloading a theme from another source there is a chance this can occur for you.
- There are 2 ways to fix this if it does occur: (1) see if a specific version was built for `16:10` aspect ratio and use that instead or (2) edit the theme to make it compatible with that aspect ratio.
- You will need to register an account on [ScreenScraper.fr](https://www.screenscraper.fr/) to scrape (support them on Patreon for faster downloads, more scrapes per day and priority scraping).
- Login to your Screenscraper.fr account inside of the ES-DE interface in RetroDECK under `ES-DE Menu` -> `Scraping` -> `Account Settings`.
**On scraping:**
- Choose what content you want to scrape under `ES-DE Menu` -> `Scraping` -> `Content Settings`. (remember that each content you choose could take up several mb of data per game).
- Do an initial scrape of all the games you want to scrape.
- If some games are missed do a more narrow scraping by enabling `Scraper -> Other Settings -> Interactive Mode -> On`& Scraper -> `Other Settings -> Auto-Accept Single Game Matches -> On` and choose to scrape by games missing metadata. This will allow you to select each game from a list and also tweak the searches of the missing games.
- In some cases you need to remove certain aspects of the name like if a rom comes both with a Japanese name and English name, you could try to remove one of the names to find a better result.
- [Instructions: Manually copying game media files](https://gitlab.com/es-de/emulationstation-de/-/blob/master/USERGUIDE.md?ref_type=heads#manually-copying-game-media-files)
- [Spreadsheet: Media Types in ES-DE](https://docs.google.com/spreadsheets/d/18VJAL44aNxsFOd4pVAONmdWwa7srCSzr2Z2SJEiNKnE/edit?gid=1812680930#gid=1812680930)
If you already have a library of game media (images, videos and PDF manuals) you can manually copy these files into RetroDECK (ES-DE).
**Requirements & Tips:**
- Remember that on Linux filenames are case sensitive.
- The file extensions must be in lower case in ES-DE (`.png` instead of `.PNG` / `.Png`).
- The media files names must correspond exactly to the game files name.
- For directories interpreted as files games (like ScummVM) you will need to add the folder file extension to the media file name example: `dig.scummvm.png`.
- Supported image file extensions are: `.jpg` and `.png`.
- Supported document file extensions are: `.pdf`.
- Supported video file extensions are: `.avi` , `.mkv` , `.mov` , `.mp4` and `.wmv`.
### I got some weird error message about quota after scraping?
The error message mentions something about quota. You have a quota limit on how much you can scrape each day from [Screenscraper](https://www.screenscraper.fr/) where each item you scrape counts as 1 quota of the daily total.
You can pay them to get a bit more daily quota and show your support or just wait 24 hours.
### The Server or Service is down?
The service is down, check the [Screenscraper Website](https://www.screenscraper.fr/) when they get back up.
### I have donated how do I get faster scraping?
You have to associate your Screenscraper Account with your Pateron Account.
Check [Screenscraper Pateron](https://www.patreon.com/screenscraper) for instructions.
### The scraping is very slow...
[Screenscraper](https://www.screenscraper.fr/) offers different types of donations that can increase your speed with extra threads.
## ES-DE User Guide Links
Here follows various quick bookmarks to specific section of the User Guide that is good to read and always updated with the lastest information.
### Navigation and UI Settings
[ES-DE: General Navigation](https://gitlab.com/es-de/emulationstation-de/-/blob/master/USERGUIDE.md#general-navigation)
