weather-forecast

weather-forecast is a simple weather dashboard that retrieves data from OpenWeatherMap. The project is built for a Raspberry Pi 5" screen. It includes a custom 3d-printed case with stand.

• Optimized for 800x480 resolution.
• If you're viewing on a 1920x1080 monitor, zoom the browser to 200% to approximate the intended element sizes on the Pi display.

Contents:

• weather-forecast - Contents:
  • How to setup:
  • High-contrast mode
  • 3D-printed case
  • Hardware

How to setup:

1. Clone the repository

git clone https://github.com/infinitel8p/weather-forecast.git

2. Navigate into the project directory

cd weather-forecast

3. Setup the environment variables in .env file
   • OPENWEATHERMAP_API_KEY — Your OpenWeatherMap API key (used for all weather data and geocoding)
   • OPENWEATHERMAP_API_VERSION — The API tier to use:
     • 3.0 (default) — One Call API 3.0 (paid subscription)
     • 2.5 — One Call API 2.5 (legacy paid subscription)
     • free — Free tier using the standard Weather + Forecast endpoints (no UV index, 3-hour forecast intervals instead of hourly)
   • LANGUAGE — UI language: en (default) for English or de for German. Also affects weather descriptions from the API and date/time formatting.

Note

Choose the API version based on your OpenWeatherMap subscription. The free option allows you to run the dashboard without a paid subscription, but with limited features and less granular forecast data.

4. Install the dependencies

npm install

5. Start the development server

npm run dev

Settings

Open /config (or tap the small gear icon in the bottom-right corner of the dashboard) to adjust the dashboard:

• Night mode - switch between day and night theme on a fixed hour schedule (default: night from 22:00 to 06:00) or automatically at sunrise/sunset for your location.
• Timezone - used for all displayed dates and times and for the night mode schedule (default: Europe/Berlin). If night mode seems to switch at the wrong time, check this first - it also fixes devices whose system clock runs on UTC.
• Language - German or English.
• High contrast - a stronger variant of the day theme for small or low-quality screens (see below).

Settings are stored as cookies in the browser that displays the dashboard, so they survive reboots of a kiosk setup.

High-contrast mode

For small or low-quality screens (like the Raspberry Pi 5" touchscreen), a high-contrast variant of the day theme is available. Enable it on the /config page, or append ?hc to the URL to force it for a single session:

http://localhost:4321/?hc
http://localhost:4321/setup?hc

This increases text contrast, makes cards more opaque, deepens borders, and strengthens the geometric background elements for better readability. The night theme is unaffected.

3D-printed case

The case is designed to fit a Raspberry Pi 5" screen. The design files are available on MakerWorld.

• MakerWorld

Hardware

• Raspberry Pi 4
• 5" HDMI screen such as this one