thermometer

A terminal visualization of year progress, inspired by calendar heatmap dashboards.

What it shows

• Current year completion percentage, updated every second with 6 decimal places
• Days remaining until the next year and the next month
• A full-year GitHub-style heatmap grid (Sun–Sat rows, weeks as columns)
• Today's cell highlighted in orange, blinking once per second
• Animated dot counter after the percentage line

Requirements

• Go 1.21+
• A terminal with true color (24-bit RGB) support

Build and run

go build -o thermometer
./thermometer

Or without building:

go run main.go

Press Ctrl+C to exit.

Design

• Color scheme: dark purple/violet gradient for past activity, near-black for future days, orange accent for today and the current month label
• Heatmap data: pseudo-random activity levels (0–4) seeded by year — consistent within a year, changes when the year rolls over
• Live updates: redraws every 500ms; percentage, dots, and today's blink all advance together once per second
• Date rollover: all values (day of year, days left, today's cell position) recompute automatically at midnight and on New Year