Raspberry Pi Steam Box
In this tutorial, I will be setting up a Raspberry Pi steam box so you can stream PC games from your computer straight to the Pi. This project is an awesome way to get games to another screen or TV in your house without spending a huge amount of money on extra equipment.

Ultimate Books of Pi

This tutorial is perfect for anyone who loves video games, but something like the Raspberry Pi retro game emulator is a little too old school for you. With this, you will be able to play most modern games, but you will also need to have a computer that is powerful enough to run them. This setup is the closest thing you will get to an actual Raspberry Pi Steam box unless Valve ever releases an ARM version of Steam.

One of the most significant downsides to this tutorial is that you will need a Nvidia graphics card in your computer. Unfortunately, there isn’t an AMD equivalent of doing the same thing at the time of when I wrote this tutorial.

In this tutorial, we will be using a software package called Moonlight on the Pi. This software will connect to the Nvidia Geforce Experience app running on a PC. You will then be able to stream most games that are available on Steam to the Pi.

If you want to see how to get this up and running, then be sure to check out the video below. It goes through all the steps to getting this cool Raspberry Pi tutorial up and running.


You will need the following equipment for this Raspberry Pi steam box tutorial. Keep in mind you will probably want to avoid using WiFi and use Ethernet for the best performance.


Raspberry Pi

Micro SD Card if you’re using a Raspberry Pi 2, 3 or B+

Power Supply

Ethernet Cord (Recommended) or Wifi dongle

Computer with an NVidia graphics card


Raspberry Pi Case

USB Keyboard

USB Mouse

USB Game Controller

Setting up Raspberry Pi Steam Box Software

As with the majority of the tutorials on this website, you will need to make sure you have Raspbian installed. If you don’t and have no idea where to start, then you can find my handy guide to installing Raspbian here. We recommend that you use Raspbian Stretch for this tutorial.

1. To begin, you will need to either SSH or be in the terminal on your Pi.

2. In here we need to add the moonlight repository to our package source list. To do this simply enter the following. The | will copy the result of the first command into the second.

echo "deb http://archive.itimmer.nl/raspbian/moonlight stretch main" | sudo tee /etc/apt/sources.list.d/pms.list

3. You need to fetch and install the GPG key so you will not receive warnings about the public key not being available.

wget http://archive.itimmer.nl/itimmer.gpg
sudo apt-key add itimmer.gpg

4. Next, you will need to update the package list by simply running the following command.

sudo apt-get update

5. Now install the package by running the following command.

sudo apt-get install moonlight-embedded

That’s all you need to do, and now we’re ready to connect the Pi up to a PC. This process is super easy, and I’ll go through the steps below.

Connect your Pi to the PC

To begin, you will need to make sure you have a Nvidia GeForce graphics card. Secondly, you will need to make sure you have the GeForce experience app installed.  If you don’t have Geforce experience application installed, then you download it at the Geforce website.

1. To begin, make sure you know the IP address of the gaming PC you want to connect to. To do this, go to CMD (command prompt) on Windows. This application can be found by simply searching for it.

2. In here run the command ipconfig
Write down or copy the IP in the field next to IPv4 Address.

3. On the Pi enter the following to pair with the gaming PC running the GeForce experience. Replacing with your own IP address.

moonlight pair

Pi Steam Box Shield Code

4. This command will generate a 4-digit pin that you will need to enter on your computer in the pop up saying “SHIELD is requesting to connect.”

Nvidia Shield Code

5. It’s all good to go now, to begin streaming simply enter the following. (Replacing the with own IP)

moonlight stream

6. There are additional configuration options that you might be interested in taking a look at. I will go through them below.

Extra Configuration Options

To help improve the performance of the Raspberry Pi steam box you can tinker with some settings. When you go to launch moonlight streaming on the Pi, there are several additional options, which you’re able to add to the command line. If you want to add options, they go after stream. For example: moonlight stream [OPTIONS] x.x.x.x

Below is a list of almost all the options that you’re able to add.

-720 Use 1280x720 resolution (default)

-1080 Use 1920x1080 resolution

-width <width> Horizontal resolution (default 1280)

-height <height> Vertical resolution (default 720)

-30fps Use 30fps

-60fps Use 60fps (default)

-bitrate <bitrate> Specify the bit-rate in Kbps

-packetsize <size> Specify the maximum packet size in bytes

-app <app> Name of app to stream

-nosops Don't allow GFE to modify game settings

-localaudio Play audio locally

-keydir <directory>\tLoad encryption keys from directory

As you can see, there are quite a few options to pick from. You will probably find the FPS and resolution are the two you will find handy the most. Change these if you’re finding stream issues such as lagging etc. Reducing these will help lower the amount of data that needs to be sent over the network. For example, if you had 30 FPS and a 720 resolution, it would look something like this.

moonlight stream -30fps -720 x.x.x.x

If you want to have it launch an app like steam by default, then you do something like this.

moonlight stream -app steam x.x.x.x

These are just a couple of examples of what you can do. There are also other additional options that you’re able to add. The full list can be found on Moonlights wiki page.

Troubleshooting & Limitations

I have found that some games didn’t work at all. I am not entirely sure why this is the case, but I think it could be something to do with the multiple monitors causing issues. Doom, for example, will run fine on the PC but won’t stream to the Pi for some odd reason.

Games vary in quality, for example, games like ARMA I found quite a significant difference between the host PC and the Pi but games like Ori & the blind forest I didn’t notice too much difference between the two. As I mentioned above, you can tinker with settings to try and get the best quality without any lag. Below is a short clip of some of the games I tested with the PC version on the left and the streamed version of the right.

I sometimes found Moonlight would crash, but this was only between changing games and wasn’t so common for it to become annoying (I was also changing games quite often to test things out). You can simply relaunch the stream with one simple command in the terminal so crashes aren’t too bad to recover from. (As long as it’s not mid game).

If you have would like to see a list of issues that are currently known, then be sure to head over to the moonlight-embedded GitHub page. This page will have a list of open and closed problems with the software.

I hope this Raspberry Pi Steam box tutorial has helped you be able to stream video games to the Pi. If you come across any issues or have some feedback related to this tutorial, then please don’t hesitate to leave a comment below.

Ultimate Books of Pi Bottom
Pi My Life Up's Crash Course
to the Raspberry Pi

Pi My Life Up's Crash Course

to the Raspberry Pi

Subscribe to our email list to get the

Crash Course delivered straight to your inbox

Please check your inbox for a confirmation email!