The code for this project is out of date and some reverse engineering will be required.

Ready-to-go Image

To get the software running on the Pi, we'll need to first burn the .img to a 8GB microSD card using an app. Once burnt, insert it into the Pi and install the PiTFT onto the Pi. Use a proper 5V power supply wall adapter to boot it up.

The screen should display the terminal. Plug in a keyboard to one of the USB ports and use the default credentials to login (username pi password raspberry).

This IMG is only for the Raspberry Pi Model B+ It will not work with Pi 2 or 3.

Adapting for Pi 2 or 3

If you're using a Raspberry Pi 2 or 3, you'll need to manually install the Pipboy python software on a fresh install of Jessie. Start by downloading and burning the Jessie-based PiTFT 3.5" Resistive Image.

PiTFT on Pi 2 and 3

The Jessie-based PiTFT 3.5" Resistive Image has preconfigured software for running the touch screen display. It will automatically boot into the raspbian desktop.

Installing Pypboy 3000 on Pi 2 and 3

This is a work in progress for the Pi 2 and 3. The software used in this build is a modified version of this code on github by sabas1080. It requires some tweaks to the file to adapt it for the 3.5" PiTFT and the rotary switch. 

WiFi Setup

We'll need to get the Raspberry Pi setup with internet so it can download map data. To do this we'll need to add our Wifi network credentials to our wpa supplicant config. 

In the terminal, type in the following command:

sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

Add WiFi Creds

You'll see a text file with a few parameters. Type in your wifi ssid (the name of it) and password in the fields.

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1

Save Creds

Once done, press cmd+x to exit the text document and then type "y" to save and "enter" to confirm the file name. Now you can type "sudo reboot" to restart the Pi. Once it boots up, the Pi should automatically connect to your wifi network.

Start Pypboy Python Program

To start the pypboy program, type the following commands into the terminal:

cd pypboy
sudo python

The pypboy program should start up and the audio will automatically start playing if you have headphones or a speaker plugged into the A/V jack.


The following keys will let you navigate through the pypboy UI.


Switch between modes

1, 2, 3, 4, 5

Switch between sub-menus

Up, Down

Navigate sidebar menu items

Add Your City to Map

The pypboy python program uses OSM to pull map data from the internet. By default, we have it set to display a map of NYC. To change this, you can edit the location in the following config.

cd pypboy
sudo nano

You should see some parameters in the config file. Look for the line with "MAP_FOCUS" and type in your desired location. It needs to be formatted for longitude and latitude. You can get this from google maps. Type in your location in google maps and you pull it from the URL in your address bar. For example, the URL,+FL/@26.7422403,-80.2700968,11z/ is for West Palm Beach, FL - So the numbers we need are 26.7422... and -80.2700... Note that the pypboy python program has the order of these flipped.

import pygame

WIDTH = 320
HEIGHT = 240


MAP_FOCUS = (-102.3016145, 21.8841274)

Customize Pypboy Program

If you'd like to add functionality to the pypboy program. You are welcome to fork the github repo. The pypboy python program was written by github users grieve and modified by sabas1080.

This guide was first published on Feb 04, 2016. It was last updated on Feb 04, 2016.

This page (Software) was last updated on May 05, 2021.

Text editor powered by tinymce.