Skip to content

Releases

wthrr v1.2

Choose a tag to compare

@todddube todddube released this 16 Oct 15:52

wthrr 1.2 — Retro 8-bit mode

Every weather scene can now be drawn as chunky 8-bit pixel art with one switch. This release also adds a one-command build-and-install script for people building from source.

Source: github.com/todddube/wthrr_mac


Retro 8-bit mode

Turn on Retro 8-bit in the menu bar popover, or in Settings → Appearance → Style. All seven weather types redraw as pixel art using a fixed, console-style palette.

  • Snow — three snowflake sprites that match the dot, star, and dendrite crystals, and stepped drifts with a white cap.
  • Rain and Thunderstorm — streaks that tilt with the wind in a classic stair-step, droplets that hop out of each splash, tapered puddles, a blocky lightning bolt, and a screen flash that fades in steps.
  • Clear Skies — a pixel sun with rotating dashed rays that turns orange at golden hour, and at night a cratered moon with twinkling four-point stars. Motes blink.
  • Aurora — curtains of two-pixel stripes with a magenta fringe and a dithered bottom edge, over a starfield.
  • Fog — broken, drifting scanlines that thin out toward the edges of each fog bank.
  • AI Storm — alien ships become animated space invaders. Glitch fragments, corruption noise, and data bolts are all pixel-based, and still use your chosen neon palette.
  • Pixel Size — choose Fine, Classic, Chunky, or Huge pixels (3 / 4 / 6 / 8 pt).

Retro mode only changes how the scene is drawn. The same particles, clouds, and lightning are simulated either way, so you can switch styles at any moment without the scene resetting. Live Weather, presets, and every slider keep working in retro mode.

It costs about the same as the regular style. Each colour layer is filled in one draw call, and each cloud's pixel shape is computed once and reused.

Settings

  • The Appearance tab now scrolls, which makes room for the new Style section.

Building from source

  • scripts/install.sh runs the unit tests, builds a Release copy, signs it, quits the running copy, replaces /Applications/wthrr.app, and relaunches it. Options: --skip-tests, --no-launch, --dest DIR. It finds Xcode on its own even when xcode-select points at the Command Line Tools.
  • If you use Claude Code, the project's app-builder agent runs the same script and summarises any failing tests or compile errors.

Under the hood

  • Bird flight paths are computed in one place, so regular and retro birds fly identical routes.
  • 17 new unit tests cover pixel snapping, line drawing in every direction, sprite placement and flipping, and how fades are stepped.

Built with Swift 6 and SwiftUI. Requires macOS 26.4+.

wthrr v1.1

Choose a tag to compare

@todddube todddube released this 10 Aug 00:16

wthrr 1.1 — Clear Skies, and twice as fast

A new weather scene for fair weather, a fix for Live Weather showing the wrong conditions, and a performance pass that roughly halves wthrr's CPU use.

Source: github.com/todddube/wthrr_mac


Clear Skies

A seventh weather mode, built for the days when there is no weather to speak of.

  • The sun tracks the sky by the clock — low and golden on the left at sunrise, high and blue-white at midday, low on the right at sunset. The position moves continuously through the day rather than snapping between fixed spots.
  • Volumetric light shafts fan out from the sun, each breathing in width and length on its own phase. Toggle them with the Sun Rays switch.
  • Lens flare — ghost discs spaced along the axis from the sun through the centre of the screen.
  • Big sunlit cumulus — two to three times wider than the precipitation clouds and spread through the upper half of the sky. Every cloud is shaded from the same direction as the sun, so the whole flock reads as one coherent scene.
  • Drifting motes of pollen and dust, about a third of which rise on thermals. Motes near the sun brighten, warm, and pick up a soft bokeh halo.
  • Night sky — after sunset the scene becomes a cratered moon over a field of twinkling stars.
  • Birds cross the sky using the same Bird Count, Size, and Wildness controls as Aurora.

Live Weather accuracy

Live Weather was mapping several WMO codes to the wrong effect. Every branch now matches the real conditions:

  • Clear and partly cloudy (0–3) now show Clear Skies. Previously they showed rain, or snow if it was cold — there was no clear-sky scene to show, so the code substituted precipitation.
  • Fog (45, 48) now shows Fog. It had been mapped to rain despite the Fog mode existing.
  • Thunderstorms (95–99) now show the Thunderstorm scene rather than rain with lightning.
  • Unknown codes fall back to Clear Skies instead of snow.

Performance

Measured on an Apple M4 with a 6K display, heavy snow at 400 flakes with accumulation and clouds on, both builds running at the display refresh rate:

CPU
1.0 103%
1.1 53%
1.1 capped to 30 fps 40%

Fog with 400 wisps dropped from 24% to 20% on top of that.

What changed:

  • The physics model is no longer @Observable. Nothing observed it — redraws come from the timeline — so every property read and write in the frame loop was paying for Observation tracking that had no subscribers.
  • Snow crystal drawing is batched. A dendrite was 78 separate path allocations and 78 stroke calls per flake per frame; it is now 3 paths and 4 draw calls, with no change in appearance.
  • Colours are resolved once per frame instead of once per flake.
  • Fog and Aurora stopped rebuilding their gradients inside the draw loops. At 400 wisps fog was allocating roughly 1,600 throwaway colour objects every frame.
  • Smaller fixes in the physics loop: splash expiry no longer degrades quadratically under heavy rain, nearest-puddle lookup is a precomputed table rather than a linear scan per raindrop, and the accumulation smoothing pass reuses a buffer.

New in Behavior settings

  • Max Frame Rate — 30 / 60 / 120 / display native, defaulting to 60. Weather effects look identical at 60 and 120, so this roughly halves render work on a ProMotion display.
  • Hidden overlays suspend entirely. wthrr's overlays sit below normal windows, so they are fully covered most of the time. A covered overlay, or one on a sleeping display, now stops rendering altogether rather than drawing where nobody can see it.
  • Performance readout — live FPS and frame-time p50/p99 measured from wthrr's own frames. os_signpost intervals (frame and physics, category render) are emitted for use with Instruments.
  • Adaptive Quality now measures wthrr. It previously sampled system-wide CPU, so it throttled whenever anything else loaded the machine and never when wthrr was itself the expensive process. It now measures wthrr's own CPU share, and also backs off when wthrr misses its own frame budget.
  • System Low Power Mode is honoured. wthrr had its own Low Power setting but ignored the one in System Settings.

Under the hood

  • Built in Swift 6 language mode, warning-free.
  • A unit test target covering the sun's arc, the render budget, seeded RNG determinism, cloud and particle factories, snow crystal geometry, and weather-type persistence.
  • Running the test suite no longer fails when a copy of wthrr happens to be open.

Built with Swift 6 and SwiftUI. Requires macOS 26.4+.

wthrr v1.0

Choose a tag to compare

@todddube todddube released this 02 Jul 12:44

wthrr 1.0 — Open-Source Release

wthrr is now free, open-source software under the MIT License. Build it yourself, fork it, contribute to it.

Source: github.com/todddube/wthrr_mac


What's in 1.0

Weather Effects

  • Snow — procedural snowflakes with three crystal shapes (dots, star plates, dendrites) assigned by size; per-flake rotation, wobble, and blue tint; drift accumulation with adjustable depth and melt rate; Screen Frost ice crystal formations creep from edges during heavy snowfall
  • Rain — wind-angled streaks, expanding double-ring impact splashes, persistent puddles with specular shine and ripple rings
  • Thunderstorm — heavy rain with dark storm clouds, forced lightning strikes, all intensity knobs at maximum
  • Fog — slow-drifting translucent gradient bands and large soft wisp particles
  • Aurora Borealis — rippling vertical bands of green, purple, and teal; animated silhouette birds with independent speeds, sizes, and flap phases; configurable count, size, and wildness
  • AI Storm — neon glitch particles, scan line distortion, circuit-trace data bolts, corruption patches, alien ships with organic steering, screen fracture cracks; 4 color palettes: Cyberpunk, Synthwave, Matrix, Inferno

Live Weather

Auto-pulls real conditions from Open-Meteo — applies weather type and intensity from your actual location. Shows location name and temperature in the header.

Presets

9 built-in presets plus save/load/delete of custom named presets. Import and export as JSON to share between machines.

Settings

  • Appearance — particle amount, speed, opacity, per-weather color controls, snow melt rate, AI Storm density, aurora bird count/size/wildness
  • Environment — wind strength/direction/angle, cloud size/speed/opacity, drift accumulation depth, lightning frequency
  • Presets — built-in + user presets, save, delete, import/export JSON
  • Behavior — Launch at Login, Seasonal auto-switch, Night Dimming, Low Power Mode

Settings Weather Picker

Persistent weather type picker in the settings window — switch modes without leaving any tab; controls update instantly.

Multi-Display

Overlays span all connected displays or target specific monitors. Windows rebuild automatically on display changes.

Global Hotkey

Pause/Resume with a configurable global hotkey (default Cmd+Shift+P), works when the app isn't focused.

Screenshot Preview

Right-click the menu bar icon → Screenshot Preview for a clean 1280×800 capture window.


Built with Swift 6 and SwiftUI. Requires macOS 26.4+.

wthrr v1.02b

Choose a tag to compare

@todddube todddube released this 26 Apr 13:56

wthrr 1.02b — What's New

Aurora Birds

  • Animated birds in Aurora mode — silhouette birds drift across the aurora sky, flapping organically with independent speeds, sizes, and phases; no two birds move in sync
  • Bird Count — slider in Appearance settings (0 = off, up to 20); labeled Off / Few / Flock / Many / Murmur
  • Bird Size — size multiplier from Tiny to Huge (0.5× – 3.0×); default wingspan ~28 pt
  • Wildness — controls per-bird variation in size, speed, altitude, and flap rate (Uniform → Wild); at 0 you get a tidy flock, at 1 birds scatter chaotically across the sky

Settings Weather Picker

  • Switch weather from within settings — a persistent icon + label picker sits between the tab toolbar and content area on every settings tab; selecting a type updates the live overlay immediately and the tab controls refresh to match (Melt Rate for Snow, Bird controls for Aurora, Effect Density for AI Storm, etc.)
  • Picker is disabled and dimmed when Live Weather is active

Bug Fixes

  • Thunderstorm label truncation — "Thunderstorm" now scales down gracefully in the menu bar popover header instead of clipping

wthrr v1.01b

Choose a tag to compare

@todddube todddube released this 09 Apr 18:36

wthrr 1.01b — What's New

Settings & UI

  • Settings footer on every tab — About, Onboarding, and What's New buttons now appear at the bottom of all four settings panels (Appearance, Environment, Presets, Behavior), with app version and GitHub link for quick reference
  • App version in popover — version, build number, and GitHub link shown in the menu bar popover footer for consistency

Splash Screen

  • Don't show on startup — new checkbox on the splash screen lets you disable the startup splash; preference is remembered across launches
  • Startup splash fix — fixed splash screen buttons not rendering until mouse hover on launch (window now activates correctly on all macOS versions)

Performance

  • Adaptive Quality — new Behavior setting that automatically halves particle count when CPU exceeds a configurable threshold (default 70%) and drops to 30 fps when battery is below a threshold (default 20%) while unplugged; live status indicator shows current state

Scripts

  • DMG background — installer window now features a weather showcase background: aurora gradient, snowflakes, rain streaks, lightning bolt, and fog wisps
  • Build script improvements — --bg-only and --dmg-only flags for faster iteration; shows build number in preflight output