Skip to content

Repository files navigation

eInkFrame — An eInk Digital Picture Frame Powered by Raspberry Pi and Python

Screenshot 2025-05-01 201531

The eInkFrame is a robust digital picture frame powered by Raspberry Pi that utilizes a Waveshare 7.3 inch 7-Color ePaper Display for a natural look. Simply upload images in a supported format to a micro SD card, and the display will automatically cycle through them at a customizable interval!


Contents


Required Hardware

Item Link
Raspberry Pi Zero 2 W Amazon
Pi Power Supply Amazon
Waveshare 7.3" 7-Color ePaper Display Amazon
Picture Frame 3D Print Files Printables
2x Micro SD Cards (for OS & images) Amazon
Micro USB to Micro SD Card Reader Option 1, Option 2
Screws/Nuts (if using 3D prints) 2x M3x20mm screws and nuts

Pi Setup

Before starting, ensure that your Pi is running Raspberry Pi OS 32 or 64-bit (Lite not supported), and is connected to your home network.
If you need help installing Raspberry Pi OS, follow the official guide.

Once your Pi has booted, open Command Prompt (Windows) or Terminal (Mac), and SSH into the Pi:

ssh pi@pi.local

Then run the following to clone the project and begin setup:

git clone https://github.com/EnriqueNeyra/eInkFrame.git
cd eInkFrame
sudo bash setup.sh

Be sure to reboot the Pi after the setup script completes.


Assembly

1. Attach the Pi and driver board, ensuring the pin headers are fully inserted.

2. Insert the Pi and driver board into the enclosure.

3. Insert the M3 nuts into the slots at the bottom of the frame.

4. Carefully slide the eInk display into the frame, ensuring it's secured under the notch at the top.

5. Tuck the ribbon cables into the Pi enclosure and connect to the display cable.


6. Align the enclosure holes with the display, and secure the stand using 2 M3x20mm screws.

Assembly is now complete!


Using the Frame

Upload any images you want displayed to a clean Micro SD card. Recommended and tested formats include: JPG/JPEG, PNG, TIFF, and BMP.

The default image cycle time is 600 seconds (10 minutes), and new images are chosen randomly while avoiding repeats. Optionally, the default timing can be customized by adding a .txt file to the SD card that specifies the refresh time in seconds:

Requirements for refresh_time.txt:

  1. Must be named refresh_time.txt
  2. Must be placed at the root of the SD card (not in a folder)
  3. The text file should contain only a single number

Use the Micro USB to Micro SD card adapter to plug the SD card into the Pi, then connect power. After a few moments, a “Beginning Setup...” message will appear. Setup time depends on the number of images on the SD card.

SD + Power Connections & Setup Screen

Your first image should appear shortly!


Video Demo

⚠️ Note: The video was shortened due to upload size constraints.
Actual setup can take several minutes. Image display/refresh time is ~30 seconds.

GithubDemo.mp4

About

A Robust Offline Digital E-Ink Picture Frame

Resources

Stars

55 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages