---
title: "Homarr Weather Widget — Current Conditions & Forecast"
aliases: [homarr-weather, homarr-weather-widget]
tags: [homarr, homelab, dashboard, widget, weather]
sources: [raw/Homarr documentation 3.md]
created: 2026-04-19
updated: 2026-04-19
---

## Overview

The Weather Widget displays current, high, and low temperatures for a configured location using data from the **Open Meteo API** (no API key required).

## Configuration Options

| Option | Description | Default |
|--------|-------------|---------|
| Temperature in Fahrenheit | Use °F instead of °C | no |
| Disable temperature decimals | Show whole numbers only | no |
| Show current wind speed | Wind speed for current conditions only | yes |
| Use imperial speed units | mph instead of km/h | no |
| Weather location | Search by name or enter `longitude,latitude` | Paris (48.85341, 2.3488) |
| Date format | ISO 8601 moment.js format string | `dddd, MMMM D` |
| Show city | Display city name in widget | no |
| Has forecast | Show multi-day forecast section | no |
| Amount of forecast days | Days shown in forecast | 5 (range: 1–7) |

## Adding the Widget

Follow the standard widget-add flow documented in [[wiki/homelab/homarr-boards|Homarr Boards]]: Edit Mode → Add Widget → Weather.

## Data Source

- Powered by **Open Meteo** (`https://open-meteo.com`) — free, no API key needed
- Whitelist `https://open-meteo.com` if running behind a restrictive firewall or egress policy

## Key Takeaways

- Location can be set via search UI or raw `longitude,latitude` coordinates — useful for precise or unlisted locations
- Forecast is optional and configurable from 1 to 7 days
- Wind speed is shown for current conditions only, not forecast days
- No credentials or API key required — Open Meteo is a free public API
- Unit toggles (°F, mph) are independent — mix metric/imperial as needed
- Pairs well with [[wiki/homelab/homarr-clock-widget|Homarr Clock Widget]] for a combined date/time + weather header row on a board

## Sources

- Homarr docs: https://homarr.dev/docs/widgets/weather/ (v1.59.2)
- Raw file: `raw/Homarr documentation 3.md`
