Skip to content

mathisfun2048/prize-pics

Folders and files

NameName
Last commit message
Last commit date

Latest commit

55e4855 · · Mar 19, 2026

History

108 Commits
Mar 18, 2026
Mar 17, 2026
Feb 1, 2026
Jan 6, 2026
Mar 18, 2026
Jan 11, 2026
Jan 11, 2026
Jan 2, 2026
Jan 2, 2026
Mar 19, 2026
Jan 28, 2026
Mar 17, 2026
Jan 28, 2026

Repository files navigation

prize-pics

Screenshot 2026-03-18 at 5 25 27 PM

Overview

tldr: Kindle For Your Photos App

This is an e-ink picture frame. Similar products on the market cost upwards of $200, this only costs $50 and is open source.

The e-ink module used is the waveshare 4.2" b/w and the brains is a raspberry pi zero 2w.

There are 2 main components to this project: the physical hardware and the online interface.

hardware:

Screenshot 2026-03-18 at 5 25 27 PM

online interface:

Screenshot 2026-03-18 at 5 32 00 PM

Hardware Specifics

As stated above, the main hardware elements are the e-ink and the rpi. Additionally is a button that allows the user to skip the image on view to the next one in the queue.

This project does utalize a custom PCB that is listed in another one of my projects. This is open source, feel free to reproduce and edit as you see fit.

Screenshot 2026-03-18 at 5 48 54 PM

Interface Specifics

The key functionality of the software is to 1) allow photo uploads 2) see the queue 3) see a preview and 4) skip the image on view with the skip button.

Screenshot 2026-03-18 at 5 51 15 PM

Firmware Specifics

To make this project run, there are a number of different firmware parts that work together.

The most important pipeline in this project is the image transformation process. The user uploads a full-color jpg, png, jpeg and we need to turn this into 1s, 0s that the b/w e-ink can understand. This is done through dithering that makes b/w images look greyscale to our eyes.

A key design consideration is that the uploaded image is not stored locally, after it is processed it is deleted. The processed image is cached in memory. This was to ensure security.

Screenshot 2026-03-18 at 5 51 45 PM

Build Instructions

All build instructions can be found in hardware_instructions and firmware_instructions.md. The pcb design can be found in another one of my repos, PaperCAM. The hardware is identical between the two projects; however, the firmware is different. Use the firmware in this repo for the prize-pics functionality.

link to gerbers: https://github.com/mathisfun2048/PaperCam/blob/main/Production/PaperCAM%20v4%20gerbers.zip

Cost

Free.99. This project is open source.

Demo

https://www.youtube.com/shorts/J4L4dThzBjg

About

kindle for your photos app

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published