RetroPie-Extra

I have a Pi5, so soon i will be working on testing Any help would be great on what works and what doesnt

This is a collection of unofficial installation scripts for RetroPie allowing you to quickly and easily install emulators, ports and libretrocores that haven't been included in RetroPie for one reason or another. These scripts can be considered experimental at best. I have found new scripts made by other people and added them to this Repo. I dont take credit for any of them, other then the ones I made

Most of the scripts do work as is.

I DONT HAVE A X86, SO I DIDNT TEST THOSE SCRIPTS, YOUR ARE ON YOUR OWN

I have changed the list below to show what has been tested to at least to install. I dont have all the games so I cant test them all

Pull requests and issue reports are accepted and encouraged as well as requests. Feel free to use the issue tracker to send me any personal requests for new scripts that you may have.

Installation with GUI menu,

There is a command line way of using this script, instructions coming soon

The following commands will clone the repo to your system and then run the GUI installer where you may select which of the scriptmodules will be copied into the RetroPie-Setup folder.

cd ~
git clone https://github.com/Exarkuniv/RetroPie-Extra.git
cd RetroPie-Extra/
./install-extras.sh

Command line way of install

    ./install-extras.sh [-u|--update] [option] [rp_setup_directory]

Options:
    -a  --all       Add all RetroPie-Extra modules (may severely impact the
                    loading time of RetroPie-Setup and retropiemenu configuration
                    items, especially on slower hardware)
    -r  --remove    Remove all RetroPie-Extra modules (does not "uninstall" the modules
                    in RP-Setup)
    -h  --help      Display this help and exit

The installation script assumes that RetroPie-Setup is installed to $HOME/RetroPie-Setup. You may specify an alternate location on command-line, ex: ./install-extras.sh /games/rp-setup

Usage

After installing RetroPie-Extra, the extra scripts will be installed directly in the RetroPie Setup script (generally in the experimental section), which you can run from either the command line or from the menu within Emulation Station.

cd ~
cd RetroPie-Setup/
sudo ./retropie_setup.sh

Updating

The following commands will update RetroPie-Extra to the latest repo and then re-run the installer (your installed scripts will be pre-selected. Just install them again to receive the latest updates.)

cd ~
cd RetroPie-Extra/
./update-extras.sh

OR

cd ~/RetroPie-Extra
git pull origin

Remove

The following commands will remove RetroPie-Extra from your system.

cd ~
cd RetroPie-Extra/
./remove-extras.sh

Change from the old ZeroJay's repo

If you need to update from ZeroJay's repo - first, discard the most recent commit:

git reset --hard HEAD^

Switch to ExarKuniv's new repo:

git remote set-url origin https://github.com/Exarkuniv/RetroPie-Extra

Then pull again from the updated origin:

git pull origin

Scripts that are unfinished/untested/unpolished/or broken will not be located in this repository and instead have been moved to RetroPie-Extra-unstable.

If there is a [X] that means it Installs and Plays. I'll have a note at the end with some Info about it. if there is NO note or [X] PLEASE LET ME KNOW if it works for you

Emulators

• - box86.sh -"Box86 emulator" Installs Runs fine

• - duckstation.sh -"PlayStation emulator - Duckstation standalone" Installs Runs fine

• - gearboy.sh - Gameboy emulator - Installs Plays fine, Need to clean up the controls

• - kat5200.sh - Atari 8-bit/5200 emulator - x86 only

• - openbor.sh - Beat 'em Up Game Engine (newest version) - Tested only on Pi4 so far, installs as a system instead of as a port, direct launching of games from emulationstation supported!

• - pico8.sh - Fantasy Game Emulator - Adds as a new system in RetroPie so you can directly launch carts. Was told that it works fine, so I'll go with that

• - pokemini.sh - Pokemon Mini emulator - x86 only

• - ppsspp-dev.sh - PlayStation Portable emulator PPSSPP - latest development version - Tested and works on RPi4 (May 2022)

• - supermodel-mechafatnick.sh - Sega Model 3 Arcade emulator - Installs Does play, test game are slow

• - supermodel-svn.sh - Sega Model 3 Arcade emulator - Installs Does play, test game are slow

Libretrocores

• - lr-2048.sh - 2048 engine - 2048 port for libretro - Installs, Plays, Runs well
• - lr-applewin - Apple2e emulator - AppleWin (current) port for libretro - Installs, Plays, Runs well
• - lr-arduous_lcd - ArduBoy emulator - arduous port for libretro- Installs, Plays, Runs well
• - lr-beetle-pce.sh - PCEngine emu - Mednafen PCE port for libretroInstalls, Plays, Runs well
• - lr-bk.sh - Elektronika БК-0010/0011/Terak 8510a emulator - BK port for libretro - Installs Plays not sure well or not
• - lr-blastem.sh - Sega Genesis emu - BlastEm port for libretro - x86 only
• - lr-boom3.sh - Doom 3 port for libretro - x86 only
• - lr-bsnes-hd.sh - "Super Nintendo Emulator - bsnes-HD port for libretro (BETA)" - Installs, Plays, Runs OK
• - lr-canary.sh - Citra Canary for libretro - x86 only
• - lr-cannonball.sh - An Enhanced OutRun engine for libretro - Installs, Plays, Runs well
• - lr-chailove.sh - 2D Game Framework with ChaiScript roughly inspired by the LÖVE API to libretro - Installs Plays fine, the one game i could find for it
• - lr-citra.sh - Citra port for libretro - x86 only
• - lr-crocods.sh - CrocoDS port for libretro - Installs Starts but will not finish loading game
• - lr-daphne.sh - Daphne port to libretro - laserdisk arcade games. - Installs dont have any games to test
• - lr-duckstation.sh -"PlayStation emulator - Duckstation for libretro"
• - lr-fceumm-mod.sh - Modified fceumm core to specifically support the Super Mario Bros 1/3 hack. - Installs, Plays, Runs well
• - lr-freej2me.sh - A J2ME implementation for old JAVA phone games. - Installs, Plays, Runs well
• - lr-gearboy.sh - Game Boy (Color) emulator - Gearboy port for libretro. - Installs, Plays, Runs well
• - lr-gearcoleco.sh - ColecoVision emulator - GearColeco port for libretro. - Installs, Plays, Runs well
• - lr-lutro.sh - Lua engine - lua game framework (WIP) for libretro following the LÖVE API - Installs, Plays, Runs well
• - lr-mame2003_midway.sh - MAME 0.78 core with Midway games optimizations. - Installs, doesnt start my games
• - lr-melonds.sh - NDS emu - MelonDS port for libretro - Installs, Plays, Runs
• - lr-mesen-s.sh - Super Nintendo emu - Mesen-S port for libretro - Installs, Plays, Runs well
• [] - lr-mess-jaguar.sh - Add support for using lr-mess for Jaguar games, uses atarijaguar system name to match lr-virtualjaguar. - did not test due to not having mess installed yet
• - lr-mu.sh - Palm OS emu - Mu port for libretro - Installs, Plays, Runs
• - lr-oberon.sh - Oberon RISC emulator for libretro - Installs
• - lr-openlara.sh - Tomb Raider engine - OpenLara port for libretro - Installs Might work, dont have correct files to test
• - lr-play.sh - PlayStation 2 emulator - Play port for libretro - x86 only
• - lr-potator.sh - Watara Supervision emulator based on Normmatt version - Potator port for libretro - Installs, Plays, Runs well
• - lr-ppsspp-dev.sh - PlayStation Portable emu - PPSSPP port for libretro - latest development version - Tested and works on RPi4 (May 2022)
• - lr-prboom-system.sh - For setting up DOOM as an emulated system, not a port. - Installs Plays fine
• - lr-race.sh - Neo Geo Pocket (Color) emulator - RACE! port for libretro. - Installs, Plays, Runs well
• - lr-reminiscence.sh - Flashback engine - Gregory Montoir’s Flashback emulator port for libretro - Installs, Plays, Runs fine
• - lr-sameboy.sh - Game Boy and Game Boy Color, emulator - SameBoy Port for libretro - Installs Plays, runs well
• - lr-samecdi - Philips CDI - same_cdi port for libretro - Installs, Dont have games to test
• - lr-simcoupe.sh - SAM Coupe emulator - SimCoupe port for libretro - Installs, Might run games, cant get one to work
• - lr-swanstation.sh - Playstation emulator - Duckstation fork for libretro - Installs, Plays well
• - lr-thepowdertoy.sh - Sandbox physics game for libretro - Installs Plays fine
• - lr-uzem.sh - Uzebox engine - Uzem port for libretro - Installs, Plays well
• - lr-vemulator.sh - SEGA VMU emulator - VeMUlator port for libretro - Installs Plays fine
• - lr-yabasanshiro.sh - Saturn & ST-V emulator - Yabasanshiro port for libretro - Installs Plays fine

Ports

• - 0ad.sh - Battle of Survival - is a futuristic real-time strategy game - Installs Plays fine
• - abuse.sh - Classic action game - Installs Plays fine, needs keyboard
• - adom.sh - Ancient Domains of Mystery - a free roguelike by Thomas Biskup - A keyboard is required to play (press SHIFT+Q to exit the game). Tested and works on RPi4.
• - augustus.sh - Enhanced Caesar III source port - Installs plays fine, needs mouse
• - avp.sh - AVP - Aliens versus Predator port - Installs plays fine, needs mouse
• - barrage.sh - Shooting Gallery action game - Installs, Plays fine, needs mouse
• - bermudasyndrome.sh - Bermuda Syndrome engine - Installs, plays fine, cant exit, but thats the desine of the engine not the script
• - berusky.sh - Advanced sokoban clone with nice graphics - Installs, Plays fine
• - bloboats.sh - Fun physics game - Installs play fine
• - boswars.sh - Battle of Survival - is a futuristic real-time strategy game - Installs, Plays fine, needs mouse
• - breaker.sh - Arkanoid clone - Installs, plays fine, need to drop the resolutions to 640-480
• - bstone.sh - BStone A source port of Blake Stone: Aliens of Gold and Blake Stone: Planet Strike Installs, Plays great
• - burgerspace.sh - BurgerTime clone - Installs, plays fine, need to drop the resolutions to 640-480
• - captains.sh- Captain 'S' The Remake - Installs, plays great
• - chocolate-doom.sh- DOOM source port - Installs, plays great
• - chocolate-doom-system.sh- For setting up DOOM as an emulated system, not port. - Installs Plays great
• - chopper258.sh - Chopper Commando Revisited - A modern port of Chopper Commando (DOS, 1990) - Installs, Plays fine, needs keyboard
• - corsixth.sh - CorsixTH - Theme Hospital Engine - Installs, Plays fine,/W DEMO
• - crack-attack.sh - Tetris Attack clone - Installs works, but you need to need to drop the resolutions to 640-480
• - crispy-doom.sh - DOOM source port - Installs, Plays great
• - crispy-doom-system.sh - For setting up DOOM as an emulated system, not port. - Installs, Plays great
• - cytadela.sh - Cytadela project - a conversion of an Amiga first person shooter. - Installs, Plays great
• - devilutionx.sh - Diablo source port - Installs, Plays great w/ DEMO
• - dhewm3.sh - Doom 3 port - Installs, Plays great w/ DEMO
• - diablo2.sh - Diablo 2 - Lord of Destruction port - Installs, Plays great
• - dosbox-x.sh - DOSbox-X - Testing of a new DOSbox system - Installs, Plays great
• - dunelegacy.sh - Dune 2 Building of a Dynasty port - Installs Play sgreat,/W game
• - easyrpgplayer.sh - RPG Maker 2000/2003 interpreter - Installs and launches
• - ecwolf.sh - ECWolf is an advanced source port for Wolfenstein 3D - Installs, Plays great
• - eternity.sh - Enhanced port of the official DOOM source - Installs, Plays great
• - extremetuxracer.sh - Linux verion of Mario cart - Installs, Plays great
• - fallout1.sh - Fallout2-ce - Fallout 2 Community Edition - Installs, Plays great
• - fallout2.sh - Fallout2-ce - Fallout 2 Community Edition - Installs, Plays great
• - freeciv.sh - Civilization online clone - Tested and works well
• - freedink.sh - Dink Smallwood engine - Installs, Plays great
• - freesynd.sh - Syndicate clone - Installs, Plays great
• - fruity.sh - inspired by the Kaiko classic Gem'X - Installs, Plays great
• - fs2open.sh - FreeSpace 2 Open - Origin Repository for FreeSpace 2 - Installs, Plays great
• - galius.sh - - Maze of Galius - Installs, Plays great
• - gmloader.sh - GMLoader - play GameMaker Studio games for Android on non-Android operating systems - Installs, Plays great W/games
• - gnukem.sh - Dave Gnukem - Duke Nukem 1 look-a-like - Installs, Plays great
• - gtkboard.sh - Board games system - Installs Runs fine
• - hcl.sh - Hydra Castle Labrinth - Installs, Plays great
• - heboris.sh - Tetris The Grand Master clone - Installs, Plays great,
• - hero2.sh - FHeroes2 - Heroes of Might and Magic II port - Installs, Plays great
• - hexen2.sh - Hexen II - Hammer of Thyrion source port Non-OpenGL - Installs, Plays great w/demo
• - hexen2gl.sh - Hexen II - Hammer of Thyrion source port using OpenGL - Installs, Plays great w/demo
• - hheretic.sh - Heretic GL port - Installs, Plays great w/demo
• - hhexen.sh - Hexen GL portt - Installs, Plays great w/demo
• - hurrican.sh - Turrican clone. - Installs, Plays great
• - ikemen-go.sh - I.K.E.M.E.N GO - Clone of M.U.G.E.N. - Installs, Plays great
• - ja2.sh - Stracciatella - Jagged Alliance 2 engine - Installs, Plays great
• - jfsw.sh - Shadow warrior port - Installs and runs great
• - julius.sh - Caesar III source port - Installs, Plays great
• - kraptor.sh - Shoot em up scroller game - Installs Runs fine
• - lbreakout2.sh - Open Source Breakout game - Installs Runs fine
• - lgeneral.sh - Open Source strategy game - Installs Runs fine
• - lmarbles.sh - Open Source Atomix game - Installs Runs fine, screen is alitte off center
• - ltris.sh - Open Source Tetris game - Installs, Plays great
• - manaplus.sh - manaplus - 2D MMORPG Client - x86, cant test, was told it works
• - meritous.sh - Port of an action-adventure dungeon crawl game - Installs, Plays great
• - nblood.sh - Blood source port - Installs, Plays great
• - nkaruga.sh - Ikaruga demake. - Blocked from installing on Pi4
• - nxengine-evo.sh - The standalone version of the open-source clone/rewrite of Cave Story - Installs Plays fine on Pi4. Need to bind controller in options
• - openclaw.sh - Reimplementation of Captain Claw - Installs, Plays great
• - opendune.sh - Dune 2 source port - Installs Play sgreat,/W game, need to need to drop resolutions to lower for full screen
• - openjazz.sh - An enhanced Jazz Jackrabbit source port - Installs, Plays great
• - openjk_ja.sh - OpenJK: JediAcademy (SP + MP) - Installs, Plays great, didnt test MP
• - openjk_jo.sh - OpenJK: Jedi Outcast (SP) - Installs, Plays great
• - openmw.sh - Morrowind source port - Installs, Plays great
• - openra.sh - Real Time Strategy game engine supporting early Westwood classics - Installs, Plays great
• - openrct2.sh - RollerCoaster Tycoon 2 port - Installs, Plays great
• - pcexhumed.sh - PCExhumed - Powerslave source port - Installs, Plays great
• - piegalaxy.sh - Pie Galaxy - Download and install GOG.com games in RetroPie - Installs Runs, Cant login to test
• - pingus.sh - Lemmings clone - Installs, Plays great
• - pokerth.sh - open source online poker - Installs, Plays fine
• - prboom-plus.sh - Enhanced DOOM source port - Installs Plays great
• - prototype.sh - Free R-Type remake by Ron Bunce - Gamepad support incomplete. Installs, Plays fine, needs keyboard
• - pydance.sh - Open Source Dancing Game - Installs, Plays fine
• - quakespasm.sh - Another enhanced engine for quake - Installs, Plays fine Need to keep the resolution low for smooth play and full screen
• - rawgl.sh - Another World Engine - Installs, Plays great
• - rednukem.sh - Rednukem - Redneck Rampage source port - Installs, Plays great
• - relive.sh - Oddworld engine for Abe's Oddysee and Abe's Exoddus Installs Plays well, some graphic glitches
• - reminiscence.sh - Flashback engine clone - Installs, Plays fine
• - revolt.sh - REvolt - a radio control car racing themed video game - Installs, Plays fine
• - rickyd.sh - Rick Dangerous clone - Blocked from installing on Pi4
• - rigelengine.sh - RigelEngine - Duke Nukem 2 source port - Installs, Plays great/ with Demo
• - rocksndiamonds.sh - Rocks'n'Diamonds - Emerald Mine Clone - Installs, Plays great
• - rott-darkwar.sh - Rise of the Triad source port with joystick support - Installs
• - rott-huntbgin.sh - Rise of the Triad (shareware version) source port with joystick support. - Installs, Plays great
• - rtcw.sh- IORTCW source port of Return to Castle Wolfenstein. - Installs, and plays great
• - samtfe- Serious Sam Classic The First Encounter. - Installs, and plays great
• - samtse- Serious Sam Classic The Second Encounter. - Installs, and plays great
• - sdl-bomber.sh - Simple Bomberman clone - Installs, Plays great
• - seahorse.sh - a side scrolling platform game Installs Plays fine
• - septerra.sh - Septerra Core: Legacy of the Creator port Installs Plays fine
• - shiromino.sh - Tetris The Grand Master Clone Installs Plays fine
• - shockolate.sh - Source port of System Shock Installs Plays fine
• - simutrans.sh - freeware and open-source transportation simulator Installs Plays fine
• - sm64ex.sh - Super Mario 64 PC Port for Pi4 - Works extremely well on Pi 4. Installs Plays great
• - sorr.sh - Streets of Rage Remake port - Installs, Plays great
• - sorrv2.sh - Streets of Rage Remake port - Installs, Plays great
• - sqrxz2.sh - Sqrxz 2 - Two seconds until death - Installs, Plays great
• - sqrxz3.sh - Sqrxz 3 - Adventure For Love - Installs, Plays great
• - sqrxz4.sh - Sqrxz 4 - Cold Cash - Installs, Plays great
• - starcraft.sh - Starcraft - Installs, Plays great
• - supaplex.sh - Reverse engineering Supaplex - Installs, Plays great
• - vanillacc.sh - Vanilla-Command and Conquer - Installs, Plays great
• - vcmi.sh - Open-source engine for Heroes of Might and Magic III - Installs, Plays great
• - supertuxkart.sh - a free kart-racing game - Installs, Plays great at lower resolution
• - temptations.sh - Enhanced version of the MXS game - Installs
• - warmux.sh - Worms Clone - Installs
• - wesnoth.sh - Turn-based strategy game - Installs
• - wine.sh - WINEHQ - Wine Is Not an Emulator - Installs
• - xash3d-fwgs.sh - Half-Life engine source port. - Installs
• - xump.sh - The Final Run - Installs
• - zeldansq.sh - Zelda: Navi's Quest fangame - Installs, Plays great, Needs correct script to remove xinit errors

Supplementary

• - audacity.sh - Audacity open-source digital audio editor - Installs Runs fine
• - bezelproject.sh - Easily set up the Bezel Project Installs Runs fine
• - bgm123.sh - Straighforward background music player using mpg123. Currently limited to RPi into HDMI. Testers / collaborators welcome to help expand this functionality.
• - chromium.sh - Open Source Web Browser - Installs, Work well
• - epiphany.sh - epiphany lightweight web browser - Installs Runs fine
• - filezilla.sh - A cross platform FTP application - Installs Runs fine
• - firefox-esr.sh - FireFox-ESR - Formally known as IceWeasel, the Rebranded Firefox Web Browser - Installs Runs fine
• - fun-facts-splashscreens.sh - Set up some loading splashscreens with fun facts. Cant test dont have the right system x86
• - golang-1.17.sh - Golang v1.17 binary install Installs fine
• - gparted.sh - partition editing application Installs Runs fine
• - joystick-selection.sh - Set controllers for RetroArch players 1-4. Installs Does what it needs too
• - kodi-extra.sh - Kodi Media Player 16 with controller support as a separate system - Installs, works great
• - kweb.sh - Minimal kiosk web browser - Installs Runs fine
• - librecad.sh - librecad open-source 2d cad - Installs Runs fine
• - libreoffice.sh - Open source office suite - Installs Runs fine
• - mesa.sh - Mesa3d OpenGL and Vulkan Drivers - Installs fine
• - mpv.sh - Video Player - Not an actual emulator but allows you to play movies and tv shows from new systems in RetroPie. - Installs Runs fine
• - mixx.sh - Mixxx DJ Mixing Software App - Installs Runs fine
• - mypaint.sh - mypaint easy-to-use painting program - Installs Runs fine
• - omxplayer.sh - Video Player - Installs Runs fine
• - putty.sh - SSH and telnet client - Installs Runs fine
• - retroscraper.sh - Scraper for EmulationStation by kiro - Installs Runs fine
• - screenshot.sh - Take screenshots remotely through SSH - Tested and works well.
• - thunderbird.sh - Thunderbird — Software made to make email easier - Installs Runs fine
• - videolan.sh - VLC media player - Installs Runs fine
• - weechat.sh - Console IRC Client - Installs Runs fine, dont know how to quit

##Broken or dead scripts have been moved to to RetroPie-Extra-unstable

If you want to try and fix them, have at it

Hall of Fame - Scripts accepted into RetroPie-Setup

• - LXDE - LXDE Desktop.
• - SimCoupe - Sam Coupe Emulator.
• - Oricutron - Oric 1/Oric Atmos emulator.
• - sdltrs - Radio Shack TRS-80 Model I/III/4/4P emulator.
• - ti99sim - Texas Instruments 99A emulator.