Megred ES-DE stable-3.1

Author: XargonWan

ANDROID-DEV.md

@@ -1,16 +1,16 @@
 # ES-DE Frontend - Changelog
 
-## Version 3.1.1 (in development)
+## Version 3.1.1 / 3.1.1-39
 
-**Release date:** TBD
+**Release date:** 2024-12-13
 
 ### Release overview
 
-This release adds support for four more languages, reduces the memory footprint under some circumstances and enables a few more emulators.
+This release adds support for four more languages, reduces the memory footprint under some circumstances and enables a number of new emulators.
 
 On Android the default audio driver has been changed from AAudio to OpenSL ES which should decrease audio latency on many devices. There is however a new menu entry in the Sound settings menu that makes it possible to easily revert to AAudio in case of issues with the OpenSL ES driver. Also for Android there is now experimental support for running ES-DE in multi-window mode on tablets and other devices that support this.
 
-In addition to the above there are a number of bug fixes and other minor improvements.
+In addition to the above there are a number of bug fixes and other improvements.
 
 ### Detailed list of changes
 
@@ -21,28 +21,39 @@ In addition to the above there are a number of bug fixes and other minor improve
 * Decreased the memory footprint under some circumstances by completely freeing up video player resources after finishing view transitions
 * The Git index stat cache is now refreshed for all themes when starting the theme downloader (this speeds up the inventory under some circumstances)
 * Added Mandarine standalone as an alternative emulator for the n3ds system
+* Added DREAMM standalone as an alternative emulator for the dos, pc and scummvm systems on Linux, macOS and Windows
+* Added Kronos standalone as an alternative emulator for the saturn and saturnjp systems on Linux and Windows
 * (Android) Changed the default audio driver from AAudio to OpenSL ES
 * (Android) Added an audio driver menu option to the Sound settings menu
 * (Android) Added experimental support for running in multi-window mode
 * (Android) Directories for corrupt themes are now automatically removed when the theme downloader is started
 * (Android) Added experimental support for the Nintendo Wii U (wiiu) game system
+* (Android) Added SWF Player standalone as an alternative emulator for the flash system
+* (Android) Added Infinity standalone as an alternative emulator for the pico8 system
+* (Android) Added Virtual Virtual Boy standalone as an alternative emulator for the virtualboy system
 * (Android) Changed Flycast standalone to use %ROMSAF% instead of %ROM% as the latter caused game launching to fail on some devices
 * (Android) Added support for launching individual games directly with EKA2L1 for the ngage system
+* (Android) Removed the FinalBurn Neo RetroArch core as an alternative emulator for the neogeocd and neogeocdjp systems as it didn't work correctly
 * (Android) Adjusted the layout for the onboarding configurator to look better on screens with wider aspect ratios
 * (Android) Added exception handling to the onboarding configurator for broken devices where the SAF directory picker is missing
 * (Android) The storage permission now only needs to be granted once in the onboarding configurator as indicated with an "Already granted" button
 * (Android) Added a temporary workaround to avoid crashes on non-character keyboard input when editing text (caused by a bug in the SDL library)
 * (Android) Updated a number of Java and Kotlin dependencies to the latest stable versions
 * (Android) Removed the built-in application update check for the Samsung Galaxy Store and Huawei AppGallery builds
 * (Linux) Added support for the AppImage release of melonDS
+* (macOS) Added support for the Sony PlayStation Vita (psvita) game system
+* (macOS) Added the %RUNINBACKGROUND% variable for RPCS3 to work around an emulator issue where ES-DE would directly resume on game launch
+* (Windows) Added FinalBurn Neo standalone as an alternative emulator for the neogeocd and neogeocdjp systems
 * (Windows) Added Yaba Sanshiro 2 standalone as an alternative emulator for the saturn and saturnjp systems
 * (Windows) Added BeebEm standalone as an alternative emulator for the bbcmicro system
 * (Windows) Added a find rule for the SSE2 build of DuckStation
 * Added the -f flag for fullscreen mode for melonDS standalone on Linux, macOS and Windows
+* Various translation updates for multiple languages
 * Added support to the theme downloader for detecting and handling theme repository URL changes
 * Added a "textBackgroundCornerRadius" property to the carousel element
 * Added a "textBackgroundCornerRadius" property to the grid element
 * Made the "backgroundCornerRadius" and "selectorCornerRadius" properties for the grid element apply also to colored rectangles
+* Changed an snprintf call in MathUtil as it could cause false positives for buffer overflow checks when building with GCC fortification
 * (modern-es-de) Replaced some legacy carousel icons
 * Added the Nanum Square Neo Korean font
 * Updated SDL to 2.30.9 on Android, Windows, macOS and the Linux AppImage builds
@@ -57,8 +68,10 @@ In addition to the above there are a number of bug fixes and other minor improve
 * (Android) Audio was not working correctly on some Android 15 devices (fixed by updating SDL to 2.30.9)
 * (Android) Switching from ES-DE to another app and back again while the "no ROMs" dialog was shown crashed the application
 * (Android) Switching from ES-DE to the home app and back again while the onboarding configurator was running crashed the application
+* (Android) On some devices, disabling the "Blur background when menu is open" option led to rendering issues
 * (Windows) The video and slideshow screensavers didn't work if a custom game media directory had been configured
 * There was a regression where filesystem case-sensitivity was not considered when looking for media files for the screensaver
+* Some metadata values were sometimes not saved by the single-game scraper if overwriting was disabled and the language was not set to English
 * Invalid popup notifications were sometimes shown after a download error message had been displayed in the theme downloader
 * Attempting to view media for a game that had no downloaded media paused the playback of all static theme videos
 * Pasting text into a text edit field would make the cursor jump to an incorrect position

ANDROID.md

@@ -19,7 +19,7 @@ endif()
 project(es-de)
 
 # Application version, update this when making a new release.
-set(ES_VERSION 3.1.1-alpha)
+set(ES_VERSION 3.1.1)
 
 # Set this to ON to show verbose compiler output (e.g. compiler flags, include directories etc.)
 set(CMAKE_VERBOSE_MAKEFILE OFF CACHE BOOL "Show verbose compiler output" FORCE)

CHANGELOG.md

@@ -24,7 +24,7 @@ You only need to buy the Patreon release once, and then you can use it on all yo
 
 ## ES-DE doesn't work on my device, can I get a refund?
 
-Although the overwhelming majority of people have successfully got ES-DE to run on their devices (assuming they are fulfilling the basic requirements of 64-bit Android 10 or later) there are some devices that have been problematic. Unfortunately Android is not really a standardized operating system and hardware manufacturers are sometimes applying custom patches and such which may prevent ES-DE from working correctly. We will refund anyone that bought ES-DE on Patreon within one month from the purchase date if they are unable to get ES-DE to run on their device. Just send a DM on Patreon and we will issue a refund as soon as possible. We are however unfortunately not able to refund purchases on the Samsung Galaxy Store and Huawei AppGallery. But make sure to read the next question below as your device may be compatible after all.
+Although the overwhelming majority of people have successfully got ES-DE to run on their devices (assuming they are fulfilling the basic requirements of 64-bit Android 10 or later) there are some devices that have been problematic. Unfortunately Android is not really a standardized operating system and hardware manufacturers are sometimes applying custom patches and such which may prevent ES-DE from working correctly. We will refund anyone that bought ES-DE on Patreon within one month from the purchase date if they are unable to get ES-DE to run on their device. Just send a DM on Patreon and we will issue a refund as soon as possible. We are unfortunately not able to directly refund purchases on the Samsung Galaxy Store and Huawei AppGallery, but you may still be able to get a refund by contacting Samsung or Huawei. Anyway, make sure to read the next question below as your device may be compatible after all.
 
 ## ES-DE hangs at the onboarding configurator, is the app not compatible with my device?
 
@@ -36,7 +36,7 @@ There seems to be an issue with Gmail (both web version and app) that a few peop
 
 ## Will I lose any settings or data when upgrading to a new release?
 
-No, you will not lose any settings or data when you upgrade. Just download the latest version and sideload it on your device to apply the update.
+No, you will not lose any settings or data when you upgrade, everything will stay intact.
 
 ## Why do I get a "There was a problem parsing the package" error when I attempt to install ES-DE?
 

CMakeLists.txt

@@ -1868,7 +1868,7 @@ Here's an example es_systems.xml file for Android:
         <path>%ROMPATH%/psx</path>
         <extension>.bin .BIN .cbn .CBN .ccd .CCD .chd .CHD .cue .CUE .ecm .ECM .exe .EXE .img .IMG .iso .ISO .m3u .M3U .mdf .MDF .mds .MDS .minipsf .MINIPSF .pbp .PBP .psexe .PSEXE .psf .PSF .toc .TOC .z .Z .znx .ZNX .7z .7Z .zip .ZIP</extension>
         <command label="Beetle PSX">%EMULATOR_RETROARCH% %EXTRA_CONFIGFILE%=/storage/emulated/0/Android/data/%ANDROIDPACKAGE%/files/retroarch.cfg %EXTRA_LIBRETRO%=mednafen_psx_libretro_android.so %EXTRA_ROM%=%ROM%</command>
-        <command label="DuckStation (Standalone)">%EMULATOR_DUCKSTATION% %EXTRABOOL_resumeState%=false %EXTRA_bootPath%=%ROMSAF%</command>
+        <command label="DuckStation (Standalone)">%EMULATOR_DUCKSTATION% %ACTIVITY_CLEAR_TASK% %ACTIVITY_CLEAR_TOP% %EXTRABOOL_resumeState%=false %EXTRA_bootPath%=%ROMSAF%</command>
         <platform>psx</platform>
         <theme>psx</theme>
     </system>

FAQ-ANDROID.md

@@ -1873,7 +1873,7 @@ Here's an example es_systems.xml file for Android:
         <path>%ROMPATH%/psx</path>
         <extension>.bin .BIN .cbn .CBN .ccd .CCD .chd .CHD .cue .CUE .ecm .ECM .exe .EXE .img .IMG .iso .ISO .m3u .M3U .mdf .MDF .mds .MDS .minipsf .MINIPSF .pbp .PBP .psexe .PSEXE .psf .PSF .toc .TOC .z .Z .znx .ZNX .7z .7Z .zip .ZIP</extension>
         <command label="Beetle PSX">%EMULATOR_RETROARCH% %EXTRA_CONFIGFILE%=/storage/emulated/0/Android/data/%ANDROIDPACKAGE%/files/retroarch.cfg %EXTRA_LIBRETRO%=mednafen_psx_libretro_android.so %EXTRA_ROM%=%ROM%</command>
-        <command label="DuckStation (Standalone)">%EMULATOR_DUCKSTATION% %EXTRABOOL_resumeState%=false %EXTRA_bootPath%=%ROMSAF%</command>
+        <command label="DuckStation (Standalone)">%EMULATOR_DUCKSTATION% %ACTIVITY_CLEAR_TASK% %ACTIVITY_CLEAR_TOP% %EXTRABOOL_resumeState%=false %EXTRA_bootPath%=%ROMSAF%</command>
         <platform>psx</platform>
         <theme>psx</theme>
     </system>

INSTALL-DEV.md

@@ -5,6 +5,7 @@ ES-DE is developed using an agile methodology so which features to include per r
 A more detailed breakdown can be found on the [Kanban](https://gitlab.com/es-de/emulationstation-de/-/boards) board, and for previous releases the [Changelog](CHANGELOG.md) contains all relevant details.
 
 **General functionality**
+
 * RetroAchievements.org integration
 * "Time played" counter per game, similar to how it works in Steam
 * Bulk metadata editor
@@ -14,15 +15,16 @@ A more detailed breakdown can be found on the [Kanban](https://gitlab.com/es-de/
 
 **User interface**
 
-* Menu reorganization, possibly adding basic/advanced modes
 * Simple file browsing component
 
 **Theme engine**
+
 * Composite element support for enabling advanced and finely controlled layouts
 * Element animation support (storyboards)
 * Scrollbar component for the system and gamelist views
 
 **Scraper**
+
 * Support for additional scraper services
 
 **Infrastructure**
@@ -33,4 +35,4 @@ A more detailed breakdown can be found on the [Kanban](https://gitlab.com/es-de/
 * Proper audio mixer
 * Improved multi-threading
 * Reduced amount of gamelist reloading to retain cached textures and improve overall performance
-* Replacement for the abandoned FreeImage library
+* Replacement for the FreeImage library

INSTALL.md

@@ -755,16 +755,20 @@ The following languages are supported:
 | :------------ | :----------------------- | :----------------------- |
 | en_US         | English (United States)  | English (United States)  |
 | en_GB         | English (United Kingdom) | English (United Kingdom) |
+| ca_ES         | Catalan                  | Català                   |
+| de_DE         | German                   | Deutsch                  |
 | es_ES         | Spanish (Spain)          | Español (España)         |
 | fr_FR         | French                   | Français                 |
 | it_IT         | Italian                  | Italiano                 |
+| nl_NL         | Dutch                    | Nederlands               |
 | pl_PL         | Polish                   | Polski                   |
 | pt_BR         | Portuguese (Brazil)      | Português (Brasil)       |
 | ro_RO         | Romanian                 | Română                   |
 | ru_RU         | Russian                  | Русский                  |
 | sv_SE         | Swedish                  | Svenska                  |
-| ja_JP         | Japanese                 | 日本語                    |
-| zh_CN         | Simplified Chinese       | 简体中文                  |
+| ja_JP         | Japanese                 | 日本語                   |
+| ko_KR         | Korean                   | 한국어                   |
+| zh_CN         | Simplified Chinese       | 简体中文                 |
 
 Note that the native name is what is shown inside the _UI Settings_ menu for the _Theme Language_ and _Application Language_ settings.
 
@@ -1895,6 +1899,11 @@ Properties:
     - This property makes it possible to size the text relative to the overall item size. If using this and also defining a text background color using `textBackgroundColor` or `textSelectedBackgroundColor` then this color will still fill the entire item size.
     - Minimum value is `0.2` and maximum value is `1`
     - Default is `1`
+* `textBackgroundCornerRadius` - type: FLOAT
+    - Setting this property higher than zero applies rounded corners to the text background, assuming it has a color set. The radius is a percentage of the screen width. Note that the maximum allowed value is quite arbitrary as the renderer will in practice limit the maximum roundness so it can never go beyond half the text background height.
+    - Minimum value is `0` and maximum value is `0.5`
+    - Default is `0` (corners are not rounded)
+    - This property can only be used if `textBackgroundColor` has a value defined.
 * `textColor` - type: COLOR
     - Default is `000000FF`
 * `textBackgroundColor` - type: COLOR
@@ -2101,7 +2110,7 @@ Properties:
     - Minimum value is `0.2` and maximum value is `1`
     - Default is `1`
 * `backgroundCornerRadius` - type: FLOAT
-    - Setting this property higher than zero applies rounded corners to the image defined by `backgroundImage`. The radius is a percentage of the screen width and not directly related to the image size. This makes it possible to apply identically sized corners regardless of image dimensions. The size is calculated internally with `itemScale` and `backgroundRelativeScale` set to `1`. Note that the maximum allowed value is quite arbitrary as the renderer will in practice limit the maximum roundness so it can never go beyond half the width or height. It means that setting this property sufficiently high will turn a perfectly square image into a perfectly round one.
+    - Setting this property higher than zero applies rounded corners to the image defined by `backgroundImage`, or to the colored rectangle if `backgroundColor` has been defined without using a background image. The radius is a percentage of the screen width and not directly related to the background size. This makes it possible to apply identically sized corners regardless of image dimensions. The size is calculated internally with `itemScale` and `backgroundRelativeScale` set to `1`. Note that the maximum allowed value is quite arbitrary as the renderer will in practice limit the maximum roundness so it can never go beyond half the width or height. It means that setting this property sufficiently high will turn a perfectly square background into a perfectly round one.
     - Minimum value is `0` and maximum value is `0.5`
     - Default is `0` (corners are not rounded)
 * `backgroundColor` - type: COLOR
@@ -2124,7 +2133,7 @@ Properties:
     - Valid values are `bottom`, `middle` or `top`
     - Default is `top`
 * `selectorCornerRadius` - type: FLOAT
-    - Setting this property higher than zero applies rounded corners to the image defined by `backgroundImage`. The radius is a percentage of the screen width and not directly related to the image size. This makes it possible to apply identically sized corners regardless of image dimensions. The size is calculated internally with `itemScale` and `selectorRelativeScale` set to `1`. Note that the maximum allowed value is quite arbitrary as the renderer will in practice limit the maximum roundness so it can never go beyond half the width or height. It means that setting this property sufficiently high will turn a perfectly square image into a perfectly round one.
+    - Setting this property higher than zero applies rounded corners to the image defined by `selectorImage`, or to the colored rectangle if `selectorColor` has been defined without using a selector image. The radius is a percentage of the screen width and not directly related to the selector size. This makes it possible to apply identically sized corners regardless of image dimensions. The size is calculated internally with `itemScale` and `selectorRelativeScale` set to `1`. Note that the maximum allowed value is quite arbitrary as the renderer will in practice limit the maximum roundness so it can never go beyond half the width or height. It means that setting this property sufficiently high will turn a perfectly square selector into a perfectly round one.
     - Minimum value is `0` and maximum value is `0.5`
     - Default is `0` (corners are not rounded)
 * `selectorColor` - type: COLOR
@@ -2144,6 +2153,11 @@ Properties:
     - This property makes it possible to size the text relative to the overall item size.
     - Minimum value is `0.2` and maximum value is `1`
     - Default is `1`
+* `textBackgroundCornerRadius` - type: FLOAT
+    - Setting this property higher than zero applies rounded corners to the text background, assuming it has a color set. The radius is a percentage of the screen width. Note that the maximum allowed value is quite arbitrary as the renderer will in practice limit the maximum roundness so it can never go beyond half the text background height.
+    - Minimum value is `0` and maximum value is `0.5`
+    - Default is `0` (corners are not rounded)
+    - This property can only be used if `textBackgroundColor` has a value defined.
 * `textColor` - type: COLOR
     - Default is `000000FF`
 * `textBackgroundColor` - type: COLOR