WondayWall
A personal wallpaper app for Windows that generates wallpapers based on your schedule and interests.
WondayWall uses Gemini API to generate wallpapers from your calendar events, RSS news, and interest keywords. Instead of showing a simple slideshow, it brings a scene that reflects your day to your desktop.
Requirements
- Windows 10 / 11
- .NET 10 Runtime
- Google Calendar integration
- Google AI API key
Setup
- Download
WondayWall-(version).msifrom the releases page - Run the downloaded MSI and follow the installer prompts
- Launch the installed WondayWall app to open the setup screen
- Configure your Google AI API key
- Authorize Google Calendar (a browser opens during the first setup)
- Register your interest keywords and RSS feed URLs
- Use "Generate now" to verify that wallpaper generation works
For scheduled updates, select runs per day in the app settings and register the following command in Task Scheduler.
WondayWall.exe run-once
Features
| Feature | Description |
|---|---|
| Automatic wallpaper generation | Generates wallpapers with Gemini based on calendar events, news, and keywords |
| Google Calendar integration | Reflects today's and upcoming events in the wallpaper mood |
| RSS news integration | Reflects recent articles from configured feeds in the wallpaper theme |
| Manual generation | Generates a wallpaper immediately from the GUI |
| Generation history | Shows previously generated wallpapers |
| CLI mode | Supports run-once and generate for Task Scheduler and manual execution |
CLI Commands
WondayWall.exe run-once # Generate once only if the current scheduled slot has not been processed
WondayWall.exe generate # Generate immediately
WondayWall.exe check-calendar # Check calendar access
WondayWall.exe check-news # Check news feed access
WondayWall.exe check-google-ai # Check Gemini API access
Data Storage
| Data | Path |
|---|---|
| Settings file | %LocalAppData%\WondayWall\config.json |
| Generation history | %LocalAppData%\WondayWall\history.json |
| Generated images | %LocalAppData%\WondayWall\wallpapers\ |
| OAuth tokens | %LocalAppData%\WondayWall\calendar-token\ |
Schedule
- Runs per day can be selected from
1 / 2 / 3 / 4 / 6 / 8 / 12 / 24 - Run times are fixed slots that divide 24 hours evenly
- Examples:
1run is0:00,2runs are0:00 / 12:00, and4runs are0:00 / 6:00 / 12:00 / 18:00 - If a scheduled slot is missed,
run-oncecatches up only the pending slot at the next logon
Development
git clone https://github.com/Freeesia/WondayWall.git
cd WondayWall/WondayWall
dotnet build
See dev.md for development details.