About
QWeather Pro is an integration that retrieves weather data from the QWeather (HeWeather) cloud service for Home Assistant. It adds a weather entity and sensors for air quality, weather warnings, real-time temperature, precipitation forecast, weather briefing and current humidity. Authentication works with a JWT key setup or an ordinary API key, and a city is added by latitude and longitude. Options cover the update interval, the number of daily and hourly forecast entries, and an optional custom detail popup that replaces the native one. An action returns the full weather dataset for an entity, with the option to limit the response to chosen data blocks. Requests use the Home Assistant system language where QWeather supports it, and a repair notice can appear for the daily API quota.
Automatic summary of the README and code of PraxiGEN/ha_qweather_pro. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
- Weather
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Add New City
- Account/Credential Reuse
Configure QWeather Pro
- API Host
- Geographical location. Only supports latitude and longitude (longitude first).
- Use JWT Authentication (Recommended)
- Ordinary API Key (Leave blank if using JWT)
Configure JWT Security Authentication
- Developer ID
- Project ID
- Key ID
Also asked when signing in again.
Add New City
- Geographical Location of New City
Confirm City Location
- List of Matching Cities
Re-authentication Required
- API Host
- Use JWT Authentication
- API Key
Reconfigure Authentication
- API Host
- Geographical Location
- Use JWT Authentication
- API Key
After setup
- Update Interval (minutes)
- Daily Forecast Days (3-10)
- Hourly Forecast Hours (24-168)
- Enable Custom UI Support (global)
- Replace native detail popup
Texts from the code of PraxiGEN/ha_qweather_pro.
Entities
- SensorsAir Quality, Weather Warnings, Real-time Temperature, Precipitation Forecast, Weather Briefing, Current Humidity
- WeatherWeather
Actions
- Get weather dataReturn the full weather dataset for a QWeather Pro weather entity, including current conditions, daily/hourly forecasts, air quality, warnings, life indices and the smart weather abstract. Optionally restrict the response to specific top-level data blocks using 'keys'.Fields: Keys
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:QWeather API KEY daily quota
Shows in Vulpo
Chart card, Lumen sky, Apple Watch.Information
- Installs
- 63 sharing analytics
- GitHub stars
- 24
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v1.2.8,
- Category
- Weather and alerts
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
qweather_pro- Issues
- Report an issue
