If you are using a case like the Adafruit Raspberry Pi Case, snap-fit the Pi into the case:

Leave the clear top off, we'll need to access the GPIO header for the PiTFT. 

The PiTFT's four mounting ears can be used to attach the display to a bezel. But, we'll be snapping them off with pliers (they're perforated) for a flush-fit with the case/ 

Position the PiTFT over the 2x20 GPIO connector and press downwards. Make sure the PiTFT's header is flush against the GPIO header.

Now that our PiTFT is assembled, let's configure the display to work with our Pi.

PiTFT Configuration

You'll need to perform some configuration to get the PiTFT up and running. We'll do this through the PiTFT installer script.

This script will do all the work for you, and install both device tree overlay support as well as configure rotation and any HDMI mirroring. PiTFT no longer needs any custom kernels or modules, so you can continue to update/upgrade your Pi and it will work with the most recent releases.

Here's the commands to run. Make sure your Pi has network access, it needs to download the software!

Download: file
cd ~
chmod +x
sudo ./

Once ./ is run, we'll be presented with menus. Since we're using the 3.5" PiTFt, we'll select #4

If you're not using the 3.5" PiTFT, pick the number that corresponds to the display you are using. For example, for the 2.8" PiTFT with resistive touchscreen select #1

We'll also need to select a rotation of 270 degrees (#3) so the PiTFT + case can sit on your desk when the USB cable is plugged in.

We're going to want to use the PiTFT as a text console for PADD, type Yes to the question Would you like the console to appear on the PiTFT display

Then, reboot the Pi. You'll see the console appear on the Pi. Don't worry if the Pi-hole doesn't display, we're going to configure that next.

This guide was first published on Jun 28, 2018. It was last updated on Jun 28, 2018.
This page (PiTFT Configuration) was last updated on Oct 24, 2020.