Scripting

EmulationStation supports calling external scripts and executables on certain program events.

1. The scripts directory

First, create a new directory called scripts inside the config directory:

Linux: ~/.emulationstation or /etc/emulationstation/scripts

2. Event directories

Inside the scripts folder, create a new directory for the kind of event you want to script:

Name	When	Arguments
quit	on program quit
reboot	on system reboot (also calls quit first)
shutdown	on system shutdown (also calls quit first)
config-changed	on the change of any configuration option
controls-changed	on change of the control settings (also calls config first)
settings-changed	on change of the regular (non-control) settings (also calls config first)	%new_theme% %old_theme%
theme-changed	on change of theme (also calls settings-changed after)
game-start	before starting a game
game-end	after finishing a game
sleep	on screensaver activation
wake	on screensaver deactivation

3. Script calling

Put your executable scripts or binaries into these new directories. They will be called in alphabetic order when the event happens.