Skip to content
Christian Jungerius edited this page May 7, 2024 · 3 revisions

Before you start

Before you start, make sure you know the basics about how ROMs and emulators work.

Step 1

First install AKL and the default plugin. Read more here.

Source

Start with adding a Source to AKL. With a source you configure the location or path where AKL can find the games/ROMs. Furthermore you will be able to configure an assets directory. That is the location where all images will be stored or can be found for scraping. This can be for example the box covers for the games.
After creating a source you can scan it. AKL will add all the found games to the library.

Launcher

Next we will need to setup the launcher. That is the application that you need to start each of the games, the emulator. Open up the context menu, choose Add and then 'Launcher'. The default plugin gives you the option to select the application to start and the arguments it will need when starting up. You can use the special variable "$ROM$" as a placeholder in your arguments to let AKL put the location of a scanned ROM in the arguments. So for example you have the argument "-game $ROM$" which translates to "-game /my/roms/game01.zip" when launching Game01.
Which arguments are needed all depend on the particular launcher. Read application specific documentation for more.

Associate launcher with sources

Launchers can be added on a source level, on a ROM level or on a ROM Collection level. You can associate multiple launchers with a ROM (or collection or source). Under the context menu for a source (or collection, or ROM) you have the option to manage associated launchers. Simply select and add the launcher you want to associate.
Next time when you click on a ROM it will launch it using the added launcher.

Clone this wiki locally