diff --git a/CHANGELOG.md b/CHANGELOG.md
index 693959632..bf2465264 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -60,7 +60,6 @@ In addition to the above many bugs have been fixed and the application has recei
* Added support for the Taito Type X (type-x) game system
* Added support for the Microsoft Windows 3.x (windows3x) game system
* Added support for the Microsoft Windows 9x (windows9x) game system
-* Removed support for the Adventure Game Studio Game Engine (ags) game system
* Removed support for the Cave Story (NXEngine) (cavestory) game system
* Removed support for the MAME4ALL (mame-mame4all) game system
* Removed support for the Moonlight Game Streaming (moonlight) game system
@@ -112,11 +111,13 @@ In addition to the above many bugs have been fixed and the application has recei
* (Windows) Added %STARTDIR%=%EMUDIR% for the Vita3K and xemu emulators
* (Windows) Added Demul as an alternative emulator for the atomiswave, dreamcast, naomi and naomi2 systems
* (Windows) Added 3dSen standalone as an alternative emulator for the famicom and nes systems
+* (Windows) Added Altirra standalone as an alternative emulator for the atari5200, atari800 and atarixe systems
* (Windows) Added the .url file extension to the epic system
* (Windows) Added the .lnk file extension to the steam system
* Removed atarijaguarcd as an extra platform for the atarijaguar system as it actually made scraping worse
* Added arcade as an extra platform to the daphne system (to improve scraping)
* Removed the videopac platform ID entry as it's identical to odyssey2
+* Changed the platform for the ags system to pcwindows to improve scraping
* Changed the platform for the videopac system to odyssey2 to improve scraping
* Added the snes-msu1 platform so that these games can be scraped using ScreenScraper (requires custom system config)
* Changed the full name for the vectrex system from "Smith Engineering Vectrex" to "GCE Vectrex"
diff --git a/THEMES-DEV.md b/THEMES-DEV.md
index d6ac09a8d..c6e9eff6c 100644
--- a/THEMES-DEV.md
+++ b/THEMES-DEV.md
@@ -50,27 +50,48 @@ The directory structure for our example theme could look something like the foll
```
...
- themes/
- mytheme-es-de/
- core/
- font.ttf
- bold_font.ttf
- frame.png
-
- nes/
- theme.xml
- background.jpg
- logo.svg
- logo_video.svg
-
- snes/
- theme.xml
- background.jpg
- logo.svg
- logo_video.svg
-
- fonts.xml
+themes/
+ mytheme-es-de/
+ core/
+ font.ttf
+ font_bold.ttf
+ frame.png
+ nes/
+ background.jpg
+ logo.svg
theme.xml
+ snes/
+ background.jpg
+ logo.svg
+ theme.xml
+
+ fonts.xml
+ theme.xml
+```
+
+An alternative approach would be to instead rely on variables for populating system-specific information and media files, and this way it's not necessary to setup separate directories per system:
+
+```
+...
+themes/
+ mytheme-es-de/
+ core/
+ font.ttf
+ font_bold.ttf
+ frame.png
+ systems/
+ backgrounds/
+ nes.jpg
+ snes.jpg
+ logos/
+ nes.svg
+ snes.svg
+ metadata/
+ nes.xml
+ snes.xml
+
+ fonts.xml
+ theme.xml
```
The ES-DE theme functionality makes it easy for users to install different themes and to choose between them from the _UI Settings_ menu.
diff --git a/USERGUIDE-DEV.md b/USERGUIDE-DEV.md
index fe42a64c3..1672e2751 100644
--- a/USERGUIDE-DEV.md
+++ b/USERGUIDE-DEV.md
@@ -3785,6 +3785,7 @@ The **@** symbol indicates that the emulator is _deprecated_ and will be removed
| :-------------------- | :--------------------------------------------- | :-------------------------------- | :-------------------------------- | :----------- | :----------------------------------- |
| 3do | 3DO Interactive Multiplayer | Opera | | Yes | |
| adam | Coleco Adam | MAME [Diskette] **(Standalone)** | MAME [Tape] **(Standalone)**,
MAME [Cartridge] **(Standalone)**,
MAME [Software list] **(Standalone)** | Yes | |
+| ags | Adventure Game Studio Game Engine | _Shortcut or script_ | | No | |
| amiga | Commodore Amiga | PUAE | PUAE 2021,
FS-UAE **(Standalone)**,
Amiberry **(Standalone)** [UM] | Yes | See the specific _Commodore Amiga and CDTV_ section elsewhere in this guide |
| amiga1200 | Commodore Amiga 1200 | PUAE | PUAE 2021,
FS-UAE **(Standalone)**,
Amiberry **(Standalone)** [UM] | Yes | See the specific _Commodore Amiga and CDTV_ section elsewhere in this guide |
| amiga600 | Commodore Amiga 600 | PUAE | PUAE 2021,
FS-UAE **(Standalone)**,
Amiberry **(Standalone)** [UM] | Yes | See the specific _Commodore Amiga and CDTV_ section elsewhere in this guide |
@@ -3799,14 +3800,14 @@ The **@** symbol indicates that the emulator is _deprecated_ and will be removed
| arduboy | Arduboy Miniature Game System | Arduous | | No | Single archive or .hex file |
| astrocde | Bally Astrocade | MAME - Current | MAME **(Standalone)** | Yes | See the specific _Bally Astrocade_ section elsewhere in this guide |
| atari2600 | Atari 2600 | Stella | Stella 2014,
Stella **(Standalone)**,
Gopher2600 **(Standalone)** [UW],
ares **(Standalone)** | No | Single archive or ROM file |
-| atari5200 | Atari 5200 | a5200 | Atari800,
Atari800 **(Standalone)** | Yes | Single archive or ROM file |
+| atari5200 | Atari 5200 | a5200 | Atari800,
Atari800 **(Standalone)**,
Altirra **(Standalone)** [W] | Yes except for Altirra | Single archive or ROM file |
| atari7800 | Atari 7800 ProSystem | ProSystem | MAME **(Standalone)** | Yes | Single archive or ROM file |
-| atari800 | Atari 800 | Atari800 | Atari800 **(Standalone)** | No | |
+| atari800 | Atari 800 | Atari800 | Atari800 **(Standalone)**,
Altirra **(Standalone)** [W] | Yes except for Altirra | |
| atarijaguar | Atari Jaguar | Virtual Jaguar | BigPEmu **(Standalone)** [W],
BigPEmu **(Wine)** [U],
BigPEmu **(Proton)** [U],
MAME **(Standalone)** | Yes for MAME | See the specific _Atari Jaguar and Atari Jaguar CD_ section elsewhere in this guide |
| atarijaguarcd | Atari Jaguar CD | BigPEmu **(Standalone)** [W],
BigPEmu **(Wine)** [U] | BigPEmu **(Proton)** [U] | No | See the specific _Atari Jaguar and Atari Jaguar CD_ section elsewhere in this guide |
| atarilynx | Atari Lynx | Handy | Beetle Lynx,
Mednafen **(Standalone)** | | |
| atarist | Atari ST [also STE and Falcon] | Hatari | Hatari **(Standalone)** | Yes | Single archive or image file for single-diskette games, .m3u playlist for multi-diskette games |
-| atarixe | Atari XE | Atari800 | Atari800 **(Standalone)** | No | |
+| atarixe | Atari XE | Atari800 | Atari800 **(Standalone)**,
Altirra **(Standalone)** [W] | Yes except for Altirra | |
| atomiswave | Sammy Corporation Atomiswave | Flycast | Flycast **(Standalone)**,
Flycast Dojo **(Standalone)**,
Demul **(Standalone)** [W] | Depends | Single archive file |
| bbcmicro | Acorn Computers BBC Micro | MAME **(Standalone)** | | Yes | Single archive or diskette image file |
| c64 | Commodore 64 | VICE x64sc Accurate | VICE x64sc Accurate **(Standalone)**,
VICE x64 Fast,
VICE x64 SuperCPU,
VICE x128,
Frodo | No | Single archive or image file for tape, cartridge or single-diskette games, .m3u playlist for multi-diskette games |