Emulator Settings

Top  Previous  Next

How to reach it


In Settings press the button next to Emulator Settings
In Games & Emulation Main Screen using the main lists context menu (right click) and choosing the Open Emulator Settings menu item


How it works


Here you set up all the emulators you want to use within Metropolis Launcher.






hmtoggle_plus1[1] Emulators List


This list shows all the emulators you added to Metropolis Launcher.


Use the buttons on the bottom or the context menu (right click) to add, duplicate or delete an emulator.


If you select an emulator by left click or via the keyboard, its settings will be shown on the right.


hmtoggle_plus1[2] Options in Tabs



The Settings Tab provides the necessary settings for each emulator:




[A] Autoconfig this Emulator Button


When Metropolis Launcher detects the current emulator as a known emulator, you can press this button to automatically apply correct settings for it.


[B] Name


This is the display name of the emulator within Metropolis Launcher. It will be used in the emulators list (see above) as well as the launch menu of the Games & Emulation Main Screen.


You can add the same emulator under different names in Metropolis Launcher. This can be useful, if you need to start the emulator with different command line options.


[C] Directory


The directory, the emulator is installed in (will be auto-filled when using the Button_DotDotDot2 button, which lets you browse for an emulator.


[D] Executable


The emulator's executable (will be auto-filled when using the Button_DotDotDot2 button, which lets you browse for an emulator.


Use the Button_Run button to simply run the emulator without any startup parameters. This can be useful if you want to do some settings within the emulator.


Note: Don't put any startup parameters in the Executable field, they should be specified in the Startup Parameter field.


[E] Screenshot Directory


Metropolis Launcher monitors screenshot directories in order to file screenshots taken in a session to the correct game entry. If the emulator saves screenshots in a certain directory, you can put the directory path in the field or use the Button_DotDotDot2 button to browse it.


[F] Startup Parameter


All the necessary command line arguments for the emulator should be defined in this field. Read more about startup parameters here.


[G] List Generator


In order to feed multiple roms/cd images/diskette images to an emulator, some emulators support text-based list files as startup parameter.
The generated list files can be used as startup parameter for the emulator by using the variable %listfile%, which provides a filepath with .txt file ending. A user-defined file ending can be achieved by providing the variable %listfile.ext% where ext is the extension (e.g. %listfile.m3u% generates a file with .m3u extension).


Use the Button_Dropdown button to select the list generator to be applied.


Use the Button_DotDotDot button to edit the currently selected list generator.


Use the Button_Plus button to add a new list generator.


Use the Button_Minus button to globally remove the currently selected list generator.


[H] J2K Preset


If you use a J2K - A Joystick to Keyboard Mapper (get it from emulation-evolved.net) and you have set it up in the Settings, you can set the J2K preset to be used with the emulator here.

[I] Libretro Core


Note: This dropdown is only visible if you edit a RetroArch emulator.


Select the libretro core to be used in this dropdown. This way you can add RetroArch multiple times with multiple names to Metropolis Launcher and define different libretro cores to be used.


[J] Enhanced Scripting




If you don't want Metropolis Launcher to launch an emulator directly but to run a script, select the scripting engine from the Enhanced Scripting dropdown and browse / create a script with the Script File's buttons.


Read more about enhanced scripting here.



The Multiple Volumes Tab allows the definition of startup parameters for emulators that support multiple volumes (Diskettes, CD images etc.).




Use the Button_Add button to add an entry to the list.


Use the Button_Delete button to remove an entry from the list.


In the Disc/Volume field, you can set up the number of the disc/volume the startup parameter refers to.


In the Parameter field you define the startup parameter for the disc/volume.


Read more about startup parameters here.




Pre- and Post-Launch Commands can be set up here. They will be started before (Pre-Launch) and after (Post-Launch) the actual emulator runs.




Use the context menu (right click) on either of these lists to Add, Edit and Delete commands:




Add and Edit open the Edit Pre/Post Launch Command dialog.


Use the Button_MoveUp and Button_MoveDown buttons to re-organize the start sequence.




Note: This tab is only visible, if you are editing a DOSBox emulator.


If you are using an enhanced DOSBox build, you can define (by checking the checkboxes) which enhancing patches the build uses.




For the following DOSBox builds, Metropolis Launcher automatically sets these patch settings up:


DOSBox Daum Cafe (get it from ykhwong.x-y.net)
DOSBox Megabuild (get it from h-a-l-9000)


Read more about setting up DOSBox here.


hmtoggle_plus1[3] Platforms supported by this Emulator


Note: This list depends directly on the visibility settings in the Platform Settings.




Tick a checkbox in the Supported column and Metropolis Launcher will list this emulator in the Launch menu for every game of the platform.


Tick a checkbox in the Use as default Emulator column and Metropolis Launcher will use this emulator when doubleclicking (or pressing Enter on) every game of the platform.


Further Topics


Set up Emulators