ESP32 PhotoFrame

📸

Drop an image here or click to upload

Supports JPEG and PNG files • Or try the sample image below

The stock algorithm uses theoretical RGB values that may look acceptable on computer displays, but when flashed onto the actual e-paper device, the colors appear washed out and image quality is significantly degraded. Our enhanced algorithm uses measured palette dithering for superior e-paper display quality.

Drag the slider to compare

⟷

← Stock (Waveshare) Enhanced (Ours) →

Preview Rendering Palette:

Measured (simulates device) Theoretical (pure RGB)

Toggle to see how theoretical palette looks on screen vs device

S-Curve Parameters

Strength: 0.9 Overall tone mapping strength (0=linear, 1=strong)

Shadow Boost: 0.0 Brighten shadow areas (higher=brighter)

Highlight Compress: 1.7 Protect highlights from over-exposure (higher=more protection)

Midpoint: 0.5 Where to split shadows/highlights

Color Matching Method:

Simple RGB (default) LAB Color Space (better for grayscale)

Exposure: 1.0 Overall brightness (1.0=normal, >1.0=brighter)

Saturation: 1.5 Color vibrancy (1.0=normal, >1.0=more vibrant)

Tone Mapping:

S-Curve (Advanced) Contrast (Simple)

About

A modern firmware for the Waveshare ESP32-S3-PhotoPainter that provides a powerful RESTful API and web interface for managing your e-paper photo frame.

📸 Smart Upload

Drag & drop JPEG files with automatic processing

🔄 Auto-Rotate

Automatic image rotation with configurable intervals

🔋 Power Smart

2-minute auto-sleep with battery monitoring

📱 Web Control

Modern web interface with real-time updates

⚠️ Requirements:

• Chrome, Edge, or Opera browser (Web Serial API required)

• USB-C cable connected to your ESP32-S3-PhotoPainter

• Waveshare ESP32-S3-PhotoPainter device

Flash Firmware

Loading latest version...

Instructions

Step 1: Connect your ESP32-S3-PhotoPainter to your computer via USB-C
Step 2: Click the "Connect & Flash" button above
Step 3: Select the correct serial port from the popup
Step 4: Wait for the flashing process to complete (~2 minutes)
Step 5: Follow the on-screen WiFi setup instructions

⚠️ Device Not Detected?

This firmware has automatic light sleep enabled for power saving. If your device is not detected when you click "Connect & Flash":

Press and hold the PWR button for 5 seconds (until device powers off)
Hold down the BOOT button and click the PWR button to enter download mode
Click "Connect & Flash" while in download mode

💡 The device will remain in download mode and be detectable for flashing.

After Flashing

Once flashed, the device will create a WiFi access point named PhotoFrame-Setup. Connect to it and navigate to http://192.168.4.1 to configure your WiFi credentials.

✨ Interactive Comparison