Home

Weekaroo Wiki

Weekaroo is a local-first wall dashboard for families, roommates, classrooms, and small teams. It runs on hardware you control and shows a weekly calendar, local weather, rotating notes, timers, countdowns, daily facts, and optional AI-generated dashboard messages.

Repository: https://github.com/Fins1600/weekaroo

What Weekaroo is for

Weekaroo is designed for:

• Kitchen, hallway, classroom, or roommate dashboard screens
• Spare laptops, mini PCs, Raspberry Pi devices, wall tablets, or local network displays
• Families or groups that want calendar + weather + notes + timers + countdowns in one glanceable place
• People who want local config files instead of another hosted dashboard subscription

Weekaroo may be more than you need if all you want is a shared Google Calendar. It starts making sense when the screen is meant to be an always-on household board.

Core features

• 7-day calendar view from one or more ICS calendar feeds
• Local weather by ZIP/postal code
• Optional WeatherFlow Tempest support
• Rotating family messages and event-matched message rules
• Countdowns and count-up timers with themed popups
• Day notes for quick reminders
• Optional OpenAI-compatible AI message generation, handled server-side
• Local-first configuration, no hosted account required

Start here

• Quick Start
• Configuration
• Raspberry Pi and Linux Kiosk Setup
• Screenshots and Demo Data
• Privacy and Secrets
• FAQ

Project posture

Weekaroo is MIT licensed and meant to be easy to run, inspect, and customize. It is intentionally local/LAN-oriented. Do not expose it directly to the public internet without adding authentication, HTTPS, and a real threat model.