The year,
one dot at a time.

A lock-screen wallpaper that redraws itself. Every day of the year is a dot. The ones behind you are filled in, and today fills by the hour. No app, just a URL your phone fetches.

lived
today, by the hour
still ahead

Make yours

Device

Time zone

Theme

Your URL

…

tap to expand

Endpoint

GET /wallpaper?w=&h=&tz=&theme=

Returns a PNG rendered at request time. Responses are sent with Cache-Control: no-store, so every fetch is current. All parameters are optional.

integerdefault 1179

Image width in pixels. Clamped to 200–4096.

integerdefault 2556

Image height in pixels. Clamped to 200–4096.

IANA zonedefault UTC

Decides when your day starts and how far today’s dot has filled. e.g. Asia/Kolkata, America/New_York. Unknown zones fall back to UTC.

theme

dark | lightdefault dark

Black canvas with white days, or white canvas with black days.

Common sizes

iPhone 17 Pro Max · 16 Pro Max1320×2868

iPhone 17 · 17 Pro · 16 Pro1206×2622

iPhone Air1260×2736

iPhone 16 · 15 · 15 Pro · 14 Pro1179×2556

iPhone 16 Plus · 15 Plus · 15 Pro Max1290×2796

iPhone 14 · 13 · 121170×2532

iPhone SE750×1334

Pixel 9 · 9 Pro1080×2424

Pixel 9 Pro XL1344×2992

Galaxy S25 · S241080×2340

Examples

/wallpaper /wallpaper?tz=Asia/Kolkata /wallpaper?w=1320&h=2868&tz=Europe/Berlin /wallpaper?theme=light&tz=America/New_York

Set it once

iPhone · Shortcuts

Open Shortcuts → Automation → New → Time of Day. Pick 00:01, repeat daily, run immediately.
Add Get Contents of URL and paste your URL.
Add Set Wallpaper Photo, choose Lock Screen, turn off Crop to Subject and Show Preview.
Want today’s dot to fill through the day? Add a few more times. Every few hours works well.

Android

Use any automation app that can fetch an image and set it as wallpaper: MacroDroid, Tasker or Automate.
Trigger on a daily schedule, download your URL, then set it as the lock screen.

The year,one dot at a time.