A fullscreen clock and weather dashboard designed for Raspberry Pi and the Wisecoco 8.8" IPS HDMI display. The UI pulls real-time weather data from Open-Meteo and works great mounted under cabinets or as a minimalist desk display.
- Digital clock with configurable 12h or 24h format
- Day/date display
- Real-time weather via Open-Meteo (no API key required)
- Custom SVG weather icons
- Auto screen rotation to landscape
- Optional background images with day/night support
- Auto-start with PM2 on boot
- Clean, modern layout designed for 1920×480 displays
- Raspberry Pi 4 (affiliate)
- or
- Raspberry Pi 5 (affiliate)
- Rasperry Pi Power Supply (affiliate)
- Wisecoco HDMI display (affiliate)
- Micro HDMI to HDMI adapter (affiliate)
- Raspberry Pi OS (Bookworm recommended)
- Download the install script
wget https://raw.githubusercontent.com/Canterrain/weather-display/main/setup.sh
chmod +x setup.sh
- Install the software:
./setup.sh
The setup script will:
- Install all required system and Node.js dependencies
- Set up screen rotation for landscape-oriented displays
- Configure PM2 to auto-launch the app at boot
💡 After setup finishes, everything should work automatically without reboot.
You can display background images by placing files in the public/assets/ directory.
If only a generic background is present, it will be shown during the day and hidden at night:
background.jpgbackground.webpbackground.png
You can also provide separate backgrounds for day and night:
background-day.jpgbackground-day.webpbackground-day.pngbackground-night.jpgbackground-night.webpbackground-night.png
✅ The first valid file found in each category will be used.
Recommended resolution: 1920×480
All weather icons are SVG files stored in:
public/assets/icons/
To use your own custom icons:
- Replace existing files using the same filenames (e.g.,
clear-day.svg,rain.svg, etc.) - Keep them in SVG format
- For consistent layout, aim for icons sized around 100×100 pixels
| Path | Description |
|---|---|
public/index.html |
Main UI layout |
public/style.css |
Display styles |
public/renderer/clock.js |
Time and date logic |
public/renderer/weather.js |
Weather data fetch & rendering |
server.js |
Express server for frontend |
scripts/rwc.sh |
PM2 launch script |
config.json |
Created by setup.sh for user configuration |
This project runs as a Node.js server (Express) and is typically launched via PM2 on a Raspberry Pi.
For development and testing, you can access the UI directly in a browser:
http://:3000/
The following developer-only query parameters are available for testing:
?force=day/?force=night
Forces day or night mode without waiting for real sunrise/sunset.
These testing features are opt-in and do not affect normal operation.
The setup script automatically configures PM2 to:
pm2 start scripts/rwc.sh --name weather-display
pm2 save
pm2 startup
This ensures the app runs on boot.
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.
© 2025 Josh Hendrickson
Shout out to the Magic Mirror team for inspiring some of this project.
Made by Josh Hendrickson