aboutsummaryrefslogtreecommitdiffstats
path: root/docs/superpowers/specs/2026-09-16-conky-lua-dashboard-design.md
AgeCommit message (Collapse)AuthorFilesLines
2026-09-16docs: settle weather source on OpenWeatherMapDanilo M.1-8/+49
A polybar backup script for OWM turned up, which beats the weather.com scraper: it has a working condition mapping. Port the domain knowledge, not the code. Worth keeping: the OWM condition-id ranges, day/night selection against sys.sunrise/sys.sunset, and the Beaufort wind thresholds. Becomes a table in data.lua. Not portable: polybar %{F}/%{T} format tokens, hardcoded hex (UDT roles replace them), bc conversions (Lua arithmetic), one-line output (a card). So the script shrinks to curl-and-cache and Lua does the rest. The reference script hardcodes a live API key plus city and country. The key and location move to ~/.config/udt/weather.env, outside the repo, same reasoning as roles.conf. Nothing carries a key in-repo, and weather.env is gitignored so a stray copy cannot be staged. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-16docs: add Lua dashboard design specDanilo M.1-0/+252
Conky dashboard drawn with Cairo from Lua, on a Hyprland special workspace. Replaces UDT's variables-based conky.conf.in. Platform facts verified before fixing the design, since each one invalidates a common approach: - Cairo on Wayland needs conky_surface(). The usual cairo_xlib_surface_create idiom gets a nil drawable and visual under out_to_wayland, so every tutorial using it is wrong here. - own_window_type='normal' makes Conky a real toplevel that a Hyprland windowrule can place; 'desktop' is a layer-surface and cannot be assigned to a workspace. - Cairo output covers conky.text, so conky.text stays empty. Layout is a table of grid cells at the top of dashboard.lua, so reordering widgets is one edit and the same table works on both monitors. The 2560x1600 mockup's vertical stack does not fit the 2560x1080 primary, which is what motivates cells over pixels. hwmon glob-by-name is carried over from the old config deliberately: fixed indices drift across kernel reorders and silently read the wrong chip. v1 is one clock card end to end. Widgets are additive after that. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>