Canon CP1500 Photo Booth

Local photo booth app for Canon SELPHY CP1500 only. It provides a small Flask web UI for uploading photos, builds 2x2 collages, applies a color tweak and ICC profile, queues files for printing, and runs a FIFO print worker.

What is in this repo

• app.py: Flask server, upload endpoints, collage/postcard processing, Cloudflare Tunnel launch.
• instax_collage.py: collage builder and image sizing rules.
• instax_autoprint.py: FIFO print worker for Windows (win32print).
• templates/: UI for collage and postcard uploads.
• photo/: local storage and print queues (content ignored by git, structure kept).
• Canon_CP1500.icc: optional ICC profile for color correction.

Requirements

• Python 3.10+ recommended
• Windows for printing via win32print (instax_autoprint.py)
• Canon SELPHY CP1500 driver installed (this project targets CP1500 only)
• Optional: cloudflared in PATH if you want a tunnel

Quick start

1. Create a virtual environment and install dependencies:

python -m venv .venv
.venv\Scripts\activate
pip install flask pillow pywin32

2. Add your Cloudflare hostname to .env:

CLOUDFLARE_TUNNEL_HOSTNAME=your.hostname.example

3. Start the web app:

python app.py

4. In a second terminal, start the printer worker:

python instax_autoprint.py

Open http://localhost:5000 in your browser.

How it works

• The web app writes uploads into photo/upload/*.
• Collage mode waits for 4 photos, builds a 2x2 collage, then queues the output.
• Postcard mode processes each upload immediately and queues it.
• The print worker consumes photo/printer/to_print in FIFO order.

Cloudflare Tunnel

app.py will attempt to start cloudflared automatically. It passes --url http://localhost:5000 and, if set, --hostname from .env. If you do not want a tunnel, leave the env var empty and do not install cloudflared.

Do not expose this app to the public internet. It is not security hardened and has no real authentication. ⚠️ If you must expose it temporarily, restrict access (for example, a geolocation allowlist in Cloudflare), and keep the exposure window as short as possible.