Skip to content

slashman/sunMoonClock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sunMoonClock

A visual clock showing the sun and moon across the sky, in five flavors. Live web demo: https://slashie.net/time

This repository holds five sibling projects. The data flow:

web/  →  renderer/  →  proxy/  →  ios/, android/
clock    Node screenshot   PHP cache at      home-screen
source   server (private)  /time/current     widgets

web/ — the original web-embeddable clock

Vanilla HTML/JS/CSS, no build step. Renders the live animated clock and is the canonical implementation. Deploy as static files behind any web server.

renderer/ — Node.js screenshot server

Playwright-backed HTTP server. GET /current returns a transparent PNG of the clock, lazily re-rendering at most once per calendar minute. Runs privately; not exposed directly to widgets. Configure the upstream clock URL via SMC_URL. Ships with a Dockerfile based on the official Playwright image; deployable to any container host.

proxy/ — PHP reverse-proxy + cache

Single index.php you drop onto the same shared host that serves the web clock. Fetches from the renderer once per minute, caches to disk, and serves stale cache on upstream failure. This is the public URL the widgets hit; configure the upstream renderer URL at the top of the file.

android/ — Android home-screen widget

Kotlin AppWidget that fetches the proxy URL. Refreshes via WorkManager (15-minute periodic, the OS minimum) plus a screen-unlock trigger so the clock advances when you actually look at the phone. Build URL is set at compile time via CLOCK_URL in app/build.gradle.kts.

ios/ — iOS home-screen widget (planned)

Fetches the proxy URL and displays it.

Credits

Tilesets derive from Denzi's CC-BY-SA "Sun and Moon" and "bard" sets — see web/README.md for sources and attribution.

About

A web clock displaying the sun and the moon as they cross the sky

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors