diff --git a/README.md b/README.md index ae5124820..c02d15c76 100644 --- a/README.md +++ b/README.md @@ -39,6 +39,8 @@ A comprehensive theme set, **rbsimple-DE** (which is based on Recalbox Multi fro | macOS DMG installer | macOS 10.11 "El Capitan" to 11 "Big Sur" | x64 (x86) | 1.0.0-beta1 | Available soon | | Windows installer | Windows 10 and 8.1 | x64 (x86) | 1.0.0-beta1 | Available soon | +Please refer to [RELEASES.md](RELEASES.md) for more information about this release, including known issues. + For some of the rarer operating systems listed at the top you need to build ES-DE from source. The plan is to have ES-DE available in the software repositories of all supported operating systems (where this is applicable), so in the long term building from source should not be required. **Note:** The software is currently in beta status which means it's also beta quality and may contain bugs. The application should still hopefully be good enough for every day use and bugs will be fixed continuously. diff --git a/RELEASES.md b/RELEASES.md index ba729b3c9..6668e761e 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -122,3 +122,10 @@ Many bugs have been fixed, and numerous features that were only partially implem * Non-transparent favorite icons were not rendered correctly * The SliderComponent knob position was set incorrectly if the minimum value was not zero * Lots and lots of additional small bugs and inconsistencies fixed + +### Known issues + +* The input configuration can be a bit glitchy on some devices, most notably the setup of trigger buttons for Xbox and PlayStation controllers. Once configured everything should work fine though. This configuration issue will hopefully be resolved in ES-DE v1.1 with the move to the SDL2 GameController API. +* Some artifacts can be present with the gaussian blur shader, and screen tearing can be seen when using the slide transitions with certain graphics drivers and resolutions. Both of these issues only affect the upper part of the screen. The second issue is apparently more prevalent when running ES-DE at a lower resolution on 4K displays by using the --resolution command line option. These problems will hopefully be resolved in ES-DE v1.2 when moving to the GLM library. +* The launching of games can freeze ES-DE on some Windows installations. It probably only occurs on Windows 8.1 and older but that's not confirmed. The setting 'Run in background (while game is launched)' can be enabled to get around this problem, but this causes some other issues so it should only be used as a last resort. It's unclear if this problem can or will be resolved. If it's confirmed to only affect older Windows versions, then it's probably not worthwhile fixing it. +* Scraping using ScreenScraper could lead to errors when exceeding the allowed requests per minute. This will cause a popup window to be displayed in ES-DE with the option available to retry the scraping for the current game (you should first wait a minute or so though or the error will immediately reoccur). This is not really a fault in the application per-se but rather a restriction of ScreenScraper. A request per minute limiter is planned for ES-DE v1.4, which should help with avoiding this problem. \ No newline at end of file diff --git a/USERGUIDE.md b/USERGUIDE.md index c07967fd2..91cd4bc39 100644 --- a/USERGUIDE.md +++ b/USERGUIDE.md @@ -966,6 +966,14 @@ This setting defines the directory for the game media, i.e. game images and vide This setting defines the path for which to search for emulator cores. This is used by the variable %COREPATH% which can be included in the systems configuration file es_systems.cfg. By default this variable and corresponding setting is only used on Unix. For macOS and Windows the %COREPATH% variable is not included in the es_systems.cfg template and the default core path value is therefore set to blank. If required for special setups it can be used for these operating systems, but the primary use is on Unix where the core path may vary depending on the operating system, how the emulator was packaged etc. For example the default RetroArch core directory is ~/.config/retroarch/cores if compiled from source code but if installed as a Snap package or as part of the OS repository the cores could be stored elsewhere. The setting is primarily intended for RetroArch but it can be used for any emulator that utilizes discrete emulator cores. When attempting to launch a game, the core for the game system will be searched in each of the defined directories until the first match occurs. Multiple directories can be defined by separating them using colons on Unix and macOS and by semicolons on Windows. Please see [INSTALL.md](INSTALL.md#es_systemscfg) for more information about this. +**Hide taskbar (requires restart)** _(Windows only)_ + +With this setting enabled, the taskbar will be hidden when launching ES-DE, and it will be restored when the application exits. This can make for a more seamless experience as the taskbar could otherwise flash by briefly when launching games and when returning from games. It could potentially cause some issues on some Windows installations though, so the option is disabled by default. + +**Run in background (while game is launched)** _(Windows only)_ + +This is really a last-resort setting if ES-DE freezes when launching games. This issue seems to only occur on Windows 8.1 and older but that's not fully confirmed. ES-DE will behave a bit strange with this option enabled so keep it disabled unless you absolutely need it. + **Per game launch command override** If enabled, you can override the launch command defined in es_systems.cfg on a per-game basis. It's only recommended to disable this option for testing purposes, such as when a game won't start and you're unsure if it's your custom launch command that causes the problem.