Launchers

A launcher config file describes how to launch a program (i.e. emulator, application, or game) when a launchable menu item is selected.

See below for a list of supported configuration properties. Launcher options

Property	Description
executable	Path of where the executable exists
arguments	Arguments to pass when executing the launcher (i.e. ROM name)

executable = D:/Emulators/Nestopia/nestopia.exe
arguments  = "%ITEM_FILEPATH%"

%ITEM_FILEPATH% is a reserved variable name. See the variables table below for other variables that may be used. Also note the quotes around “%ITEM_FILEPATH%” to help not confuse the executable from thinking that an item with spaces as multiple arguments.

Assuming that “Super Mario Bros” was the selected item, the frontend will attempt to execute:

"D:/Emulators/Nestopia/nestopia.exe" "D:/ROMs/Nintendo/Super Mario Bros.nes".

PS: You can also use relative paths (relative to the root folder of RetroFE)

executable = ../Emulators/Nestopia/nestopia.exe
arguments  = "%ITEM_FILEPATH%"

Launcher variables

Variable	Description	Translated Example
%ITEM_FILEPATH%	Full item path	D:/ROMs/Nintendo/Super Mario Bros.nes
%ITEM_NAME%	The item name	Super Mario Bros
%ITEM_FILENAME%	Filename without path	Super Mario Bros.nes
%ITEM_DIRECTORY%	Folder where file exists	D:/ROMs/Nintendo
%ITEM_COLLECTION_NAME%	Name of collection for item	Nintendo Entertainment System
%RETROFE_PATH%	Folder location of Frontend	D:/Frontends/RetroFE
%RETROFE_EXEC_PATH%	Location of RetroFE	D:/Frontends/RetroFE/RetroFE.exe

More elaborate example:

# Have fceux load a save state automatically for the ROM when started
executable = D:/Emulators/fceux/fceux.exe
arguments  = "%ITEM_FILEPATH%" -loadstate "%ITEM_DIRECTORY%/%ITEM_NAME%.fcs"

RetroFE documentation

User Tools

Site Tools

Launchers

Page Tools