InstaPi

Your family photos,
always on display.

A fun, open-source photo frame for Raspberry Pi.
One person sets it up. Everyone enjoys it.

Two ways to use it

Whether it's just for you or the whole family.

๐Ÿ–ผ๏ธ

Personal Frame

Upload photos from your phone. Scan the QR code on the frame, pick from your camera roll, done. Your photos rotate on your frame all day.

๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ

Family Frames

Set up a host frame. Add child frames for family members. Everyone's frame syncs automatically from the host. Grandma just plugs hers in.

How photos get there

Three ways in. Pick whichever works.

๐Ÿ“ฑ

Phone upload

Scan a QR code, pick photos from your camera roll, done. Works from any phone, any cloud service.

Primary
๐Ÿ”—

Share a link

Send the upload link to anyone. They pick photos from their phone. No app, no account, no sign-in needed.

โ˜๏ธ

Google Photos

Connect your Google Photos library if you want to browse and pick from there. Requires Google Cloud setup.

Optional

Set it and forget it

Once it's running, it takes care of itself.

๐Ÿ›ก๏ธ

Self-healing watchdog

Monitors all services every 5 minutes. Crashes, network drops, USB disconnects — it detects and fixes them automatically.

๐Ÿ“ก

WiFi self-setup

No WiFi? The Pi creates its own hotspot. Connect your phone, pick a network, done. If WiFi drops later, it falls back automatically.

๐Ÿ”„

Over-the-air updates

Tap "Update" in the admin panel. The frame pulls the latest code from GitHub and restarts. No SSH, no terminal needed.

๐Ÿ–ฅ๏ธ

Works anywhere

USB mode turns the Pi into a thumb drive for any photo frame. HDMI mode runs a web slideshow on any TV or monitor. Your choice.

Why InstaPi

๐Ÿ”’

Privacy first

Runs entirely on your Pi. No cloud servers, no tracking. All settings and photos stay on your device.

๐Ÿ’ธ

No subscriptions

One Raspberry Pi. That's the whole cost. No monthly fees, no premium tiers.

๐Ÿง‘โ€๐Ÿ’ป

Open source

MIT licensed. Fork it, modify it, make it yours. All on GitHub.

๐Ÿ‘ช

Family-friendly

One tech person sets it up. Everyone else just plugs in their frame and enjoys.

How it works

1

Install on your Pi

One command. Everything sets up automatically.

curl -sSL https://raw.githubusercontent.com/kellygold/instapi/main/pi-setup/install.sh | bash
2

Connect to WiFi

If WiFi isn't configured, the Pi creates an "InstaPi-Setup" hotspot. Connect, pick your network, done.

3

Scan the QR code

The frame shows a QR code. Scan it with your phone to start adding photos.

4

Add photos

Upload from your camera roll. Share the link with family so they can add theirs too.

5

Optional: Add family frames

Set this Pi as the host in admin. Generate tokens for family members. They install on their Pi, enter the token, and their frame syncs automatically.

For makers

Built on a Raspberry Pi. Runs Flask. Talks to your frame.

USB mode

Pi appears as a USB drive. Works with any photo frame that has a USB port. Smart reformatting avoids caching issues.

HDMI mode

Web-based slideshow via Chromium kiosk on any TV or monitor. Fade, slide, zoom transitions + Ken Burns effect.

Admin panel

Manage photos, slideshow settings, multi-frame sync, and system info from your phone. Dark theme, built-in help.

Built with

Python + Flask SQLite Multi-frame sync WiFi AP + captive portal Pillow systemd + watchdog ngrok

Ready to build one
for your family?

All you need is a Raspberry Pi and a screen. Five minutes to install.