Skip to content
Thomas Goldstein edited this page Jun 22, 2018 · 16 revisions

Löve is a 2d game engine programmed primarily in lua.

Emulator Löve (Experimental)

It only really works well on a Raspberry Pi 2. Games are programmed for different versions of Löve. RetroPie uses Love 11.1 and so it is likely a lot of games will not work because they have not been updated for version 11.1. See the section "Versions" below for step by step instruction how to install the older version 0.10.2 of Löve.


Accepted File Extensions: .love

Place your Löve games in


Note that love games are basically .zip files with a .love extension instead of a .zip, so when building love files from repos, the files all need to be in the top level directory (especially main.lua)


Controls vary by game though most will need a keyboard. Mari0 (which is installed when you install Löve) has some support for gamepads but you still need to use a keyboard to navigate the menus.

For display it is best to leave the video settings alone in the runcommand menu and just use the in game settings to scale it to 5.

Other Games:

You can add the following scripts in the configure function of /home/pi/RetroPie-Setup/scriptmodules/ports/

or you can just follow the links and download the .love files and place them into your ROM folders manually.

Mr. Rescue

    # get (freeware game data)
    if [[ ! -f "$romdir/love/" ]]; then
        wget "" -O "$romdir/love/"
        chown $user:$user "$romdir/love/"


    # get (freeware game data)
    if [[ ! -f "$romdir/love/" ]]; then
        wget "" -O "$romdir/love/"
        chown $user:$user "$romdir/love/"

90 Second Portraits

    # get (freeware game data)
    if [[ ! -f "$romdir/love/" ]]; then
        wget "" -O "$romdir/love/"
        chown $user:$user "$romdir/love/"

It can be run with

cd RetroPie-Setup
sudo ./ love configure


The default behavior of RetroPie is to always install the latest version of Love. Currently, this is v11. However, most games are written for v10. This includes the bundled Mari0 game which will just show a blue screen and an error message if it is started with v11 of Love.

In order get Mari0 and most other games to work, it is necessary to install Love v10. This requires editing the install script to point it to the correct url, and then (re-)installing Love from source. For this, a keyboard and internet access are required:

  • In Emulationstation, press F4 to exit into a command prompt, then enter
sudo nano RetroPie-Setup/scriptmodules/ports/
  • An editor should open
  • Use the cursor keys to navigate to the line
hg clone "$md_build"
  • Change it to read
hg clone "$md_build"
  • Press CTRL-x and then y to save the changes
  • Enter sudo reboot to restart Emulationstation
  • In Emulationstation, select Retropie -> Retropie Setup
  • In the Retropie Setup menu, select Manage Packages -> Optional Packages
  • In the list of optional packages, select love
  • Select "Install from source" (if Love is already installed, select 'uninstall' first and then 'install from source')
  • Love 0.10.2 is now being downloaded and installed automatically. This takes a while.
  • Perform a reboot once installation is done
  • Emulationstation should now show Love as a selection, and the pre-installed game Mari0 should work without errors.

Wiki Home Page

Getting Started



Advanced Configuration




Clone this wiki locally
You can’t perform that action at this time.