diff --git a/CREDITS.md b/CREDITS.md index 02c14c5a9..a86bbc151 100644 --- a/CREDITS.md +++ b/CREDITS.md @@ -125,15 +125,11 @@ https://www.mamedev.org CA certificates (for TLS/SSL support on Windows) \ https://wiki.mozilla.org/CA -# Slate Theme +# Linear Theme -The Slate theme is based on [recalbox-multi](https://gitlab.com/recalbox/recalbox-themes) by the Recalbox community, prior to their license change in 2018. +The Linear theme is based on [ESonline](https://github.com/Weestuarty/esonline-es-de) by Weestuarty. -Some graphics from the [Carbon](https://github.com/RetroPie/es-theme-carbon) theme by Rookervik. - -Some console and controller vector graphics by Bezza191. - -Some logotype graphics by Dan Patrick. +[Carousel icons](https://github.com/szymon-kulak/es-de-moderntheme-nsoicons) originally made by Szymon Kulak and modified by the ES-DE project. # Modern Theme @@ -145,6 +141,16 @@ Default [carousel icons](https://github.com/szymon-kulak/es-de-moderntheme-nsoic Some logotype graphics by Dan Patrick. +# Slate Theme + +The Slate theme is based on [recalbox-multi](https://gitlab.com/recalbox/recalbox-themes) by the Recalbox community, prior to their license change in 2018. + +Some graphics from the [Carbon](https://github.com/RetroPie/es-theme-carbon) theme by Rookervik. + +Some console and controller vector graphics by Bezza191. + +Some logotype graphics by Dan Patrick. + # Sounds Used by the default Slate theme as well as for fallback sounds (for themes that lack navigation sounds). diff --git a/README.md b/README.md index 6f207fde1..6084ac521 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # ES-DE (EmulationStation Desktop Edition) -EmulationStation Desktop Edition is a frontend for browsing and launching games from your multi-platform game collection. +ES-DE is a frontend for browsing and launching games from your multi-platform game collection. Website:\ [https://es-de.org](https://es-de.org) @@ -8,13 +8,13 @@ Website:\ Discord:\ [https://discord.gg/EVVX4DqWAP](https://discord.gg/EVVX4DqWAP) -The goal of this edition is to make the software as easy as possible to install and use as a standalone application, and to support the major desktop operating systems, i.e. Windows, macOS and Unix/Linux. Since it's intended to be used as a desktop application rather than as the primary interface for the computer, there are no plans to provide system administration utilities or control over emulator settings from within ES-DE. +The goal of this project is to make a high quality frontend that is easy to use, requires minimal setup and configuration, looks nice, and is available across a wide range of operating systems. It comes preconfigured for use with [RetroArch](https://www.retroarch.com) and a large selection of standalone emulators. It's also fully customizable so you can easily expand it to include emulators or applications not covered by the bundled configuration. -You can find the complete list of supported systems and emulators [here](USERGUIDE.md#supported-game-systems). +You can find the complete list of supported systems and emulators in the [User guide](USERGUIDE.md#supported-game-systems). -Two themes (Slate and Modern) are bundled with the application, and additional themes can be found on the [official themes list](https://gitlab.com/es-de/themes/themes-list) or be installed using the built-in theme downloader. +Three themes (Linear, Modern and Slate) are bundled with the application, and additional themes can be found on the [official themes list](https://gitlab.com/es-de/themes/themes-list) or can be installed using the built-in theme downloader. ## Download @@ -42,7 +42,7 @@ If you're using a Raspberry Pi or if you run FreeBSD, NetBSD or OpenBSD then you ## Some feature highlights -Here are some highlights, displayed using the default Slate theme. +Here are some highlights, displayed using the default Linear theme. ![alt text](images/es-de_system_view.png "ES-DE System View") _The **System view**, which is the default starting point for the application, it's here that you browse through your game systems._ @@ -69,4 +69,4 @@ _In addition to the scraper there is a fully-featured metadata editor that can b _There are four built-in screensavers, including a slideshow and a video screensaver that display random games from your collection._ ![alt text](images/es-de_ui_theme_support.png "ES-DE Theme Support") -_ES-DE is fully themeable, in case you prefer another look than what the default theme Slate offers. The screenshot above shows the Modern theme that is also bundled with the application._ +_ES-DE is fully themeable, in case you prefer another look than what the default theme Linear offers. The screenshot above shows the Slate theme that is also bundled with the application._ diff --git a/USERGUIDE-DEV.md b/USERGUIDE-DEV.md index 18a62fe3f..99374cc32 100644 --- a/USERGUIDE-DEV.md +++ b/USERGUIDE-DEV.md @@ -547,25 +547,25 @@ Quits the application. This key combination can be changed to Ctrl + Q, Alt + Q ## Themes -ES-DE ships with the Slate and Modern themes and additional ones can be installed using the built-in theme downloader. More themes made specifically for ES-DE can be found on the Internet, and you can customize or create your own ones too. +ES-DE ships with the Linear, Modern and Slate themes and additional ones can be installed using the built-in theme downloader. More themes made specifically for ES-DE can be found on the Internet, and you can customize or create your own ones too. Note that on Android specifically only the Linear theme is bundled with the application, but Modern and Slate can be installed via the theme downloader. -As of ES-DE 2.2.0 no legacy EmulationStation themes are supported, such as those from RetroPie ES. Only themes made specifically for ES-DE will work. +ES-DE does not support EmulationStation themes, such as those from RetroPie, Recalbox, RetroBat or Batocera. -There are several user-selectable theme options in the _UI Settings_ menu, most notably _Theme variant_ which is essentially a form of theme profile. This could be anything, like different ways to navigate the themes, different layouts and designs etc. Additionally the _Theme color scheme_ setting makes it possible to select between different color schemes, if supported by the theme. The two remaining options _Theme aspect ratio_ and _Theme transitions_ are also important but you can normally leave them at their default _Automatic_ values, especially the _Theme aspect ratio_ option as it will be automatically detected. Be aware that all these theme settings are optional, it's up to the theme developer whether to add support for them to their themes. +There are several user-selectable theme options in the _UI Settings_ menu, most notably _Theme variant_ which is essentially a form of theme profile. This could be anything, like different ways to navigate the themes, different layouts and designs etc. Additionally the _Theme color scheme_ setting makes it possible to select between different color schemes, if supported by the theme. You can change the font size too for themes that offer this, via the _Theme font size_ setting. The two remaining options _Theme aspect ratio_ and _Theme transitions_ are also important but you can normally leave them at their default _Automatic_ values, especially the _Theme aspect ratio_ option as it will be automatically detected. Be aware that all these theme settings are optional, it's up to the theme developer whether to add support for them to their themes. -Themes are most easily installed using the built-in theme downloader, but you can also manually add them to your ES-DE home directory, i.e. `~/ES-DE/themes/`. By just adding them there, one folder each, they will be found during startup and you can then choose between them via the _UI Settings_ menu on the main menu. If using the portable release of ES-DE on Windows, the ES-DE application data can be found in the root of the ES-DE directory. +Themes are most easily installed using the built-in theme downloader, but you can also manually add them to your ES-DE home directory, i.e. `ES-DE/themes/`. By just adding them there, one folder each, they will be found during startup and you can then choose between them via the _UI Settings_ menu on the main menu. If using the portable release of ES-DE on Windows, the ES-DE application data can be found in the root of the ES-DE directory. -Although you should place additional themes in your ES-DE home directory, the default Slate and Modern themes are located in the installation folder as they come bundled with the application. For example this could be `/usr/share/es-de/themes/` on Linux, `/Applications/ES-DE.app/Contents/Resources/themes/` on macOS or `C:\Program Files\ES-DE\themes\` on Windows. If using the portable ES-DE release on Windows, the themes folder will be located in the root of the ES-DE directory. +Although you should place additional themes in your ES-DE application data directory, the Linear, Modern and Slate themes are located in the installation folder as they come bundled with the application. For example this could be `/usr/share/es-de/themes/` on Linux, `/Applications/ES-DE.app/Contents/Resources/themes/` on macOS or `C:\Program Files\ES-DE\themes\` on Windows. If using the portable ES-DE release on Windows, the themes folder will be located in the root of the ES-DE directory. Note that if using the AppImage release on Linux, then there is no installation folder as all files are contained inside the AppImage file. -If you would like to customize the Slate or Modern themes, simply make a copy of their directories to `~/ES-DE/themes/` and then those copies will take precedence over the ones in the application installation directory. +If you would like to customize the Linear, Modern or Slate themes, simply make a copy of their directories to `ES-DE/themes/` and then those copies will take precedence over the ones in the application installation directory. Refer to the official themes list for a selection of high-quality themes (these are also available via the built-in theme downloader):\ https://gitlab.com/es-de/themes/themes-list ![alt text](images/es-de_ui_theme_support.png "ES-DE Theme Support") -_This is a screenshot of the Modern theme that is bundled with ES-DE in addition to the default Slate theme._ +_This is a screenshot of the Slate theme that is bundled with ES-DE in addition to the default Linear theme._ ## Theme downloader @@ -3131,7 +3131,7 @@ Starts the theme downloader, which is documented in detail elsewhere in this doc **Theme** -The theme to use. Defaults to Slate which is bundled with the application. +The theme to use. Defaults to Linear which is bundled with the application. **Theme variant** @@ -3439,7 +3439,7 @@ This lets you enable or disable your own custom game collections. If there are n **Create new custom collection from theme** _(Entry only visible if this ability is provided by the theme)_ -If the theme in use provides support for discrete custom collection systems, then this entry can be selected. For example, there could be support for systems like _Fighting_ or _Racing_ etc. The bundled Slate and Modern themes do not provide such discrete custom collection systems and in general it's not recommended to use this approach, as is explained [elsewhere](USERGUIDE-DEV.md#custom-collections) in this guide. +If the theme in use provides support for discrete custom collection systems, then this entry can be selected. For example, there could be support for systems like _Fighting_ or _Racing_ etc. The bundled Linear, Modern and Slate themes do not provide such discrete custom collection systems and in general it's not recommended to use this approach, as is explained [elsewhere](USERGUIDE-DEV.md#custom-collections) in this guide. **Create new custom collection** @@ -3865,7 +3865,7 @@ These automatic collections can be individually enabled or disabled by going to These are collections that you create yourself. Examples could be grouping in genres like _Shoot 'em up_, _Fighting games_ etc. or perhaps a time period like _1980s_, _1990s_ and so on. -If the theme in use supports it you can create a custom collection directly from a system provided by the theme. However, Slate and Modern do not provide such systems as it's believed that grouping them together in a dedicated _Collections_ system is a more elegant solution. Especially since the theme would need to ship with an almost endless amount of collection systems for whatever categories all ES-DE users combined would like to use for their libraries. +If the theme in use supports it you can create a custom collection directly from a system provided by the theme. However, Linear, Modern and Slate do not provide such systems as it's believed that grouping them together in a dedicated _Collections_ system is a more elegant solution. Especially since the theme would need to ship with an almost endless amount of collection systems for whatever categories all ES-DE users combined would like to use for their libraries. So if you have set the option _Group custom collections_ to _If unthemed_ or _Always_, any collections you add will show up in the special _Collections_ system. Here you can access them just as you would access folders inside a regular gamelist. The amount of games per collection is shown in the description, and a random game is displayed each time you browse through the list. You can also quick jump to this random game by pressing the _Y_ button. diff --git a/USERGUIDE.md b/USERGUIDE.md index deb4a9e09..d7c13f8b0 100644 --- a/USERGUIDE.md +++ b/USERGUIDE.md @@ -545,25 +545,25 @@ Quits the application. This key combination can be changed to Ctrl + Q, Alt + Q ## Themes -ES-DE ships with the Slate and Modern themes and additional ones can be installed using the built-in theme downloader. More themes made specifically for ES-DE can be found on the Internet, and you can customize or create your own ones too. +ES-DE ships with the Linear, Modern and Slate themes and additional ones can be installed using the built-in theme downloader. More themes made specifically for ES-DE can be found on the Internet, and you can customize or create your own ones too. Note that on Android specifically only the Linear theme is bundled with the application, but Modern and Slate can be installed via the theme downloader. -As of ES-DE 2.2.0 no legacy EmulationStation themes are supported, such as those from RetroPie ES. Only themes made specifically for ES-DE will work. +ES-DE does not support EmulationStation themes, such as those from RetroPie, Recalbox, RetroBat or Batocera. -There are several user-selectable theme options in the _UI Settings_ menu, most notably _Theme variant_ which is essentially a form of theme profile. This could be anything, like different ways to navigate the themes, different layouts and designs etc. Additionally the _Theme color scheme_ setting makes it possible to select between different color schemes, if supported by the theme. The two remaining options _Theme aspect ratio_ and _Theme transitions_ are also important but you can normally leave them at their default _Automatic_ values, especially the _Theme aspect ratio_ option as it will be automatically detected. Be aware that all these theme settings are optional, it's up to the theme developer whether to add support for them to their themes. +There are several user-selectable theme options in the _UI Settings_ menu, most notably _Theme variant_ which is essentially a form of theme profile. This could be anything, like different ways to navigate the themes, different layouts and designs etc. Additionally the _Theme color scheme_ setting makes it possible to select between different color schemes, if supported by the theme. You can change the font size too for themes that offer this, via the _Theme font size_ setting. The two remaining options _Theme aspect ratio_ and _Theme transitions_ are also important but you can normally leave them at their default _Automatic_ values, especially the _Theme aspect ratio_ option as it will be automatically detected. Be aware that all these theme settings are optional, it's up to the theme developer whether to add support for them to their themes. -Themes are most easily installed using the built-in theme downloader, but you can also manually add them to your ES-DE home directory, i.e. `~/ES-DE/themes/`. By just adding them there, one folder each, they will be found during startup and you can then choose between them via the _UI Settings_ menu on the main menu. If using the portable release of ES-DE on Windows, the ES-DE application data can be found in the root of the ES-DE directory. +Themes are most easily installed using the built-in theme downloader, but you can also manually add them to your ES-DE home directory, i.e. `ES-DE/themes/`. By just adding them there, one folder each, they will be found during startup and you can then choose between them via the _UI Settings_ menu on the main menu. If using the portable release of ES-DE on Windows, the ES-DE application data can be found in the root of the ES-DE directory. -Although you should place additional themes in your ES-DE home directory, the default Slate and Modern themes are located in the installation folder as they come bundled with the application. For example this could be `/usr/share/es-de/themes/` on Linux, `/Applications/ES-DE.app/Contents/Resources/themes/` on macOS or `C:\Program Files\ES-DE\themes\` on Windows. If using the portable ES-DE release on Windows, the themes folder will be located in the root of the ES-DE directory. +Although you should place additional themes in your ES-DE application data directory, the Linear, Modern and Slate themes are located in the installation folder as they come bundled with the application. For example this could be `/usr/share/es-de/themes/` on Linux, `/Applications/ES-DE.app/Contents/Resources/themes/` on macOS or `C:\Program Files\ES-DE\themes\` on Windows. If using the portable ES-DE release on Windows, the themes folder will be located in the root of the ES-DE directory. Note that if using the AppImage release on Linux, then there is no installation folder as all files are contained inside the AppImage file. -If you would like to customize the Slate or Modern themes, simply make a copy of their directories to `~/ES-DE/themes/` and then those copies will take precedence over the ones in the application installation directory. +If you would like to customize the Linear, Modern or Slate themes, simply make a copy of their directories to `ES-DE/themes/` and then those copies will take precedence over the ones in the application installation directory. Refer to the official themes list for a selection of high-quality themes (these are also available via the built-in theme downloader):\ https://gitlab.com/es-de/themes/themes-list ![alt text](images/es-de_ui_theme_support.png "ES-DE Theme Support") -_This is a screenshot of the Modern theme that is bundled with ES-DE in addition to the default Slate theme._ +_This is a screenshot of the Slate theme that is bundled with ES-DE in addition to the default Linear theme._ ## Theme downloader @@ -3129,7 +3129,7 @@ Starts the theme downloader, which is documented in detail elsewhere in this doc **Theme** -The theme to use. Defaults to Slate which is bundled with the application. +The theme to use. Defaults to Linear which is bundled with the application. **Theme variant** @@ -3437,7 +3437,7 @@ This lets you enable or disable your own custom game collections. If there are n **Create new custom collection from theme** _(Entry only visible if this ability is provided by the theme)_ -If the theme in use provides support for discrete custom collection systems, then this entry can be selected. For example, there could be support for systems like _Fighting_ or _Racing_ etc. The bundled Slate and Modern themes do not provide such discrete custom collection systems and in general it's not recommended to use this approach, as is explained [elsewhere](USERGUIDE.md#custom-collections) in this guide. +If the theme in use provides support for discrete custom collection systems, then this entry can be selected. For example, there could be support for systems like _Fighting_ or _Racing_ etc. The bundled Linear, Modern and Slate themes do not provide such discrete custom collection systems and in general it's not recommended to use this approach, as is explained [elsewhere](USERGUIDE.md#custom-collections) in this guide. **Create new custom collection** @@ -3863,7 +3863,7 @@ These automatic collections can be individually enabled or disabled by going to These are collections that you create yourself. Examples could be grouping in genres like _Shoot 'em up_, _Fighting games_ etc. or perhaps a time period like _1980s_, _1990s_ and so on. -If the theme in use supports it you can create a custom collection directly from a system provided by the theme. However, Slate and Modern do not provide such systems as it's believed that grouping them together in a dedicated _Collections_ system is a more elegant solution. Especially since the theme would need to ship with an almost endless amount of collection systems for whatever categories all ES-DE users combined would like to use for their libraries. +If the theme in use supports it you can create a custom collection directly from a system provided by the theme. However, Linear, Modern and Slate do not provide such systems as it's believed that grouping them together in a dedicated _Collections_ system is a more elegant solution. Especially since the theme would need to ship with an almost endless amount of collection systems for whatever categories all ES-DE users combined would like to use for their libraries. So if you have set the option _Group custom collections_ to _If unthemed_ or _Always_, any collections you add will show up in the special _Collections_ system. Here you can access them just as you would access folders inside a regular gamelist. The amount of games per collection is shown in the description, and a random game is displayed each time you browse through the list. You can also quick jump to this random game by pressing the _Y_ button. diff --git a/images/es-de_alternative_emulators.png b/images/es-de_alternative_emulators.png index c205fda7c..499a0edfa 100644 Binary files a/images/es-de_alternative_emulators.png and b/images/es-de_alternative_emulators.png differ diff --git a/images/es-de_application_updater.png b/images/es-de_application_updater.png index 8ec997227..5afa21489 100644 Binary files a/images/es-de_application_updater.png and b/images/es-de_application_updater.png differ diff --git a/images/es-de_basic_view_style.png b/images/es-de_basic_view_style.png index 8a7f8de6a..91d66132b 100644 Binary files a/images/es-de_basic_view_style.png and b/images/es-de_basic_view_style.png differ diff --git a/images/es-de_custom_collections.png b/images/es-de_custom_collections.png index 37bf55ce4..4a2a6488b 100644 Binary files a/images/es-de_custom_collections.png and b/images/es-de_custom_collections.png differ diff --git a/images/es-de_custom_collections_editing.png b/images/es-de_custom_collections_editing.png index 5be18163e..0a5c90437 100644 Binary files a/images/es-de_custom_collections_editing.png and b/images/es-de_custom_collections_editing.png differ diff --git a/images/es-de_folder_support.png b/images/es-de_folder_support.png index e84fdc45a..a95e721e6 100644 Binary files a/images/es-de_folder_support.png and b/images/es-de_folder_support.png differ diff --git a/images/es-de_gamelist_filters.png b/images/es-de_gamelist_filters.png index f065e5125..14d28b77a 100644 Binary files a/images/es-de_gamelist_filters.png and b/images/es-de_gamelist_filters.png differ diff --git a/images/es-de_gamelist_options_menu.png b/images/es-de_gamelist_options_menu.png index 7fdc1dc62..711950728 100644 Binary files a/images/es-de_gamelist_options_menu.png and b/images/es-de_gamelist_options_menu.png differ diff --git a/images/es-de_gamelist_view.png b/images/es-de_gamelist_view.png index d8d0d19f3..af516d67f 100644 Binary files a/images/es-de_gamelist_view.png and b/images/es-de_gamelist_view.png differ diff --git a/images/es-de_main_menu.png b/images/es-de_main_menu.png index 5f5a223f7..1df6d816f 100644 Binary files a/images/es-de_main_menu.png and b/images/es-de_main_menu.png differ diff --git a/images/es-de_main_menu_light.png b/images/es-de_main_menu_light.png index 56aff753d..83d58b038 100644 Binary files a/images/es-de_main_menu_light.png and b/images/es-de_main_menu_light.png differ diff --git a/images/es-de_metadata_editor.png b/images/es-de_metadata_editor.png index 47855e9dc..c300612f0 100644 Binary files a/images/es-de_metadata_editor.png and b/images/es-de_metadata_editor.png differ diff --git a/images/es-de_orphaned_data_cleanup.png b/images/es-de_orphaned_data_cleanup.png index 620b19cb5..907f10d15 100644 Binary files a/images/es-de_orphaned_data_cleanup.png and b/images/es-de_orphaned_data_cleanup.png differ diff --git a/images/es-de_scraper_running.png b/images/es-de_scraper_running.png index e5d560893..594458a25 100644 Binary files a/images/es-de_scraper_running.png and b/images/es-de_scraper_running.png differ diff --git a/images/es-de_scraper_settings.png b/images/es-de_scraper_settings.png index cfe46923c..a5af2644d 100644 Binary files a/images/es-de_scraper_settings.png and b/images/es-de_scraper_settings.png differ diff --git a/images/es-de_system_view.png b/images/es-de_system_view.png index 2e2e5ab44..36b945348 100644 Binary files a/images/es-de_system_view.png and b/images/es-de_system_view.png differ diff --git a/images/es-de_theme_downloader.png b/images/es-de_theme_downloader.png index f29d7afff..5331255a8 100644 Binary files a/images/es-de_theme_downloader.png and b/images/es-de_theme_downloader.png differ diff --git a/images/es-de_ui_easy_setup.png b/images/es-de_ui_easy_setup.png index 7b3654a17..784f98049 100644 Binary files a/images/es-de_ui_easy_setup.png and b/images/es-de_ui_easy_setup.png differ diff --git a/images/es-de_ui_theme_support.png b/images/es-de_ui_theme_support.png index fdc1c266e..cde07e54a 100644 Binary files a/images/es-de_ui_theme_support.png and b/images/es-de_ui_theme_support.png differ