3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki
Thisrepository Search

Pullrequests

Issues

Gist

RetroPie / RetroPieSetup
Code

Issues 59

Pullrequests 3

Watch

Wiki

Pulse

239

Star

2,293

Fork

306

Graphs

FirstInstallation

Edit

NewPage

HerbFarguseditedthispage8daysago65revisions

Pages

126

WikiHomePage
GettingStarted
FirstInstallation

Version
3.6

WiFi
ControllerConfiguration
(RetroArch)
Transferringgames(ROMs)
ScrapingGames

1.Hardware

RuncommandLaunchMenu

2.Installation

GettingtherightMAMEROMs

3.ControllerConfiguration
4.ConfigureWifi
5.TransferringRoms

UpdatingRetroPie
UsingSSH

Emulators

Congratulations!YouhavediscoveredthewonderfulworldofRetroPieyourentirechildhoodis

3do

withinreach!RetroPieisacombinationofmultipleprojectsincludingRetroArch,EmulationStation,

AdventureGameStudio

andmanyothers.
ThispageisforpeoplejustgettingstartedonRetroPie3.6.TheeasiestwaytoinstallRetroPieis
theSDimagewhichisareadytogosystembuiltupontopoftheRaspbianOSthisisthemethod
describedinthefollowingguide.Alternatively,advanceduserscaninstallRetroPiemanually.

Amiga
AmstradCPC
AppleII
AtariST/STE/TT/Falcon
Atari2600
Atari5200and8bitseries
Atari7800

ThisguidewillgiveyoutheverybasicstogetyouupandrunningfromablankSDcardtofirstboot

AtariJaguar

intoEmulationStation.

AtariLynx

Ifyouhatereadingthenseethisvideo.Otherwisereadon!

Colecovision

CoCo
Commodore64
Daphne
Dragon32
Dreamcast
FinalBurnAlpha
Game&Watch
GameGear
GameBoy
GameBoyColor
GameBoyAdvance
Intellivision
Macintosh

HardwareNeeded:
RaspberryPi(A,A+,B,B+,2,Zero,or3)forbestperformanceuseaRaspberryPi3Model

MAME
MasterSystem
Megadrive/Genesis
MESS
MSX

Nintendo64

RaspberryPiCase(optionalbutrecommended)

NintendoDS

MicroSDCard(seecompatibleSDcardlisthere)

NintendoEntertainment

MicroSDCardReader(Forinstallingretropiefromyourcomputer)

System
NeoGeo

HDMIcableor4PoleRCAto3.5mmCable(HDMIworksbest)

NeoGeoPocket

TelevisionorComputerMonitorreallyanyscreenwithHDMIorRCAports

NeoGeoPocketColor

WifiDongleorEthernetCable(WifiDongleismoreconvenientseecompatiblelisthere)

PC

https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

PCEngine/TurboGrafx16

1/9

3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki

5V2AMicroUSBPowerSupply

PSP

USBKeyboardandMouse(togetthingssetuporyoucanuseSSH)

PlayStation1

USBGameControllerofyourchoice(oryoucangettheControlBlocktouseoriginalSNES
controllers)

Saturn
ScummVM
Sega32X
SegaCD

ThesimplestwaytogetmostofthesecomponentsisthroughakitsuchastheCanakit.

SegaSG1000
SuperNintendoEntertainment

Installation

System
Vectrex
Videopac/Odyssey2
VirtualBoy

SDImages
TherearecurrentlytwoversionsofRetroPie3.6.ThereisoneversionforRaspberryPi1/Zero
(ModelA,A+,B,B+)andthereisaversionforRaspberryPi2/RaspberryPi3.DownloadtheSD
imageforyourversionofRaspberryPi:
RaspberryPi1/Zero

WonderSwan
WonderSwanColor
Zmachine
ZXSpectrum

Ports
Baldur'sGate
CaveStory

RaspberryPi2/RaspberryPi3

CommanderKeen
Descent

(Iftheselinksbecomeoutdatedseethedownloadspagehere.)

DOOM
DukeNukem3D

IfyouareunsurewhichversionofRaspberryPiyouhavethereisaneasywaytocheck:

Giana'sReturn
Lincity

Rpi1/Zero=1raspberrywhenthepibootsup

Lve
KODI

Rpi2/Rpi3=4raspberrieswhenthepibootsup

Marathon

IfyougettheerrorIllegalInstructionwhenitboots,youpickedthewrongSDimage.

MinecraftPiEdition

Extract

Micropolis
OpenBOR
OpenTTD
OpenTyrian
OutRunEngine

OnceyouhavedownloadedyourSDcardimageyouneedtoextractitusingaprogramsuchas7
Zip.Youwillextractthedownloaded.gzfileandtheextractedfilewillbea.imgfile.

QuakeSeries
ResidualVM
RickDangerous
PrinceofPersia

InstallRetroPieImageonSDCard

SuperMarioWar

ToinstalltheRetroPie3.6SDimageonyourMicroSDcard.(YoumayneedaMicroSDcardreader

TheUrQuanMasters

toplugitintoyourcomputer)
1.ForWindowsyoucanuseaprogramcalledWin32DiskImager
2.FormacyoucanuseApplePiBaker
3.ForLinuxyoucanuseddcommandorUnetbootin
Ifyou'reupdatingfromapreviousversionofretropieseeHERE

SuperTux
Warcraft/Starcraft
Wolfenstein3D
ZeldaEngine

Advanced
Configuration
CustomSplashScreens
EmulationStationThemes
ConfigurationEditor

Configurations

Netplay
Overclocking
MemorySplit
ManualInstallation

ControllerConfigurations

Odroid
ArchLinux
Ubuntu15.10x86

Whenyoufirstbootupyouwillbewelcomedwiththefollowingscreenunlikesomeolderversions
ofretropie,thismenuwillconfigureyourcontrolsforbothEmulationstationandRetroArch
Emulators:

RetroPieinstallforOSMCwith
externalmemoryUSBDrive
FavoritesandChildfriendly
EmulationStation

Controllers
XBox360Controller
PS3controller
N64controller
Bluetoothcontroller
SmartphoneGamepad
Wiimotes
WiiUProController(Debian

https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

2/9

3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki
jessieonly)
XinMoDriver
GPIOControllerModules

Troubleshooting
SoundIssues
SpeedIssues
VideoIssues
FAQ

Clonethiswikilocally

https://github.com/RetroPie/RetroPieSetup.wi

CloneinDesktop

Holddownanybuttononyourkeyboardorgamepadandthenamewillappearatthebottomand
thenopenupintoaconfigurationmenu:

Followtheonscreeninstructionstoconfigureyourgamepadifyourunoutofbuttonsjusthold
downabuttontoskipeachunusedbutton.WhenyougettoOKpressthebuttonyouhave
configuredas"A".

Ifyouwishtoconfiguremorethanonecontroller,youcandosofromthestartmenuof
emulationstation.FormoredetailsonmanualcontrollerconfigurationsseethispageHere.See
alsoHERE
https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

3/9

3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki

Seethefollowingdiagramsforreference:

https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

4/9

3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki

DefaultHotkeys
Hotkeysenableyoutopressacombinationofbuttonstoaccessfunctionssuchassaving,loading,
andexitingemulators.Thefollowingchartshowsthedefaulthotkeycombinations.Bydefault,the
hotkeyisselectsothatmeansyouholddownselectwhilepressinganotherbuttontoexecutea
command.
Hotkeys

Action

Select+Start

Exit

Select+RightShoulder

Save

Select+LeftShoulder

Load

Select+Right

InputStateSlotIncrease

Select+Left

InputStateSlotDecrease

Select+X

RGUIMenu

Select+B

Reset

Forthosethatareinterested,theretroarchcontrollerconfigthatiscreatedafteryou'vefollowedthe
aforementionedstepsislocatedin:
/opt/retropie/configs/all/retroarchjoypads

thefollowingisanexampleofaSNEScontrollerconfigyourconfigurationsmaybeabitdifferent.
input_device="USBgamepad"
input_driver="udev"
input_r_btn="5"
input_save_state_btn="5"
input_start_btn="9"
input_exit_emulator_btn="9"
input_l_btn="4"
input_load_state_btn="4"
input_up_axis="1"
input_a_btn="1"
input_b_btn="2"
input_reset_btn="2"
input_down_axis="+1"
input_right_axis="+0"
input_state_slot_increase_axis="+0"
input_x_btn="0"
input_menu_toggle_btn="0"
input_select_btn="8"
input_enable_hotkey_btn="8"
input_y_btn="3"
input_left_axis="0"
input_state_slot_decrease_axis="0"

EmulationStation
Wherearethesystems?
WhenyoufirstseeEmulationStationyoumaywonderwhyyoudon'tseesystemslike
theSNESorGameBoyworrynottheyareinstalledonthesystem,romsjustneedto
beaddedtotheirrespectiveromfoldersbeforetheywillbecomevisible.Transferring
romsaredescribedinthefollowingsteps.

https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

5/9

3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki

ConfiguringWifi
IfyouwishtouseawifidongletotransferromsoverthenetworkratherthanaUSBstickor
Ethernetcableyou'llneedtosetupyourwifiwhichcanalsobedonefromtheRetropiemenuin
emulationstation:

Itwillopenintothismenu:

https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

6/9

3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki

ChooseyourSSIDfromalist:

TypeyourWifiPassword(Youmayneedtowaitabitafteryoufinishfortheconfigurationstosave)

Afterit'sdoneconfiguringyoushouldseeyourwifiinfointheoriginalmenu:

FormoreWiFiconfigurationoptionsseethispageHERE
https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

7/9

3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki

TransferringRoms
Duetothenature/complexityofCopyright/IntellectualPropertyRightsLaw,whichdiffers
significantlyfromCountrytoCountry,ROMscannotbeprovidedwithRetroPieandmustbe
providedbytheuser.YoushouldonlyhaveROMsofgamesthatyouown.
Therearethreemainmethodsoftransferringroms:

USB
(ensurethatyourUSBisformattedtoFAT32orNTFS)
firstcreateafoldercalledretropieonyourUSBstick
plugitintothepiandwaitforittofinishblinking
pulltheUSBoutandplugitintoacomputer
addtheromstotheirrespectivefolders(intheretropie/romsfolder)
plugitbackintotheraspberrypi
waitforittofinishblinking
refreshemulationstationbychoosingrestartemulationstationfromthestartmenu
seethisvideoforreference:

FTP(needsanactiveinternetconnection)
Wired(needsethernetcable)
Wireless(needswifidongle)TherearemanyFTPprogramsoutthere,forwindowsmany
peopleuseWinSCPformacyoucanusesomethinglikeCyberduck

Youcanalsologinasrootifyouwishtochangemorefilesthanjusttheroms,butyoufirstneedto
enabletherootpasswordwhichisexplainedhere

SambaShares(needsanactiveinternetconnection)
ifonwindowstype\\retropieintothecomputerfolder.Youcanalsoreplaceretropiewith
yourRaspberryPi'sIPaddress

https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

8/9

3/17/2016

FirstInstallationRetroPie/RetroPieSetupWiki

ifonMACOSXopenfinder,select"Go"menuand"ConnecttoServer".Typesmb://retropie
andhit"Connect".

PLAY!
Afteryou'veaddedyourromsyouneedtorestartemulationstationinorderforthemtoshowup.
Youcanrestartemulationstationfromthestartmenu,orbyrebootingyourpiwithsudoreboot.
seetherestofthewikiformoredetailedinformationonindividualemulators,advanced
settingsetc.Ifyoustillcan'tfigureitout,theRetroPiecommunityisveryhelpfulontheforum.
TheRetroPieProjectisprimarilymaintainedbyafewdeveloperswhodevelopthe
projectintheirfreetime.IfyouhavefoundtheRetroPieprojectusefulpleaseconsider
donatingtotheprojecthere.WewillalwaysreleaseRetroPieforfree,butunfortunately
ourserversstillcostmoney.AsyoubecomemorefamiliarwithRetroPie,payitforward
byhelpingothersontheforum.TheRetroPieProjectiswhatitistodaybecauseofthe
manycontributionsofthecommunity.
THANKYOU!

TheRetroPieProject
About

Forum

SetupScript

2016GitHub,Inc. Terms Privacy Security Contact Help

https://github.com/RetroPie/RetroPieSetup/wiki/FirstInstallation

Status API Training Shop Blog About

9/9