Skip to content

Adventure Game Studio

Adventure Game Studio

Adventure Game Studio is an open source development tool that is primarily used to create graphic adventure games.

Emulator Rom Folder Extension BIOS Controller Config
AGS ags .exe none mouse


Accepted File Extensions: .exe

Place your AGS files in



Ensure that you have RetroPie-Setup script version 4.3.8 or later before installing AGS, as several issues (such as content not appearing in EmulationStation and MIDI music playback) have been fixed.

Video issues - window manager and graphics driver

More recent Retropie images have not included a desktop or window manager as part of the image (including many Xorg libraries). It also does not automatically enable OpenGL drivers (which are still experimental). In contrast, when installing the AGS package it relies on Xorg as it uses xinit for display and it also defaults to using an OpenGL graphics driver (at least the last time I installed AGS this was the case). As a result the resolution was incorrect and performance was poor, both to the point where it was unusable.

In order to rectify this I followed these steps:

Install Pixel desktop environment

After opening the Retropie setup script (either from the command line or via ES): Configuration / Tools -> Raspbian tools -> Install pixel desktop environment

Modify AGS emulators.cfg file

Edit the contents of /opt/retropie/configs/ags/emulators.cfg to contain:

ags = "xinit /opt/retropie/emulators/ags/bin/ags --fullscreen --gfxdriver software --gfxfilter hqx 1 %ROM%"
default = "ags"

Note that the "--gfxfilter hqx 1" is not required and can be omitted if you prefer to have the non-filtered graphics.

I elected to change the driver AGS was using rather than enable the OpenGL driver in Retropie as it is still experimental and is known to still cause issues for other emulators. I haven't actually tested AGS using the driver though so not sure if that works or not.


AGS requires a mouse attached to the Raspberry Pi.

Back to top