Please do not post a support request without first reading and following the advice in

Multi Switch Shutdown Script!

  • Hi @cyperghost , I'm testing this script and works perfectly. Many thanks for the great job!!


  • @cyperghost does your script require raspi-GPIO on standard cases?

  • Hi @cyperghost , I combine a modified shutdown python script (reboot/shutdown with the same button by time, power on led of the button and video playback for reboot/shutdown actions) with your v0.07 of this script and works for me perfectly. It would be better if ES would not show up when killing the emulator process but it works and save metadata. This method would be totally generic!! Have you ever thought about doing something with the same characteristics?
    Another question out of curiosity... whe your script kills emulator process ES is showed in the screen before closing during one or two seconds more or less?


  • @cyperghost my plan is to create a python script for the GPIO but use either .ini or .cfg for people to customize

    It will look sorta like...

    GPIO triggered

    Check config

    Execute per selection

  • @Drakaen391
    That would be a good progress imho.
    You can use the same logic out from the bash script.
    Let me do some changes and I can provide a script that has several command line parameters.

    Command Line Parameters

    • --es reboot/shutdown/restart
    • --emuclose

    About the raspi-gpio
    It's not a question of the case you insert the Pie. It's more like how the GPIOs are triggered. If you read the internet in 99% of all howtos people use 3.3V and a resistor to input current to the GPIO. So of you press the button the current flow from ~3.3V is shorted to ground over an resistor.

    That's a comon method for the Mausberry switch for example. And you see it here in my script:

    echo "$GPIO_powerswitch" > /sys/class/gpio/export
    echo "in" > /sys/class/gpio/gpio$GPIO_powerswitch/direction

    @Yahmez used a clever way to solve that issue. He made use of the internal Pullup resistors. They work exactly same as an external (internal I think are 50kOhm resistors) but you need only a switch that is connected to a GPIO with activated internal resistors and connect it to ground, so outside no 3.3V rail is needed and all looks clean.

    Sadly bash isn't (easy) capable to export those function as filesystem. So you have no easy access to it. That's the reason raspi-gpio comes in. This C written tools sets the internal pullups and gives message out. So I just compare piped grep ouput if there is some change.
    There are also lot's more of that tools.

    1. PIGPIO (very capable but need to load it as service)
    2. wiringPI (very strong but I don't like the naming style of the GPIOs as they are copied from ARDUINO)
    3. at last raspi-gpio.
    4. surly others

    If you ask ... bash needs those extra programs and python has it all integrated then you are wrong. Python needs also a "external" programm, but it is called "LIBARY" und has to be imported.

    Just delete/comment the specific echo and sleep commands. Then all will be fine.

  • @cyperghost Sorry, maybe I explained wrong ... what I would like to know is if when your script kills the emulator process and is ready to close emulationstation the emulationstation menu is displayed for 1 or 2 seconds and then closes saving metadata ... Sorry for the bad explanation. I did not have the opportunity to try meleu's script when that method still worked and what I have now in my Pi works that way, it is not very important but I would like it more if it doesn't do it.


  • @cyperghost then I think using Python for the GPIO call would be easier because it doesn’t require any extra installs (the libraries are preinstalled)

    I will write something up later after I do some errands

  • @drakaen391 I think I can implent function calls.
    So you use python to setup triggers and make a call to script like --es poweroff
    This will shutdown ES, closes all emulators running and saves metadata.
    Then poweroff command will be performed. --espid
    gives back PID from ES....

    I made emulator shutdown and ES shutdown as quick as possible.
    I wait for closing and then close ES.
    I think the script from meleu uses a static timer after emulator shutdown so you see the ES screen for a few seconds.

    You can post your current script to pastebin and write link here.

  • Created version 0.30

    We can now use command-line options
    @Drakaen391 that's the way you want it :D


    • --es-pid Shows PID of ES, if not it shows 0
    • --rc-pid Shows PID of - shows 0 if not found
    • --closeemu Tries to shutdown emulators, with cyperghost method
    • --es-poweroff Shutdown emulators (if running), Closes ES, performs poweroff
    • --es-reboot Shutdown emulators, Cloese ES, performs system reboot
    • --es-restart Shutdown emulators (if running), Restart ES


    • --mausberry If you have a Mausberry device, GPIO 23 24 used!
    • --onoffshim If you have the Pimoroni OnOff SHIM GPIO 17 and 4 used!
    • --nespicase If you use the NESPICASE with yahmez-mod GPIO 23 24 25 used!

    Please update code form my

    GitHub account

  • @cyperghost oh, yes... I have no complaints about your script, it is perfect, it closes all the processes very fast ... the problem is that I want to have implemented the functions of restart and shutdown in a single button and the possibility of turning on a LED for buttons with integrated LED. For this reason (and because I do not know how to program bash scripts) I have implemented only the part of kill emulator process of your script (calling the bash script) inside a Python script that performs the rest of functions, but it takes like a second or two to close emulationstation. If you are curious, I can upload the code so you can see it. I will try implement in the same code another gpio only for shutdown in cases of low battery in gameboy zero projects for example

  • @julenvitoria That's also not the problem
    You should use timer events. So you press the button (power button) if you release witihin 1.5 seconds you kill the emulators. If you don't realase the system power offs. Also doable ;) To led a LED glow

    use raspi-gpio set GPIONrLEDCONNECTED op dh

    to dim LED
    use raspi-gpio set GPIONrLEDCONNECTED op dl

    You can also export the port via bash command

       echo "$GPIO_poweronctrl" > /sys/class/gpio/export
        echo "out" > /sys/class/gpio/gpio$GPIO_poweronctrl/direction
        echo "1" > /sys/class/gpio/gpio$GPIO_poweronctrl/value

    You don't need to implent the code.... Use your python code and if power is going to suspend then use ./ --es-poweroff command ;)
    It's a kind of swiss army knife.

    So it's up to you and your coding skills, to call this script with the commands it provides. The rest ... button timing, LED glowing is a question of your coding skills. My knowledge in python is very bare and I'm also a beginner in bash.

    To deal with the output of this script use this python sniplet

    import subprocess
    def run(command):
        output = subprocess.check_output(command, shell=True)
        return output

  • Created version 0.40

    Added NESPi+ Case!


    I've lack of time so here is a base version of a script to detect PIDs of running emulator.

    This is the are bare (but) working sceleton of how emulators can be detected!

    You can download the script also from my github account: GITHUB - RETROPIE SHARES

    How does it work:

    1. This script uses process as entrypoint
    2. It generates an array of child-PIDs called through
    3. It shifts array backwards
    4. It sends TERM signal to all PIDs called by (from newest to oldest)
    5. It waits if PID is finished
    6. Emulator is terminated

    So in practice: [PID 1234] calls emulator lr-xxxxxx [PID 1236]
    So PID 1236 is terminated

    sometimes there are several script called [PID 1234] calls bash file SCUMMVM [PID 1236] this calls SCUMMVM framework [PID 1345]

    So we TERM 1345 and wait for closing, TERM 1236 and wait for closing!

    The advantage here is... there is no need to hook /dev/shm/runcommand.log and read out used emulator. We need just an emulator call via ;)

    @meleu @mediamogul @Drakaen391 @caver01
    Let us improve the shutdown scripts ;)

    # Shutdown Script Emulator Sceleton
    # by cyperghost for retropie
    # --------------------------
    # Initial release: ??? Don't know January 2018?
    # 04/19/18 Release in RetroPie forums
    # 04/20/18 julenvitoria introduced kill -9 signal for emulators
    # This function is called still all childPIDs are found
    function getcpid() {
    local cpids="$(pgrep -P $1)"
        for cpid in $cpids;
            getcpid $cpid
    # Abolish sleep timer! This one is much better!
    function smart_wait() {
        local PID=$1
        while [[ -e /proc/$PID ]]
            sleep 0.05
    # Our entrypoint! RUNCOMMAND is alpha, emulator is OMEGA
    motherpid="$(pgrep -f -n"
    # if there is no running then exit
    [ "$motherpid" ] && getcpid $motherpid || exit
    # Reverse array and do your TERM job
    for ((z=${#pidarray[*]}-1; z>-1; z--)); do
        echo "Terminate PID ${pidarray[z]}"
        kill -9 ${pidarray[z]}
        smart_wait ${pidarray[z]}

  • @julenvitoria I implented the python script from the NESPi+ to work with my script. Works like a charm - python is very powerfull together with bash.

    So here is a full working example of how to integreate...
    For explaination how this works.
    The python script waits for a button event (the GPIOZERO Libery does this all in the background). A button is triggered now I as to output the ES-PID (to check if ES is running or not). If the result is a integer greater than 0 than it's a boolean true and we can shutdown ES with `./multi_switch --es-poweroff´ command (it closes running emulators, exits ES and initiates a shutdown) so all metadata is saved.

    If the answer is 0 we've got a boolean false and we use the regular shutdown.

  • @cyperghost Hi! Sorry but I was very busy these days... tonight or tomorrow I will upload the code that I use for you to see it. Yes, Python script plus bash is a powerful weapon !!

  • @cyperghost Here are the two scripts... the first pastebin is a script in python and is originally created by George Ilyes ( and is modified by PlataKoway and me to make it even more complete. Through this script I call version 0.07 of your script (the second one) in order to kill the process of the emulator that is running and then I close emulationstation in a safe way.

  • @julenvitoria There are some things that can be improved ;)

    1. Primary: If you use python then make use of interrupt then you can avoid the while(true)-loop.
    2. Secondary: I would rather do a ES-restart than a system reboot
    3. Secondary: I would rather use the poweroff button for an poweroff at short press and would use the 3 second timer to do a restart/reboot ;)
    4. Primary: The killall emulationstation will work in most cases but you will fail if you have scraped large amount of data. Because if after 5 seconds a shutdown is initiated the file system will be set to read only and you will loose data.
    5. Secondary: You use lots of sudo commands. You call the k.script with sudo for ex. this isn't necassary as ES is called by user pi, morover if you call the script via rc.local you are user root (so even the sudo shutdown can be shortend to shutdown only) or if you call it via ES autostart you are user pi, and then sudo shutdown is needed ;)

    All in all if you are happy with your setup and it works it is okay ;)
    Imho take a look to Point 1, this is one of the improvements python can handle at ease ;) Because with this setup it really doesn't matter if you use python or bash ...

    Take a look at this example here - you will see, there is no while-loop, because you can use interrupts. Your script uses polling :) Please don't take this as an offence.

  • @cyperghost Oh, thanks very much! I'll take a look to the link. You can be calm, I always receive in a good way a constructive criticism!! My skills of python are not very good but I am learning... :D

  • @julenvitoria I'm with you.

  • I just got a nespi+ case, and installed your script (I never installed the one from nespi). It restarts ES fine, but I don't think it's doing the safe shutdown correctly. When I press the power button, it goes straight to a black screen and shuts off. I don't see the screen output doing it's safe shutdown processes.

    I used the instructions here to install:

    I did install raspi-gpio as well.

    If I run this at the command line, I get a pid: ./ --es-pid
    I tried running the shutdown command from the command line as well (./ --es-poweroff), but it goes straight to a black screen as well...not a safe shutdown.

    What could be wrong?

    I have an RPi3, running RetroPie 4.3.

Contributions to the project are always appreciated, so if you would like to support us with a donation you can do so here.

Hosting provided by Mythic-Beasts. See the Hosting Information page for more information.