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.

To download the script, click the link below and come back to this page when you're done:

Easy Single Command Install

The latest script allows you to specify all of your options within the command so you can sit back and watch the installation.

For the PiTFT 3.5" Resistive touchscreen with a rotation of 270 degrees (so the PiTFT can sit on your desk while the USB cable is plugged in), use the following command:

sudo python3 --display=35r --rotation=270 --install-type=console
If you're not using the 3.5" PiTFT, follow this page to select a command for your display type. Remember to modify the --rotation parameter to --rotation=270:

Say 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 May 08, 2021.

Text editor powered by tinymce.