Thisrepository Search

Pullrequests

Issues

Gist

RetroPie / RetroPieSetup
Code

Issues 54

Watch

Pullrequests 2

Wiki

Pulse

242

Star

2,325

Fork

310

Graphs

ManagingROMs

Edit

NewPage

InsecureSpikeeditedthispageonJan2461revisions

RetroPieusesforksoftheMAMEandFinalBurnAlphaemulatorsthatworkwellontheRaspberry

Pages

129

Pihardware,butarebasedonolderversionsoftheoriginalcode.YourROMsmaybeforearlieror
laterversionsofMAME/FBAandiftheyare,theymostlikelywillnotwork.

WikiHomePage

ThefollowingchartisaquickreferenceforallthearcadeemulatorsinRetroPie.

GettingStarted

Emulator

Romset

#ofROMs

.DATFiles

CompatibilityList

mame4all

0.37b5

2270

.DAT

List

lrimame4all

0.37b5

2270

.DAT

List

ControllerConfiguration

lrmame2003

0.78

4705

.DAT

List

Transferringgames(ROMs)

lrmame2010

0.139

8782

.DAT

List

RuncommandLaunchMenu

advmame.94

0.94

5563

.DAT

List

UpdatingRetroPie

advmame1.4

0.106

6166

.DAT

List

pifba

0.114(fba0.2.96.71)

684

.DAT

List

lrfba

0.154(fba0.2.97.30)

3369

.DAT

List

lrfbanext

0.167(fba0.2.97.37)

3970

.DAT

List

gngeopi

0.138

203

.DAT

List

FirstInstallation
WiFi
(RetroArch)
ScrapingGames
GettingtherightMAMEROMs
UsingSSH

Emulators
3do
AdventureGameStudio
Amiga
AmstradCPC
AppleII
AtariST/STE/TT/Falcon
Atari2600

Seealso:MAME,FBA

Atari5200and8bitseries
Atari7800

Thisiswhereclrmameprocomesin.ClrmameproisaWindowsutilityforverifyingandmanaging

AtariJaguar

yourROMs.ItcanalsorunonLinux,usingWine.Clrmameproisverypowerful,butalsosomewhat

AtariLynx

complexandnotfriendlytonewusers.
thereisalsoaMacversionavailablenowhttp://www.emulab.ititsonlyinBetaatthemoment,butit
worksexactlythesameastheWindowsutility

CoCo
Colecovision
Commodore64
Daphne
Dragon32
Dreamcast

Herearethestepstogettingstartedwithclrmamepro.

FinalBurnAlpha
Game&Watch

VideoTutorial:

GameGear
GameBoy
GameBoyColor
GameBoyAdvance
Intellivision
Macintosh
MAME
MasterSystem
Megadrive/Genesis
MESS
MSX
Nintendo64
NintendoDS
NintendoEntertainment

Requirements:

System
NeoGeo

NeoGeoPocket

ARaspberryPirunningaRetroPiev2.4.x,v2.5.xorv2.6.xSDcardimage.Otherimagesmay

NeoGeoPocketColor

work,buttheyhavenotbeentestedwiththeseinstructions.AllyouneedfromtheRetroPie

PC

imagearetheDATfiles(explainedbelow).

PCEngine/TurboGrafx16
PSP

AWindowsPCforsettingupRetroPieandrunningclrmamepro.Thistutorialassumesyouare

PlayStation1

runninga64bitversionofWindows,butthestepsfor32bitWindowswillbethesameonce

Saturn

yougetpastdownloadingtheclrmameprosoftware.

ScummVM
Sega32X
SegaCD

Step1BackupyourROMs

SegaSG1000
SuperNintendoEntertainment
System

Itispossiblewithclrmameprotochangeoneortwooptionsandwhenitrunsitwilldeleteallyour

Vectrex

existingROMs.OK,notreallyusingthedefaultoptionsitwillmakebackupsofanyfilesit

Videopac/Odyssey2

removes,butIhaveseenalotofpeoplewhengettingstartedmessuptheirROMsbeyondrepair.

VirtualBoy
WonderSwan
WonderSwanColor

Step2Downloadclrmamepro
Theversionatthetimeofthisarticleis4.016.Iwouldrecommendthe64bitversionifyouare
runninga64bitOS,itwillbesignificantlyfaster.Iwouldalsorecommendthezipversion,just
extractittoC:\clrmamepro.There'snoneedtoruntheinstaller.

Zmachine
ZXSpectrum

Ports
Baldur'sGate
CaveStory
CommanderKeen

Step3AcquireDATfiles

Descent
DOOM
DukeNukem3D

DATfilesaretheXMLbaseddatabasedefinitionsoftheexactROMsanemulatoruses.Usingthe
DATfilesandCRCchecks,clrmameproisabletoidentifywhichofyourROMsarevalidforagiven
emulator.
Youcandownloadall.DATfilesforallarcadeemulatorsHERE
Forthistutorial,extractthezipfileintoC:\(butyoucanreallyputitanywhereyouwant)

EasyRPGPlayer
Giana'sReturn
Lincity
Lve
KODI
Marathon
Micropolis
MinecraftPiEdition

Openretropiedatmasterandyoushouldseealistoffolders.Eachfoldercontainsthe.DAT

OpenBOR

filesfortherespectiveemulator.WewillonlybeusingC:\retropiedatmaster\mame4all\MAME

OpenTTD

0.37b5.datinthistutorial.

CreateasubdirectoryC:\retropiedatmaster\mame4allroms(thiswillbeusedinthenext

OpenTyrian
OutRunEngine
QuakeSeries

step)

ResidualVM

CreateasubdirectoryC:\retropiedatmaster\pifbaroms

RickDangerous

Step4Runclrmameproforthefirsttime

PrinceofPersia
SuperMarioWar
SuperTux
TheUrQuanMasters
Warcraft/Starcraft

RunC:\clrmamepro\cmpro64.exe.Thewelcomescreenexplainsthatcommonfirststepsareto

Wolfenstein3D

1)CreateaProfile,2)Setupyourpathsand3)ScanyourROMs.Wewillbedoingthings

ZeldaEngine

slightlydifferently,inordertoleaveyoursourceROMsintact.
ClickOKtotheWelcomescreen
Click"AddDatFile..."andopentheMAME4ALLDATfileatC:\retropiedat

Advanced
Configuration

master\mame4all\MAME0.37b5.dat

CustomSplashScreens

Acceptthedefaultprofilelocationof[PROFILES],click"OK"

EmulationStationThemes

Select"[NEWDATFILES]"inthelefthandpaneandselect"MAME0.37b5"intherighthand
pane

ConfigurationEditor
Netplay
Overclocking

Click"Load/Update"

MemorySplit

Clrmameprowillaskyouhowtogeneratethesettingsforthisdatfile,click"Default"(itis

ManualInstallation

possibleitwillthrowawarningbutjustselect"oktoall"andcontinueon)
Youarenowatthemainwindowforclrmamepro.Westillneedtosetourpaths,soclick

Odroid
ArchLinux
Ubuntu15.10x86

"Settings"

RetroPieinstallforOSMCwith

Verify"ROMPaths"istheselectedoptionintheupperleftcornerdropdownmenu

externalmemoryUSBDrive

Clickthe"Add..."button

FavoritesandChildfriendly
EmulationStation

SelectthefolderyoucreatedinthelaststepcalledC:\retropiedatmaster\mame4allromsand
click"OK"
Closethesettingswindowwiththe"X"buttonintheupperright
Atthispoint,youcouldscantheROMsfolderyoujustselected,butwejustcreatedthisfolderand
itisempty.Instead,wewillrebuildintothisfolder.Clrmameprocanscanotherlocationsfor
matchingROMsandbuildanewROMsetfromthem.

Controllers
XBox360Controller
PS3controller
N64controller
Bluetoothcontroller
SmartphoneGamepad
Wiimotes
WiiUProController(Debian

Step5RebuildaROMset
Inthemainclrmameprowindow,select"Rebuilder"

jessieonly)
XinMoDriver
GPIOControllerModules

Troubleshooting

ThedestinationshouldalreadybefilledinforyouitisthesameastheROMpathyou
definedaboveinthesettingswindow:C:\retropiedatmaster\mame4allroms

SoundIssues
SpeedIssues

Usethebrowsebutton"..."toselectyoursourcepath.Forexampleyoumighthaveafullset

VideoIssues

ofMAMEv0.156ROMspointclrmameprotothatdirectoryasyoursource.

FAQ

Whenrebuildingtherearethreeoptions:MergedSet,SplitSet,andNonMergedSet.
(NOTE:Asaprerequisiteyouneeda.datfilethatcontainsmergedatafortheromset.For

Clonethiswikilocally

https://github.com/RetroPie/RetroPie

bestresultsbuildfromafullromset.)
CloneinDesktop

MergedSet:Intheoryamergedsetmergesallclonesintotheparentfolder(notthemost
effectiveuseofspacebutifyoucanaffordthespaceitisaneasywaytocleanupyour
romlistsotherearen'tcloneseverywhere)
SplitSet:asplitsetsplitstheparentsandclonesintotheirownfolders(thisisabit
messierasyouhavelotsofclonesthatalsoneedaparentromsetinthesameromfolder
asthecloneromsetinorderforittowork)
NonMergedSet:anonmergedsetcopiestheneededparentfilesintoeachclone's
foldersoyoucandeletetheparentandintheorythecloneshouldstillwork.(Thisisalso
notaveryeffectiveuseofspacebutgivesyouthefreedomtoplaycloneswithout
worryingaboutneedingtheparentromsetinthesameromfolder.)
Click"Rebuild...".Dependingonthesizeofthedirectoryyourchoseasasource,thiscould
takesometime
Whenclrmameproisfinishedrebuilding,youwillseeawindowwithstatisticsshowinghow
manymatchingfileswerefound,howmanyfileswerecreatedandhowmanywereskipped.
Click"OK"
Repeatforanyothersourcepathsyoumighthave.Youcanrebuildfrommultiplesources,but
leavetheDestinationpaththesame
Whenfinished,closetheRebuilderwiththe"X"intheupperrightcornerofthewindow
TimetofindouthowwellyoursourceROMsmatchedup...

Step6ScanaROMset
Inthemainclrmameprowindow,select"Scanner"
Leaveallsettingsatdefaultandclick"NewScan..."
Whenclrmameprofinishesscanning,youwillseea"Statistics"windowwithhighlevel
informationanda"ScanResults"windowwithdetailedinformationaboutyourmissingROMs

RepeatSteps4through6fortheFBAROMset
Fromclrmamepro"Profiler"windowloadtheDATfileforPiFBAC:\retropiedat
master\pifba\fba_029671_od_release_10_working_roms.dat

Fromclrmamepro"Settings"windowssettheROMpathtoC:\retropiedatmaster\pifbaroms

Useclrmamepro's"Rebuilder"torebuildyourexistingROMstoanewROMset
ScantherebuiltROMsusingthe"Scanner"

Notes
That'sthebasicsofusingclrmamepro.Someadditionalnotes:
Becarefulwiththe"Fix"settingsintheScannerwindowandthe"RemoveMatched
Sourcefiles"settingintheRebuilderwindow.Thesesettingswillremoveandrenameyour
ROMs.
IfclrmameprodoesdeleteanyROMs(becauseyoutolditto),youshouldbeabletofind
backupsinC:\clrmamepro\backupaslongasyoudidn'tchangethedefaultsettings.
clrmameproisverystable.Ithasbeenaroundforalongtime,itisregularlyupdatedanditis
widelyused.IfitreportsproblemsreadingyourROMs,youmostlikelyhavecorruptROM
archives(zipfiles)orafailingharddrive.
Ifyoufeeltheneedtoresetclrmamepro'ssettings,justdeleteyourexistingprofile(s)and
reloadyourDATfile,selecting"Default"settingsforthenewprofile.Almostallof
clrmamepro'ssettingsareperprofile.

ListofEmulatorsandTheirRespective
Romsets:
RetroPie3.0.0MAMEVersions
ThesedetailsareasperthedefaultinstalledbinariesontheRetroPie3.0.0image.
Important
In3.0.0someemulatorssharedirectories,soyouneedtochoosewhichFBA,NeoGeoand
mame4allversionyouwant.Soyoucanhave1romsetforeachofthese(mame4all,FBA,
NeoGeo,advmame)
SeehereforRetroPie2.6

mame4allpi
RomsDir:/home/pi/RetroPie/roms/mamemame4all
BinaryDir:/opt/retropie/emulators/mame4all
ConfigDir:/opt/retropie/configs/mamemame4all

MAMEVersion:Basedon0.37b5(July2000)
Size:1.86GB
Romsetsemulated:2270(includesclonesetc..)
ActiveSets2241/2241
Parents560/560
Clones990/990
Others690/690
BIOS1/1
DatFile:mame4all037b5RetroPie260.zip

DatFile(withmergedata):MAME0.37b5.dat
DatFile(noclones,noneogeo):mame4allnoclonesnoneogeo
MAME4ALLPICOMPATIBILITYLISTfeelfreetocontributetothelist.

lrimame4all
RomsDir:/home/pi/RetroPie/roms/mamemame4all
BinaryDir:/opt/retropie/libretrocores/lrimame4all
ConfigDir:/opt/retropie/configs/mamemame4all/retroarch.cfg

MAMEVersion:Basedon0.37b5(July2000)
Size:1.86GB
Romsetsemulated:2270(includesclonesetc..)
ActiveSets2241/2241
Parents560/560
Clones990/990
Others690/690
BIOS1/1
DatFile:mame4all037b5RetroPie260.zip
DatFile(withmergedata):MAME0.37b5.dat
DatFile(noclones,noneogeo):mame4allnoclonesnoneogeo
lrIMAME4ALLCOMPATIBILITYLISTfeelfreetocontributetothelist.

lrmame2003
RomsDir:/home/pi/RetroPie/roms/mamelibretro
BinaryDir:/opt/retropie/libretrocores/lrmame2003
ConfigDir:/opt/retropie/configs/mamelibretro/retroarch.cfg

MAMEVersion:Basedon0.78(December2003)
Romsetsemulated:4705(includesclonesetc..)
ActiveSets4705/4705
Parents1042/1042
Clones2039/2039
Others1624/1624
BIOS1/1
DatFile(withmergedata):MAME0.78.dat
DatFile(workingonly,noclones):mame2003lrworkingnoclones
DatFile('lite'set:working,noclones,neogeo,PlayChoice(NESmultiplay),no
rotary/dial/trackball/lightguncontrols,no
casino/multiplay/quiz/mahjong/fruit_machines/rhythm/mature):mame2003lrlite(No.roms:1615)
lrmame2003COMPATIBILITYLISTfeelfreetocontributetothelist.

lrmame2010

RomsDir:/home/pi/RetroPie/roms/mamelibretro
BinaryDir:/opt/retropie/libretrocores/lrmame2010
ConfigDir:/opt/retropie/configs/mamelibretro/retroarch.cfg

MAMEVersion:Basedon0.139(August2010)
Romsetsemulated:8782(includesclonesetc..)
ActiveSets8782/8782
Parents1835/1835
Clones4265/4265
Others2683/2683
BIOS1/1
DatFile(withmergedata):MAME0.139.dat
lrmame2010COMPATIBILITYLISTfeelfreetocontributetothelist.

AdvanceMAME0.94.0and1.4
RomsDir:/home/pi/RetroPie/roms/mameadvmame
BinaryDir:/opt/retropie/emulators/advmame/bin
ConfigDir:/opt/retropie/configs/mameadvmame

MAMEVersion:BasedonMAME0.94(March2005)or(for1.4)BasedonMAME0.106(May
2006)
Size:11.6GB(0.94.0)Size:14.8GB(1.2)
RomsetsEmulated:5563(0.94.0)6166(1.2)(includesclonesetc..)
ActiveSets(For0.94.0)5563/5563
Parents1236/1236
Clones2473/2473
Others1829/1829
BIOS25/25
ActiveSets(For1.4)6166/6166
Parents1388/1388
Clones2824/2824
Others1928/1928
BIOS26/26
DatFile:advmame0.94RetroPie260.7z
AdvMame.94COMPATIBILITYLISTfeelfreetocontributetothelist.
DatFile:advmame12106.7z
AdvMame1.4COMPATIBILITYLISTfeelfreetocontributetothelist.

PiFBA
RomsDir:/home/pi/RetroPie/roms/fba
BinaryDir:/opt/retropie/emulators/pifba
ConfigDir:/opt/retropie/configs/fba/fba2x.cfg

MAMEVersion:FBA0.2.96.71whichisbasedonMAME0.114(April2007)
Size:3.62GB
Romsetsemulated:684(noclones)
DatFile:fba_0.2.96.71_clrmame_dat.zip
DatFile(Withmergedata):FBAlphav0.2.96.71(ClrMamePro).dat
Allclones(currenttested)nonworking\mahjong\quiz\adult\casino\rythmremoved
Romsetsemulated:291
DatFile:fba_029671_od_release_10_working_roms_filtered.zip
PiFBACOMPATIBILITYLISTfeelfreetocontributetothelist.

lrfba
RomsDir:/home/pi/RetroPie/roms/fba
BinaryDir:/opt/retropie/libretrocores/lrfba
ConfigDir:/opt/retropie/configs/fba/retroarch.cfg

MAMEVersion:FBA0.2.97.30whichisbasedonMAME0.154(Jul2014)
Size:9.15GB
Romsetsemulated:3369(includesclonesetc..)
ActiveSets3369/3369
Parents710/710
Clones2146/2146
Others508/508
BIOS5/5
DatFile:FBAlphav0.2.97.30.dat.zip
NeoGeoOnly.DatFile:fbalrneogeo
lrfbaCOMPATIBILITYLISTfeelfreetocontributetothelist.

lrfbanext
RomsDir:/home/pi/RetroPie/roms/fba
BinaryDir:/opt/retropie/libretrocores/lrfbanext
ConfigDir:/opt/retropie/configs/fba/retroarch.cfg

MAMEVersion:FBA0.2.97.37whichisbasedonMAME0.167(April2015)
Romsetsemulated:3970(includesclonesetc..)
ActiveSets3970/3970
Parents837/837
Clones2583/2583
Others550/550
BIOS6/6
DatFile:FBAlphav0.2.97.37.dat.zip

lrfbanextCOMPATIBILITYLISTfeelfreetocontributetothelist.

GnGeo0.8
RomsDir:/home/pi/RetroPie/roms/neogeo
BinaryDir:/opt/retropie/emulators/gngeopi/bin
ConfigDir:/opt/retropie/configs/neogeo

MAMEVersion:Basedon0.138romsets(May2010)
Romsetsemulated:203
DatFile:pandora_gngeo_084_dat.zip
Allclonesnonworking\mahjong\quizremoved
Romsetsemulated:128
DatFile:pandora_gngeo_084_filtered.zip
GnGeoPiCOMPATIBILITYLISTfeelfreetocontributetothelist.
ListcourtesyofFloob

TheRetroPieProject
About

Forum

SetupScript

2016GitHub,Inc. Terms Privacy Security Contact Help

Status API Training Shop Blog About