Introduction: Raspberry Pi Photo Frame in Less Than 20 Minutes

About: Engineer 🖥 entrepreneur 🌁 film photographer 🎞obsessed with cats 🐈

Yes, this is another digital photo frame! But wait, it’s more sleek, and probably the fastest to assemble and get running.


Step 1: Download Pyxian OS and Flash It to SD Card.

Download Pyxian OS here. To flash OS image to SD card, use the dd command or Balena Etcher for more GUIsh processes.

To give you a full disclaimer, I’m one of the creators of Pyxian OS.

Step 2: [Optional] Fix Minor Stretching on Official Raspberry Pi Display

One annoying thing I noticed is that images looked stretched on the screen. After some research, I found this post. Setting



in the /boot/config.txt file as suggested in one of the comments, fixed the issue.

You can either do it from your computer by accessing a file on SD card, or via ssh to the Raspberry Pi. Alternatively, you can leave the configuration as is, it doesn’t bother everyone.

Step 3: Insert the SD Card Into Raspberry Pi

Step 4: Connect the White Ribbon Cable to the DSI Port on the Pi

Step 5: Connect Power Via Pi’s GPIO

Here's handy pinout diagram.

Step 6: Power It Up With a USB-C Power Supply

Make sure everything is working before the final assembly.

Step 7: Assemble the Photo Frame

Assemble everything into the photo frame. I was super excited to find a frame for my Raspberry Pi 4 + official touchscreen that would stand perfectly on the table. Most of the frames are for 3+, so it was a bit of a search.

Step 8: ​Connect to WiFi

In the Settings → Network → Enter your network name and password → Hit OK. Give it some time to connect.

Step 9: Choose the Digital Photo Frame Application in the Settings App

Go to Settings → Demo Applications → Digital Photo Frame. Note, if you choose to start it on boot time and at some point want to change the app, you’ll need to insert a USB flash stick into Raspberry Pi. There’s another way to reset what app starts on boot.

Step 10: Changing What Images to Show

Digital Photo Frame app gets its images from Unsplash. You can find the source code here. There are a lot of cool Unsplash APIs you can use to modify what pictures are shown. For example, show pictures with specific keywords only, like dogs, cats, nature, etc., or show only pics you liked. See the full list of different options here.

Additionally, you can show images from entirely different sources, like Google Photos or Flickr.

To modify what pictures are shown:

  1. Checkout source code and change base URL variable at this line.
  2. Copy directory “photo-frame” with updated code to the flash stick and insert it into Raspberry Pi.
  3. Go to Settings → USB Drive. Your app will be detected automatically, and you will see the “Install” button.

First Time Author Contest

Runner Up in the
First Time Author Contest