🔥 Introductory Offer: Become a member and get Ad-free browsing + more (50% Off with code LAUNCH; first 25 uses).

How to build a Raspberry Pi Steam Box?

One thing that's often missing in a home entertainment center is gaming. With the advent of Steam machines, it's now possible to easily play PC games on your TV, but you have to shell out hundreds of dollars to buy one. Even though there are many media center software options for the Raspberry Pi, there's not much for gaming. However, Iwan Timmer's moonlight-embedded is one such program that can be used to build a Raspberry Pi Steam Box. You may be asking: "Can Raspberry Pi run Steam ?". Currently it cannot, moonlight-embedded utilizes Nvidia's open source game stream client, Moonlight, to stream games to Raspberry Pi, so it doesn't install Steam on Raspberry Pi. Unfortunately, your PC will need a GPU with GameStream support, any Nvidia GPU from GTX 650 and up should work. For PC gamers, having Steam on Raspberry Pi makes playing on the big screen easy, and since most of the work is being done by your PC, your Raspberry Pi Steam Box can display games in 1080p, as long your internet connection is strong enough. Plus, with the new Raspberry Pi 3, you won't even need to buy an external Wi-fi adapter. [Read: Raspberry Pi 3 Released: More power for low-power HTPCs]

Build Raspberry Pi Steam Box Tutorial
Build A Raspberry Pi Steam Box To Play Your Steam Games On The Big Screen!

How to build a Raspberry Pi Steam Box?

First you need to have all the required items to set up your Raspberry Pi Steam Box. I have listed everything you'll need below.

Best Wireless HTPC and Android TV Box Keyboards:
  1. Logitech K410 Living-Room Wireless Keyboard with Built-In Touchpad - $37.75 Editors Pick
  2. Logitech Illuminated K830 HTPC Wireless Keyboard and Touchpad - $69.99
  3. iPazzPort KP-810-10AS Wireless Mini Keyboard Remote with Touch - $15.99
  4. Rii i8+ 2.4GHz Mini Wireless Keyboard with Touchpad - $22
  5. LYNEC C120Pro Mini Wireless Gyro Remote Keyboard Mouse - $13

Preparing the Pi for Moonlight

This guide assumes you already have your Pi up and running, if you don't then check out this guide to install an OS on your Raspberry Pi using NOOBS. There are some steps we need to take before installing moonlight-embedded on your Pi. First, we must add the repository that we will get moonlight-embedded from to the sources list. Open up the sources list with this line:

sudo nano /etc/apt/sources.list

After opening up sources.list, add the following line to the bottom:

deb http://archive.itimmer.nl/raspbian/moonlight jessie main

Raspberry Pi Steam Box Repository
Adding The Repository To Sources.list

Press CTRL + X to save, choose Yes when prompted, and then press Enter. Now that the repository is added to the list, we have to update the sources so Raspbian can detect the changes:

sudo apt-get update

Installing and Setting up Moonlight

Now it's time to install moonlight-embedded. Since we've already done most of the work, we can install it with this simple command:

sudo apt-get install moonlight-embedded

Make sure to press Y whenever prompted. Now that moonlight is installed, we have to pair the Raspberry Pi Steam Box to your PC. For this part, go back to your PC and open up a command prompt window, you can search for cmd.exe in the Start Menu to open command prompt, then type ipconfig into the window to open up your internet settings. Make sure to record the IPv4 Address as that is your local IP address, which we'll need for pairing.

Steam On Raspberry Pi Ip Address
Getting Your Pc's Local Ip Address

Now that you have your local IP address, go back to your Raspberry Pi and enter the following command, typing in your local IP address in place of the x's:

moonlight pair X.X.X.X

Raspberry Pi Steam Machine Pin
Popup Window Requesting Your Pin

After entering this command, a four digit PIN will appear on the Pi's console and a popup window will appear on your PC asking you to enter the PIN. Once you enter the PIN from the Pi into your PC, the two devices will be linked and you'll have a working Raspberry Pi Steam Box. [Read: 10 best Kodi gaming addons you didn't know about]

Using Moonlight

Now that Moonlight's setup, it's finally time to use your Raspberry Pi Steam Machine. The easiest way to use Moonlight is with the stream command:

moonlight stream X.X.X.X

Make sure to put your local IP in place of the x's. This command will launch Steam in Big-Picture Mode on your PC and then stream that over to your Pi. With Steam on Raspberry Pi, you can stream pretty much any game on your computer. For non-Steam games, use the "Add a Non-Steam Game" option to link your games with Steam, then you can stream them to your Raspberry Pi through Moonlight. You can also use the -app option to stream a specific program. All the available options are listed below, when using options make sure that they're in this format:

moonlight stream [options go here] X.X.X.X

What options can be used with Moonlight? Check the table below:

Available options on Moonlight StreamEffect
-720Set resolution to 1280x720 [default]
-1080Set resolution to 1920x1080
-width XSet horizontal resolution to X
-height XSet vertical resolution to X
-30fpsSet fps to 60
-60fpsUse 60fps [default]
-bitrate XSet bitrate to X [in Kbps]
-packetsize XSet maximum packetsize to X [in bytes]
-app XStream X program
-nosopsDon't allow GFE to modify game settings
-input XUse  X as input. Can be used multiple times
-mapping XUse  X as gamepad mapping configuration file (use before -input)
-audio XUse X as ALSA audio output device (default sysdefault)
-localaudioPlay audio locally


Now that everything's set up and ready to go, all you have to do is sit back and enjoy your Raspberry Pi Steam Machine. If you're looking for more ways to get Steam on the big screen check out this article on installing the Kodi Steam addon. If you're having latency issues with the stream, try changing the settings using the options mentioned earlier, or adjusting your internet connection. By default Moonlight works with a keyboard and mouse, but it's possible to use a controller. I was able to use my PC controller by simply plugging the USB dongle into my Raspberry Pi. A Steam Box is just one of the many uses for a Raspberry Pi. For another use, check out this article on installing OSMC on a Raspberry Pi or this article about RAIO and its uses.

Be the ONE IN A MILLION that read this, and support us...
  • Feeling generous? Become a member and get ad-free browsing, exclusive content, Discord benefits, and more.
  • Just want to thank us? Buy us a Coffee or a Ko-Fi.
  • May be another day? Shop on Amazon using our links. Your prices won't change but we get a small commission.
  • Don't feel like spending? You can still show your support by sharing this post, linking to it in forums, or even commenting below.


Akash is currently a college student studying Computer Science. He has taught himself Java,C++, and Python. He loves to play video games,especially CS:GO and has a Shi-tzu named Cookie, who is in his profile picture.

Get Surfshark