v1.0.0 RC3
GitHub
📱 Device Settings
⚙ Editor Settings
📱
⚙
Loading...
/
100%
−
⌂
+
ESPHome YAML
All
λ
OEPL
ODP
OpenEpaperLink JSON (Beta)
- Copy this to Home Assistant → Developer Tools → Services →
open_epaper_link.drawcustom
OpenDisplay JSON (ODP)
- Compatible with ODP v1 primitives.
ESPHome YAML (Fullscreen)
Close
Import Layout from YAML
Cancel
Import
Page Settings
Close
Page Name
Refresh Mode
Periodic Interval
Daily at specific time
Interval (seconds)
Wake-up Time (HH:MM)
Visual Style
Inherit Global
Always Light
Always Dark
Layout Mode (LVGL)
Absolute Positioning
Grid Layout
Grid Size (RxC)
Format: rows×columns, e.g. 2x3, 4x4
Save Changes
Device Settings
Close
Friendly Name
Rendering Mode
Direct (Display Lambda)
LVGL (Recommended for LCD)
OpenEpaperLink JSON (Drawing Protocol)
OpenDisplay JSON (ODP)
Screen Orientation
Landscape
Portrait
Hardware Profile
⟳ Reload
Import Recipe
Custom Profile...
OpenEpaperLink Configuration
OEPL Tag Entity ID
Dithering Algorithm
None (Faster)
Ordered
Burkes (Recommended)
Atkinson
Floyd-Steinberg
Jarvis-Judice-Ninke
Stucki
Sierra
OpenDisplay Configuration (ODP)
ODP Display Entity ID
Dithering Algorithm
None (Faster)
Ordered
Burkes (Recommended)
Atkinson
Floyd-Steinberg
Jarvis-Judice-Ninke
Stucki
Sierra
Update Interval (TTL)
In seconds. 0 = never expires.
Custom Hardware Pinout
Chip Type
ESP32-S3
ESP32
ESP32-C3
ESP32-C6
ESP8266 (Experimental)
Tech
LCD / OLED
E-Paper
Resolution Preset
Manual...
128x64 (0.96")
128x128 (1.44")
240x240 (1.3/1.54")
320x240 (2.4/2.8")
320x480 (3.5")
480x320 (3.5" alt)
480x480 (Round/Square)
800x480 (4-7")
1024x600 (7-10")
2.13" (250x122)
2.9" (296x128)
4.2" (400x300)
5.65" (600x448 7-Color)
5.83" (640x384)
7.5" (800x480)
7.5" HD (880x528)
Shape
Rectangle
Round
Manual Resolution
PSRAM
Anti-burn (LCD)
— None —
GPIO0 (boot)
GPIO1 (TX)
GPIO2
GPIO3 (RX)
GPIO4
GPIO5
GPIO12
GPIO13
GPIO14
GPIO15
GPIO16
GPIO17
GPIO18 (VSPI CLK)
GPIO19 (VSPI MISO)
GPIO21 (I2C SDA)
GPIO22 (I2C SCL)
GPIO23 (VSPI MOSI)
GPIO25
GPIO26
GPIO27
GPIO32
GPIO33
GPIO34 (input only)
GPIO35 (input only)
GPIO36 (input only)
GPIO39 (input only)
— None —
GPIO0
GPIO1
GPIO2
GPIO3
GPIO4
GPIO5
GPIO6
GPIO7
GPIO8
GPIO9
GPIO10
GPIO11
GPIO12
GPIO13
GPIO14
GPIO15
GPIO16
GPIO17
GPIO18
GPIO19
GPIO20
GPIO21
GPIO38
GPIO39
GPIO40
GPIO41
GPIO42
GPIO45
GPIO46
GPIO47
GPIO48
— None —
GPIO16 (D0 - Wake)
GPIO5 (D1 - SCL)
GPIO4 (D2 - SDA)
GPIO0 (D3 - Flash)
GPIO2 (D4 - LED)
GPIO14 (D5 - SCK)
GPIO12 (D6 - MISO)
GPIO13 (D7 - MOSI)
GPIO15 (D8 - CS)
GPIO3 (RX)
GPIO1 (TX)
GPIO10 (SD3 - Flash)
GPIO9 (SD2 - Flash)
Display (SPI)
ST7789 (LCD)
ILI9341 (LCD)
ILI9342 (LCD)
ILI9488 (LCD)
Waveshare E-Paper
Generic SPI E-Paper
Other (Custom YAML)
Display Model
Required for Waveshare E-Paper
1.54"
1.54" V2
2.13"
2.13" V2
2.13" V3
2.13" TTGO
2.66"
2.70"
2.90"
2.90" V2
2.90" DKE
3.52"
3.70"
4.20"
4.20" V2
5.65" (Color)
5.83"
5.83" V2
7.50"
7.50" V2
7.50" V2 (Partial Refresh)
7.50" HD
CS
DC
RST
(opt)
×
BUSY
(opt)
×
CLK
MOSI
Backlight & I2C
Backlight
I2C SDA
I2C SCL
Touch Controller
None
GT911 (I2C)
CST816 (I2C)
FT5x06 (I2C)
XPT2046 (SPI)
Touch INT
Touch RST
Recipe Name
🚀 Save Profile
Protocol Hardware Specs
Resolution Preset
Manual...
2.9" (296x128)
4.2" (400x300)
7.5" (800x480)
5.83" (640x384)
2.13" (250x122)
Width
Height
Color Mode
Monochrome (B/W)
Grayscale
3-Color (BWR / BWY)
Full Color
Dark Mode
Extended Latin Glyphs
Inverted Colors (E-Paper)
Power & Refresh Strategy
Global Refresh Interval
seconds
Default time between updates. Can be overridden on individual pages.
E-Paper Options
Full Power (Always On)
Device stays connected to Wi-Fi. Fast response, but high battery drain.
Eco (Scheduled Night Sleep)
Stops refreshing during these hours to save energy.
Daily Scheduled Refresh
Wakes up once per day at a specific time.
Manual Refresh Only
Never updates automatically. Only refreshes when a button is pressed.
Ultra Eco (Deep Sleep)
Shuts down completely between updates. Best for battery life.
LCD / OLED Options
Always On (Full Brightness)
Eco (Backlight Off Schedule)
Turns off backlight during sleep hours (recommended for LCD).
Eco (Dim after timeout)
Turns off backlight and pauses LVGL after period of inactivity. Resume on touch.
Eco (Halt Loop)
Stops update cycle but leaves screen powered.
Ultra Eco (Deep Sleep)
Power down between updates.
Dim after
seconds
Sleep from
00:00
01:00
02:00
03:00
04:00
05:00
06:00
07:00
08:00
09:00
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
18:00
19:00
20:00
21:00
22:00
23:00
to
00:00
01:00
02:00
03:00
04:00
05:00
06:00
07:00
08:00
09:00
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
18:00
19:00
20:00
21:00
22:00
23:00
Refresh at
Update every
sec
Silent Hours (No Refresh Window)
Prevent all display updates during this time window. Used to avoid night-time ghosts/noise.
Disable updates from
None
00:00
01:00
02:00
03:00
04:00
05:00
06:00
07:00
08:00
09:00
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
18:00
19:00
20:00
21:00
22:00
23:00
to
None
00:00
01:00
02:00
03:00
04:00
05:00
06:00
07:00
08:00
09:00
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
18:00
19:00
20:00
21:00
22:00
23:00
Page Auto-Cycling
Automatically cycle through pages on a timer.
Enable Automatic Page Cycling
Cycle every
seconds
Apply Settings
Save Hardware Profile
Cancel
Give your custom hardware configuration a unique name. It will be saved as a reusable recipe.
Profile Name
Save Profile
Editor Preferences
Close
View & Theme
Show Grid
Enable Snapping
Grid Opacity
Interface Theme
Use Light Mode interface
Font Settings
Global Glyphsets
Select glyphsets to include language specific characters (like å, ö, ä) in the generated YAML for all fonts.
Latin Kernel
(Basic A-Z, 0-9)
Latin Core
(å, ö, ä, é, ß...)
Arabic Core
(ا, ب, ت...)
Cyrillic
(А, Б, В...)
Greek
(α, β, γ...)
Latin African
Latin PriAfrican
Vietnamese
(à, á, ả...)
Home Assistant
Resources
Refresh Entity List
Connection Settings
Configure this if you are using the GitHub-hosted version or an external URL.
💡 Connection Tip:
If requests are blocked, you may need to add
http://localhost:8000
to
cors_allowed_origins
and
restart HA
.
Base URL
Long-Lived Access Token
Test Connection
AI Integration (LLM)
Configure Gemini, OpenAI or OpenRouter to use natural language prompts.
Provider
Google Gemini
OpenAI
OpenRouter
Gemini API Key
OpenAI API Key
OpenRouter API Key
Model Filter (e.g. "free", "flash", "gpt-4")
Test & Load Models
Selected Model
Keyboard Shortcuts
Undo
Ctrl+Z
Redo
Ctrl+Y
Copy
Ctrl+C
Paste
Ctrl+V
Delete
DEL
Lock/Unlock
Ctrl+L
Search
Shift+Space
Debug Mode
D
Design Grid
G
Rulers
R
Zoom Reset
Ctrl+R
Snap Off
ALT
Distances
CTRL Drag
Group
Ctrl+G
Ungroup
Ctrl+Shift+G
Done
AI Design Assistant
Close
💡 Configuration Required:
An API provider and key must be configured in
Editor Settings
before using the AI Assistant.
⚙ Open Editor Settings
Describe what you want to change. Example: "Move the selected widget 50px right" or "Make a nice weather layout with 4 days forecast".
PREVIEW CHANGES
Generate
Apply