Repository navigation
wthrr v1.0
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+.