RETROPIE INSTALLATION

GUIDE

THE FOLLOWING GUIDE WILL COVER THE

INSTALLATION, SETUP AND CONFIGURATION OF THE

RASPBERRY PI, RASPBIAN OS AND RETROPIE

Author: http://rpiarcadebuild.wordpress.com/

Version: June 2014.

CONTENTS

Introduction ........................................................................................................................................................................................ 2

Considerations and Notes .............................................................................................................................................................. 2

What you need for this guide ......................................................................................................................................................... 2

Hardware:................................................................................................................................................................................... 2

Software ..................................................................................................................................................................................... 2

Optional ...................................................................................................................................................................................... 3

Step 1: Raspberry Pi Hardware Setup ................................................................................................................................................. 4

Step 2: SD Card Setup Transferring NOOBS ..................................................................................................................................... 5

SD Card Formatting ........................................................................................................................................................................ 5

Transferring NOOBS ....................................................................................................................................................................... 5

Step 3: Raspbian OS Installation ......................................................................................................................................................... 6

Optional Step: Connect to your RPi Remotely ................................................................................................................................ 7

Step 4: Raspbian OS Configuration ..................................................................................................................................................... 8

raspi-config ..................................................................................................................................................................................... 8

STEP 5: Updating the Raspbian OS .................................................................................................................................................... 10

INTRODUCTION

This guide will cover the installation and setup of your Raspberry Pi for use as a retro gaming machine. The guide is in sequential

order, just continue reading.

Firstly, the Raspberry Pi will be setup, and then the operating system known as Raspbian OS will be installed. Secondly, RetroPie

will be installed with a script, and then we will do some basic configuration.

WHAT IS RETROPIE?

*placeholder*

CONSIDERATIONS AND NOTES

Each step in the guide will start on a new page, making it easier to navigate.

Throughout the guide are red NOTE sections (like the one above) which highlight important information.

Setup a separate folder on your computer for the raspberry pi, then setup separate folders for downloads, software,

images, roms, configuration files and backups.

This guide takes some time, get some food, coffee and play some background music.

This guide does not cover the setup of joysticks, do a Google search or check out the RetroPie forums

This guide takes the long route, this is because many RPi owners also purchase a NOOBS pre-installed SD card, this

guide considers those users so that they can install the OS from the SD card and continue from there. If you want an

easier installation, see Note: Super Easy Mode above.

WHAT YOU NEED FOR THIS GUIDE

HARDWARE:

1. Windows PC

I used Windows 8

2. Raspberry Pi Model B

I used the revision with 512mb RAM

3. Power Adapter

For the Raspberry Pi, I suggest a 5v 1500mA to provide enough power

4. Monitor, Keyboard and Mouse

If you have a spares this saves some hassle, however the guide will explain the process of connecting remotely to the

Raspberry Pi (see Optional Step: Connect to the RPi via LAN)

5. SD Card and SD Card Reader

The SD Card should be a suitable size for the installation and your roms, minimum of 6GB suggested on the RPi

Website, I used a 32GB Class 10 SD Card.

6. RJ45/Ethernet Cable

You need to connect the Pi to the internet for this guide.

7. HDMI or RCA Cable

For video output.

SOFTWARE

NOTE: NOOBS SD Card Owners

If you have a NOOBS pre-installed SD card then you do not need an additional SD card or the SD

card reader (though having one is very useful).

In addition, you can skip Step 2: SD Card Setup Transferring NOOBS

NOTE: Super Easy Mode

RetroPie and PiPlay both have pre-installed images with everything ready to go, these include

the Raspbian OS. Check out the websites for more information.

1. NOOBS Offline and Network Install

http://downloads.raspberrypi.org/NOOBS_latest

2. SD Formatter v.4.0

https://www.sdcard.org/downloads/formatter_4/

3. USB Stick/SD Card Image Writer

http://sourceforge.net/projects/win32diskimager/

OPTIONAL

Raspberry Pi Case keeps it safe from any accidents that may occur, makes it a bit sturdier and makes it look nice.

PuTTY a terminal emulator that allows you to connect remotely to the RPi via SSH.

http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

NOTE: Shutting down your RPi

http://www.raspberrypi.org/help/faqs/

Failure to shut down the Raspberry Pi correctly may corrupt your SD card, and you will have to re-image it.

If you are in the graphical environment, either exit to the bash prompt or open the terminal. From the bash prompt or

terminal shut down the Raspberry Pi by entering:

sudo halt -h

Wait until all the LEDs except the power LED are off, then wait an additional second to make sure the SD card can finish its

wear levelling tasks and write actions. You can now safely unplug the Raspberry Pi.

STEP 1: RASPBERRY PI HARDWARE SETUP

Probably the easiest part of this guide, plugging everything in:

1. Place your RPi somewhere suitable.

2. Plug the keyboard and mouse into the USB ports.

3. Plug the HDMI cable or RCA cable into the correct output on the RPi.

4. Plug the RJ45/Ethernet cable into the LAN port.

No need for power or the SD card just yet, move on to the next step to setup a fresh SD card.

STEP 2: SD CARD SETUP TRANSFERRING NOOBS

*SKIP THIS STEP IF YOU HAVE A PRE-INSTALLED NOOBS SD CARD*

This step will format the SD card and transfer the NOOBS installation files to the card.

SD CARD FORMATTING

1. Plug in your SD card reader

2. Plug your SD card into the reader

o Make sure the SD card shows in Windows.

3. Run SDFormatter, the following screen will show:

4. Make sure to choose the correct drive!

5. Click on Option

o You can adjust Format Type to what you like, I choose QUICK to save time.

o Make sure Format Size Adjustment is set to ON.

This option formats the entire SD card.

o Click OK

6. Now click Format

o The program may advise you that data may be retrieved with a quick format, as I am the only one who is likely to

use this SD card I am happy with that. Click OK

o Are you sure you want to format? yes I am, click OK

o A status box will appear confirming that the card has been formatted.

7. Close SDFormatter

So we now have an empty SD card to work with, now to get NOOBS on there.

TRANSFERRING NOOBS

You should have the NOOBS archive downloaded (the version I used was NOOBS_v1_3_5).

1. Open the NOOBS zip archive.

2. Open your SD Card in windows.

3. Move the entire contents from the NOOBS archive to the SD Card.

If that worked, you now have an SD card that you can plug into your RPi, move onto the next step to install the operating

system.

STEP 3: RASPBIAN OS INSTALLATION

So you should have your NOOBS SD card ready to go.

1. Make sure the monitor, keyboard, mouse and RJ45/Ethernet cable are plugged into the RPi

2. Plug the SD card into the RPi

3. Plug your power cable into the RPi

a. The RPi will now start booting

4. The NOOBS installer should load and you should see a GUI on your monitor

5. Tick the box next to Raspbian from the list

6. At the bottom of the screen are two dropdown boxes; language and keyboard. Adjust these now according to your

country and keyboard setup

7. Click Install

Raspbian is now installing and should show a progress bar. Once the operating system is installed, the RPi should reboot into the

Raspberry Pi Software Configuration Tool, also known as raspi-config.

Now for Step 4: Raspbian OS Configuration and Update

NOTE: Connecting to your RPi remotely

Raspbian has a neat piece of software that runs during boot that allows you to connect remotely to it via SSH. This means

you can disconnect your monitor, keyboard and mouse from the RPi and go back to your main PC, from there you can run a

great piece of software that will connect to the RPi via SSH and emulate the terminal, allowing you to control everything

from the comfort of your PC. Go to the next page for more information.

OPTIONAL STEP: CONNECT TO YOUR RPI REMOTELY

Once the OS is installed, you can actually connect to the RPi via SSH (if you know the IP for the RPi).

This allows you to complete the remaining steps of the guide from the comfort of your own computer, this step is optional but

makes things easier if you only have the one monitor/keyboard/mouse setup.

On your Windows PC do the following:

1. Download Putty

a. Go to http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

b. Download PuTTY.exe

2. Find the IP Address of the Pi

Two options here, a. or b.

a. Run a cmd terminal from the start menu

i. Type arp a and hit enter, a list of IP addresses on the network should show, one of these will be the

RPi.

b. Login to the web based GUI of your router - Normally this will be the gateway IP such as 192.168.0.1

i. Find the list of attached devices connected to the LAN. The RPi will show as raspberrypi and the IP

address should show.

3. Run Putty

a. Run the PuTTY application downloaded earlier.

b. Enter the IP address for the RPi

c. Make sure SSH is selected

d. Click Open

i. Now, login to the RPi -

username: pi

password: raspberry

You should now be greeted with the following

You have successfully logged in over the network!

Now for the next step, you will need to run raspi-config, in the putty terminal, enter the following:

sudo raspi-config

Now go to the next step Step4: Raspbian OS Configuration

STEP 4: RASPBIAN OS CONFIGURATION

Once the OS has installed you will be greeted with raspi-config, a configuration utility that runs inside the terminal. From here,

you have a number of options for configuring your Raspberry Pi, I will not explain every option as it is mostly self-explanatory.

Here is the raspi-config screen:

Remember, if you need to run this program from the terminal you can enter this command:

sudo raspi-config

RASPI-CONFIG

Here are the steps to get Raspbian setup.

1. Overscan

If you are using the HDMI output then you may have black border around the screen, if not you can skip this step.

a. Select 8 Advanced Options

b. Select A1 Overscan

c. Select Disable

2. Memory Split

This will set the amount of memory available to the GPU.

a. Select 8 Advanced Options

b. Select A3 Memory Split

c. Set this to 128

Why 128? This is what is suggested in the RetroPie setup script, this can be adjusted later to increase

performance in some emulators.

d. Hit OK

3. Overclock overclock the RPi to make it run faster!

a. For now we will leave this set to none

Why none? Depending on the emulators and roms you intend to use this option can be very useful to increase

performance, for the time being we will leave this set to none while we install and configure the RPi and

RetroPie.

4. Finish

NOTE: File System Expansion and Internationalisation Options

If you installed via NOOBs, your file system will be expanded already, in addition the locale settings will be the ones chosen at

installation, and you can adjust these by choosing option 4 Internationalisation Options.

a. Press the right arrow twice to select finish, now hit enter.

b. You will be asked Would you like to reboot now? Select Yes

i. If you are connected via PuTTY your connection will be disconnected as the RPi is rebooting, dont

worry, close and open PuTTY again after 45 seconds or so.

So thats it, Raspbian OS is installed and setup, now to install all the updates.

Onto the next step, installing updates to Raspbian OS.

NOTE: Running the desktop environment

If you really want to see the shiny Raspbian OS GUI desktop you can use the following command in the terminal:

startx

Do not run this command if you are in PuTTY, it will cause an error and you will have to

STEP 5: UPDATING THE RASPBIAN OS

NOTE: every command is case sensitive, file names included.

*Make sure that your RPi is connected to the internet via the Ethernet cable*

sudo apt-get update

This will download package lists from the Raspbian online repositories (and a few others) and update the package lists on your

RPi.

So now your system knows which packages need updating, you need to enter the command to actually update them:

sudo apt-get upgrade y

This command tells the system to download and install the packages (the command will normally ask you if you wish to

continue, the y enters yes for this so you dont have to)

So now your system will be downloading all the updates for the various packages, this will take a while, go grab a drink and

come back in 10-15 minutes.

RetroPie requires that your system has the Git and dialog packages installed and up to date.

sudo apt-get install -y git dialog

This will install the latest packages for git and dialog, pretty easy if I say so myself.

Dont worry if the Git package doesnt install, this may be already installed and upgraded.

Now the system is fully updated and everything is ready to install retropie, go to the next step.

STEP 6: INSTALLING RETROPIE

Now that Raspbian is installed and updated, we can go ahead and install retropie.

This is relatively, all we have do to is download the retropie script from github, and then execute it

To download the script use this command:

git clone --depth=0 git://github.com/petrockblog/RetroPie-Setup.git

This should take 15-20 seconds, depending on the connection.

Now to execute the script, firstly we have to navigate to the folder that has the script

cd RetroPie-Setup

now we have to execute a change mode command, this will adjust access permissions so that the script can install everything.

chmod +x retropie_setup.sh

You wont get any confirmation that this has worked, but it is fine, continue with executing the script.

sudo ./retropie_setup.sh

You should see this screen: It may look a bit different (I am using PuTTY)

So you have two options to choose from, both will install the complete RetroPie setup, but each is different.

Option 1 Binaries (faster)

This will download pre-compiled binaries for the various emulators and install them. This means that your emulators may not be

upto date.

Option 2 Source (much slower)

This will download the source files and the compile them into the binaries, this will make sure you have the most recent versions

of each emulator, but takes a very very long time.

I would suggest Option 1, but if you have the time and patience then go for Option 2.

This part takes a while, go have lunch.

Right, now thats done you should be returned to the main setup screen.

A good idea would be to update the RPi firmware, the RetroPie setup script can do this for you.

Go to 3 SETUP and select 2 Install latest Rasperry Pi firmware

This will take a few minutes, once it is done you need to go back to the main setup screen and select 7 Perform REBOOT

Restart the setup script

Go back to setup and do some more changes, install xbox drivers if you want those.