clock-calendar-glass
GitHub

Conky widget · Lua + Cairo

An analog clock and calendar, cut from glass.

A frosted, five-layer liquid-glass panel for Conky — a ticking analog clock on one side, a full month calendar with today highlighted on the other. Pure Lua and Cairo, no daemons, no dependencies beyond Conky itself.

$ git clone https://github.com/wim66/clock-calendar-glass.git

Under the hood

Built for the corner of a screen

01

Five-layer glass

Base fill, vertical and horizontal reflections, a top specular gloss, an inner glow, and a gradient border — the same technique on the outer panel and the round clock plate.

02

X11 and Wayland

Tries conky_surface() first and falls back to cairo_xlib_surface_create(), so the same config runs on either display server.

03

No blocking calls

The draw loop only reads the system clock — no shell-outs, no file polling, nothing that can stall a 1-second update tick.

04

Five languages

Calendar month names in English, Dutch, German, Spanish, and French, with a Monday- or Sunday-first week.

05

ISO week numbers

Optional week-number column beside the day grid, toggled with a single setting.

06

Three small files

widget.lua draws the glass; scripts/clock.lua and scripts/calendar.lua just draw on top of it — nothing shared, nothing tangled.

Quick start

Running in under a minute

# clone and run
git clone https://github.com/wim66/clock-calendar-glass.git
cd clock-calendar-glass
./start.sh

# or, directly
conky -c conky.conf

Customization

Every color is its own setting

hour hand — #1E90FF
minute hand — #00CED1
second hand — #FF4500
weekday header — #FFBF00
month label — #44AAFF