ES-DE/README.md

141 lines
14 KiB
Markdown
Raw Normal View History

2020-12-16 18:27:51 +00:00
# EmulationStation Desktop Edition (ES-DE)
2012-07-18 21:28:26 +00:00
EmulationStation Desktop Edition is a frontend for browsing and launching games from your multi-platform game collection.
2021-03-14 09:19:01 +00:00
Web site:\
[https://es-de.org](https://es-de.org)
YouTube channel with installation instruction videos:\
[https://www.youtube.com/channel/UCosLuC9yIMQPKFBJXgDpvVQ](https://www.youtube.com/channel/UCosLuC9yIMQPKFBJXgDpvVQ)
2021-03-05 18:49:31 +00:00
Discord server:\
[https://discord.gg/EVVX4DqWAP](https://discord.gg/EVVX4DqWAP)
2021-03-05 18:49:31 +00:00
2022-05-15 20:31:51 +00:00
Reddit (r/EmulationStation_DE):\
[https://www.reddit.com/r/EmulationStation_DE](https://www.reddit.com/r/EmulationStation_DE)
Although there are multiple forks of EmulationStation in existence, 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 software 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).
Two comprehensive theme sets, **slate-DE** (rbsimple-DE in the 1.x releases) and **modern-DE** are bundled with the application.
See the [official list](https://gitlab.com/es-de/themes/themes-list) of recommended theme sets if you would like to install additional themes.
The following operating systems have been tested (all for the x86 architecture unless otherwise stated):
* Windows 11, 10 and 8.1
2022-11-04 20:12:51 +00:00
* macOS 10.14 "Mojave" to 13 "Ventura" (M1 and Intel)
* macOS 10.11 "El Capitan" (legacy release)
2022-05-15 20:31:51 +00:00
* Ubuntu 20.04 to 22.04
2022-02-04 16:14:37 +00:00
* Linux Mint 20
* Manjaro 21
* Fedora 37 Workstation
* SteamOS 3
2021-11-27 10:57:14 +00:00
* elementary OS 6
2021-12-06 19:48:47 +00:00
* Raspberry Pi OS 10 and 11 (armv7l and aarch64)
* FreeBSD 13.0
2020-11-29 19:35:33 +00:00
* NetBSD 9.1
2021-05-14 09:01:55 +00:00
* OpenBSD 6.8
2020-12-30 10:53:49 +00:00
### Download
The latest stable version is 1.2.6 (released 2022-08-03)
2020-12-30 10:53:49 +00:00
| Package | Operating systems | Architecture | Download link |
| :------------------- | :------------------------------------------------------ | :----------- | :------------- |
| Windows installer | Windows 11, 10 and 8.1 | x64 (x86) | [EmulationStation-DE-1.2.6-x64.exe](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239196/download)|
| Windows portable | Windows 11, 10 and 8.1 | x64 (x86) | [EmulationStation-DE-1.2.6-x64_Portable.zip](https://gitlab.com/es-de/emulationstation-de/-/package_files/48555328/download)|
2022-11-04 20:12:51 +00:00
| macOS DMG installer | macOS 11 "Big Sur" to 13 "Ventura" | arm64 (M1) | [EmulationStation-DE-1.2.6-arm64.dmg](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239039/download)|
| macOS DMG installer | macOS 10.14 "Mojave" to 13 "Ventura" | x64 (x86) | [EmulationStation-DE-1.2.6-x64.dmg](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239145/download)|
| Debian DEB package | Ubuntu 20.04 to 22.04, Linux Mint 20, possibly others | x64 (x86) | [emulationstation-de-1.2.6-x64.deb](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239111/download)|
| Fedora RPM package | Fedora Workstation 36, possibly others | x64 (x86) | [emulationstation-de-1.2.6-x64.rpm](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239313/download)|
| Arch User Repository | Arch Linux, Manjaro, possibly others | x64 (x86) | [https://aur.archlinux.org/packages/emulationstation-de](https://aur.archlinux.org/packages/emulationstation-de)|
| Linux AppImage | Most Linux distributions | x64 (x86) | [EmulationStation-DE-x64.AppImage](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239389/download)|
| Linux AppImage | Current Linux distributions with libc 2.35 or later | x64 (x86) | [EmulationStation-DE-x64_Current.AppImage](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239574/download)|
| Linux AppImage | Steam Deck / SteamOS 3.x specific | x64 (x86) | [EmulationStation-DE-x64_SteamDeck.AppImage](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239682/download)|
| Debian DEB package | Raspberry Pi OS (Raspian) | ARM 32-bit | [emulationstation-de-1.2.6-armv7l.deb](https://gitlab.com/es-de/emulationstation-de/-/package_files/48239061/download)|
| Debian DEB package | Raspberry Pi OS (Raspian) | ARM 64-bit | [emulationstation-de-1.2.6-aarch64.deb](https://gitlab.com/es-de/emulationstation-de/-/package_files/48238997/download)|
The latest prerelease version is 2.0.0-alpha-2022-12-22
| Package | Operating systems | Architecture | Download link |
| :------------------- | :------------------------------------------------------ | :----------- | :------------- |
| Windows installer | Windows 11, 10 and 8.1 | x64 (x86) | [EmulationStation-DE-2.0.0-alpha-2022-12-22-x64.exe](https://gitlab.com/es-de/emulationstation-de/-/package_files/63689065/download)|
| Windows portable | Windows 11, 10 and 8.1 | x64 (x86) | [EmulationStation-DE-2.0.0-alpha-2022-12-22-x64_Portable.zip](https://gitlab.com/es-de/emulationstation-de/-/package_files/63689081/download)|
| macOS DMG installer | macOS 11 "Big Sur" to 13 "Ventura" | arm64 (M1) | [EmulationStation-DE-2.0.0-alpha-2022-12-22-arm64.dmg](https://gitlab.com/es-de/emulationstation-de/-/package_files/63688995/download)|
| macOS DMG installer | macOS 10.14 "Mojave" to 13 "Ventura" | x64 (x86) | [EmulationStation-DE-2.0.0-alpha-2022-12-22-x64.dmg](https://gitlab.com/es-de/emulationstation-de/-/package_files/63689044/download)|
| Debian DEB package | Ubuntu 20.04 to 22.04, Linux Mint 20, possibly others | x64 (x86) | [emulationstation-de-2.0.0-alpha-2022-12-22-x64.deb](https://gitlab.com/es-de/emulationstation-de/-/package_files/63689033/download)|
| Fedora RPM package | Fedora Workstation 37, possibly others | x64 (x86) | [emulationstation-de-2.0.0-alpha-2022-12-22-x64.rpm](https://gitlab.com/es-de/emulationstation-de/-/package_files/63689089/download)|
2023-01-05 21:17:49 +00:00
| Linux AppImage | Most Linux distributions | x64 (x86) | [EmulationStation-DE-2.0.0-alpha-2022-12-22-x64.AppImage](https://gitlab.com/es-de/emulationstation-de/-/package_files/64535341/download)|
| Linux AppImage | Steam Deck / SteamOS 3.x specific | x64 (x86) | [EmulationStation-DE-2.0.0-alpha-2022-12-22-x64_SteamDeck.AppImage](https://gitlab.com/es-de/emulationstation-de/-/package_files/63689122/download)|
Version 1.2.0 (released 2021-12-28) will be the last legacy release for macOS
| Package | Operating systems | Architecture | Download link |
| :------------------- | :------------------------------------------------------ | :----------- | :------------- |
| macOS DMG installer | Legacy macOS 10.11 "El Capitan" to 10.13 "High Sierra" | x64 (x86) | [EmulationStation-DE-1.2.0-x64_legacy.dmg](https://gitlab.com/es-de/emulationstation-de/-/package_files/25023954/download)|
All previous releases can be downloaded from [here](https://gitlab.com/es-de/emulationstation-de/-/packages).
2021-11-27 10:57:14 +00:00
If using FreeBSD, NetBSD or OpenBSD you will need to build ES-DE from source code for the time being, as explained in [INSTALL.md](INSTALL.md).
2020-12-30 10:53:49 +00:00
Prebuilt packages for the Raspberry Pi will be dropped as of ES-DE 2.0.0 but this platform will still be semi-officially supported as it's tested from time to time to make sure building doesn't fail.
2020-12-26 15:22:33 +00:00
# Additional information
2022-05-06 17:35:31 +00:00
[FAQ.md](FAQ.md) covers a number of Frequently Asked Questions and is recommended reading before diving into the other documents listed below.
2020-12-26 20:41:26 +00:00
[USERGUIDE.md](USERGUIDE.md) is a comprehensive guide on how to use ES-DE and it also contains a complete reference to all application settings.
[USERGUIDE-DEV.md](USERGUIDE-DEV.md) is the prerelease version of the above document, use this if you're running ES-DE 2.0.0.
2020-11-20 15:56:56 +00:00
[INSTALL.md](INSTALL.md) provides details on how to build the application from source code, and also discusses some more advanced configuration topics.
[INSTALL-DEV.md](INSTALL-DEV.md) is the prerelease version of the above document, use this if you're running ES-DE 2.0.0.
2020-11-20 15:56:56 +00:00
[THEMES.md](THEMES.md) is a guide on how theming works which is useful for those who would like to develop a new theme, or perhaps customize an existing theme.
[THEMES-DEV.md](THEMES-DEV.md) is the prerelease version of the above document, use this if you're interested in creating themes for the new theme engine in ES-DE 2.0.0.
[CREDITS.md](CREDITS.md) is an attempt to credit the individuals and projects which made ES-DE possible.
[CONTRIBUTING.md](CONTRIBUTING.md) contains information on how to contribute to ES-DE, and it also contains the roadmap for future releases.
[CHANGELOG.md](CHANGELOG.md) contains detailed information about all releases. This covers features, improvements, bug fixes and known issues.
2020-12-16 18:27:51 +00:00
# Some feature highlights
2020-11-19 16:16:23 +00:00
Here are some highlights of what ES-DE provides, displayed using the default theme set slate-DE. There are of course many more features available, as covered in the [User guide](USERGUIDE.md).
2020-11-19 16:16:23 +00:00
![alt text](images/es-de_system_view.png "ES-DE System View")
2020-12-26 15:22:33 +00:00
_The **System view**, which is the default starting point for the application, it's here that you browse through your game systems._
![alt text](images/es-de_gamelist_view.png "ES-DE Gamelist View")
_The **Gamelist view**, it's here that you browse the actual games per system. Note the support for mixing files and folders, and as well that a few badges are displayed indicating that the selected game is a favorite, that it's suitable for children and that it's controlled using a joystick. There is a game counter to the upper right as well, displaying the total number of games and the number of favorite games for this system._
![alt text](images/es-de_folder_support.png "ES-DE Folder Support")
_Another example of the gamelist view, displaying advanced folder support. You can scrape folders for game info and game media, sort folders as you would files, mark them as favorites etc. In this example ES-DE has been configured to sort favorite games above non-favorites._
![alt text](images/es-de_custom_collections.png "ES-DE Custom Collections")
_Games can be grouped into your own custom collections, in this example they're defined as game genres but you can name them anything you like. All gamelist views including the custom collections support both game images or game videos. By default the slate-DE theme will display the game image for a short moment before starting to play the video._
![alt text](images/es-de_scraper_running.png "ES-DE Scraper Running")
_This is a view of the built-in scraper which downloads game info and game media from either [screenscraper.fr](https://screenscraper.fr) or [thegamesdb.net](https://thegamesdb.net). It's possible to scrape a single game, or to run the multi-scraper which can scrape a complete game system or even your entire collection._
![alt text](images/es-de_scraper_settings.png "ES-DE Scraper Settings")
2020-12-26 15:22:33 +00:00
_There are many settings for the scraper including options to define which type of info and media to download. The above screenshot shows only a portion of these settings._
![alt text](images/es-de_metadata_editor.png "ES-DE Metadata Editor")
_In addition to the scraper there is a fully-featured metadata editor that can be used to modify information on a per-game basis. Here you can also toggle some additional flags which the scraper does not set, such as if the game is a favorite or if you have completed it. Most of these flags can also be filtered in the gamelist view, letting you for instance only display games that you have not played through._
![alt text](images/es-de_screensaver.png "ES-DE Screensaver")
_There are four types of built-in screensavers available, including a slideshow and the video screensaver shown in action above. These screensavers start after a configurable number of minutes of inactivity, and randomly display game media that you have previously scraped. If the corresponding option has been enabled, you can jump to the game from the screensaver, or even launch it directly. There is shader support in ES-DE to render scanlines and screen blur on top of the videos (for the slideshow screensaver, scanline rendering is provided)._
![alt text](images/es-de_ui_theme_support.png "ES-DE Theme Support")
_ES-DE is fully themeable, so if you prefer another look than what the default theme slate-DE offers, it's possible to apply another theme set. The image above is of the modern-DE theme that is also bundled with the application. Note that although ES-DE is backward compatible with older RetroPie EmulationStation themes, some newer features which are specific to ES-DE will not work, at least not until the theme authors update their themes._
![alt text](images/es-de_ui_easy_setup.png "ES-DE Easy Setup")
2021-06-28 20:15:27 +00:00
_A lot of effort has been spent on making ES-DE easy to setup and use. The above screenshot shows the dialog if starting the application without any game files present in the default ROM directory. ES-DE also ships with a comprehensive game systems configuration file, so unless you really want to customize your setup, you should not need to tinker with the configuration._