Rebuilt using the latest 2026 development standards, delivering not only highly accurate meteorological data but also ultra-fast native SVG weather cards and professional-grade detail popups.
-
🛡️ Security First
- Supports QWeather’s latest JWT (EdDSA) authentication.
- Automatically generates local Ed25519 key pairs to protect your API quota from unauthorized use.
-
⚡ Extreme Performance
- Backend: Powered by DataUpdateCoordinator with concurrent requests and smart caching to minimize API usage.
- Frontend: Removes heavy libraries like Chart.js; uses native SVG to render temperature trend curves with 10× faster performance.
-
📊 Deep Data
- Minutely precipitation: Native API-driven minute-level precipitation summary (e.g., “No precipitation in the next two hours”).
- Weather summary: Logically synthesized hourly weather trend summary.
- Rich sensors: AQI (with detailed components), today’s temperature range, alert count, weather summary, and more.
-
🎨 Professional Visuals
- Dashboard card: Faithfully recreates the look of premium weather apps, supporting 7-day and 24-hour forecast switching.
- Custom detail popup: When enabled, replaces HA’s default popup with lifestyle indices, alert details, and more.
-
🔄 Latest Standards
- Fully compatible with HA 2024.3+ WebSocket forecast subscription for long-term smooth operation.
QWeather Pro internationalized, providing a seamless localized experience for users worldwide.
- Automatic Language Sync: The integration automatically detects your Home Assistant system language (Settings -> System -> General) and requests weather data in the matching language (supporting 30+ languages).
- Smart Fallback Mechanism:
- Core Weather/Alerts/AQI: Supports all 30+ languages provided by QWeather API (e.g., German, French, Japanese, etc.).
- Minutely Precipitation & Life Indices: Due to API constraints, these specific fields will automatically fallback to English if the system language is not Chinese, ensuring stable data delivery.
- Localized Titles & IDs: During the setup flow, the integration fetches and locks the city name based on your current language (e.g., "BeiJing" in Chinese or "BeiJing" in English), generating clean, localized Entity IDs.
- In HACS → “Integrations”, click the three-dot menu.
- Select “Custom repositories”.
- Enter:
https://github.com/PraxiGEN/ha_qweather_pro- Choose category Integration.
- Click Add.
- Find QWeather Pro in HACS and install it.
- Restart Home Assistant.
- Download the latest release:
https://github.com/PraxiGEN/ha_qweather_pro- Extract and place
custom_components/qweather_prointo your Home Assistantcustom_componentsdirectory. - Restart Home Assistant.
This update was optimized with AI assistance and deeply refactored based on the original project:
dscao/qweather
- This project is not officially affiliated with QWeather.
- Meteorological data is provided by QWeather.
- Please comply with QWeather’s API usage policies.
Contributions are welcome!
- Submit Issues for bug reports or feature requests
- Submit Pull Requests to contribute code
- Join discussions to share ideas or suggestions
This project is open-sourced under the MIT License.
See the LICENSE file for details.
If this project helps you, please consider giving it a ⭐!
-
Home Assistant 2026.1+
The minimum supported version of this integration is Home Assistant 2026.1 or later.
-
To ensure the integration’s brand images display correctly, please use Home Assistant 2026.3 or later.
To ensure brand icons display correctly, it is recommended to use Home Assistant 2026.3 or later. Starting from 2026.3, Home Assistant introduced the custom_integrations directory and the Brands Proxy API, allowing custom integrations to include brand images directly within their own component folders.