docs/HOMEPAGE.md
This page intends to give some explanations to how features displayed in the main screen of Breezy Weather (version 6.0.2 and later) work and how they should be interpreted. Position of elements are described for a Left-to-Right display. Click here to access main screen documentation of versions before 6.0.2.
Main screen shows the weather for the selected location, with an optional drawer showing location list on large display devices.
In the background, you can see an animation matching the current weather condition.
The color of the background depends on dark mode settings and whether the sun is up for the selected location:
| App dark mode¹ | Location-based dark mode | Sun is up | Sun is down |
|---|---|---|---|
| Light | Follow day/night | Light | Dark |
| Light | Always dark when app is in dark mode | Light | Dark |
| Dark | Follow day/night | Light | Dark |
| Dark | Always dark when app is in dark mode | Dark | Dark |
¹If set to “Follow system”, pick the current system dark mode to read this table
This animation is dynamic by default, but you can choose a static one in the settings (Appearance).
On top, you have a back button to access location list and city name of the location on the left. On the right, you have an “Open in another app” button that lets you open this location coordinates in a compatible application. You also have an Edit button that lets you access different options specific to the location, such as:
Just below, you can see the last time of refresh.
Above weather blocks, you have details about current weather:
By default, blocks are configured to display in this order and can be reordered by drag & drop or from settings:
Some blocks may not show with some sources if the data is not available. Check sources for more info.
All blocks can be tapped on to access more details.
The number of small blocks displayed per row varies between 1 and 5 depending on your width display size and font scale.
The first blocks is always the Alerts.
Current alerts are listed with their starting time and ending time, if they are valid for a specific period. If there are no alerts currently, but there are some scheduled for the future, it will be written, and you will be able to tap on the text to see the details of these future alerts.
Nowcasting precipitation, not to be confused with Precipitation, are the precipitations in the very short term, minute by minute.
This block will show when you selected a compatible Nowcasting source AND there are precipitation in the next hour(s).
You can drag a guideline on the chart to see the expected precipitation quantity 5 minute by 5 minute.
Daily forecast is made of multiple tabs called trends. Order of daily trends can be changed in settings.
For each trend, the day of the week or "Today" is shown on top of each column, and just below, the day of the month and the month are shown.
The number of columns shown at once depends on your display size and font scale.
When data is missing for the whole period, the tab will be hidden.
From top to bottom:
If weather source has normals data, it will show two lines with maximum and minimum temperature normals for the month of the first day in forecast. If normals are not available, it will fallback to use a median maximum and minimum temperature for the daily forecast period.
Each column shows the maximum air quality index for the day (bar + text) from 00:00 to 23:59. More details about air quality index can be read in Air quality block section.
Bar color will have a different color according to air quality index:
Two lines show two alert levels (20 and 150). It can be disabled in the settings (Appearance).
From top to bottom:
Wind icons and speed bars have a different color according to Beaufort wind scale:
Two lines are shown corresponding to show when wind speed is exceeding Gentle breeze level for daytime and for nighttime. It can be disabled in the settings (Appearance).
Each column shows the maximum UV index for the day (bar + text).
Bar color will have a different color according to UV level:
A line shows the alert level (7). It can be disabled in the settings (Appearance).
From top to bottom:
Each column shows the sunshine duration in hours for the day (bar + text) from 00:00 to 23:59.
Bar color is always light orange. It’s filled relative to the maximum daylight duration (from sunrise to sunset) of the daily forecast period. For example, if there are 6 hours of sunshine today, and the maximum daylight duration is 12 hours, the bar will be half-filled (50%).
Feels like temperature is the first available data from this list:
From top to bottom:
If weather source has normals data, it will show two lines with maximum and minimum temperature normals for the month of the first day in forecast. If normals are not available, it will fallback to use a median maximum and minimum temperature for the daily forecast period.
Just like daily forecast, hourly is made of the same tabs called trends. Order of hourly trends can be changed in settings.
For each trend, the hour is shown on top of each column. If it is the first hour listed or if it midnight, the subtitle will be highlighted.
Only the next 24 hours are displayed at most.
The number of columns shown at once depends on your display size and font scale.
When data is missing for the whole period, the tab will be hidden.
From top to bottom:
Each column shows the air quality index for the hour (bar + text). More details about air quality index can be read in Air quality block section.
Bar color will have a different color according to air quality index:
Two lines show two alert levels (20 and 150). It can be disabled in the settings (Appearance).
From top to bottom:
Wind icons and speed bars have a different color according to Beaufort wind scale:
Each column shows the UV index for the hour (bar + text).
Bar color will have a different color according to UV level:
A line shows the alert level (7). It can be disabled in the settings (Appearance).
From top to bottom:
From top to bottom:
From top to bottom:
From top to bottom:
Each column shows the cloud cover percentage for the hour (bar + text).
Two lines show two levels (clear sky and partly cloudy). It can be disabled in the settings (Appearance).
From top to bottom:
Precipitation, not to be confused with the nowcasting chart, will show the expected precipitation quantity for the current half day (daytime at daytime, nighttime at nightime).
It will display the type of precipitation (rain, snow, sleet) in the text and as icon, if the information is known.
This blocks shows the current wind, with the wind origin as a background arrow.
Below is a small text:
Air quality uses the 2023 Plume index as a reference, and for SO2 and CO, it uses a similar scale based on WHO recommendations from 2021.
Tap on the block for more info about the thresholds.
AQIs above 250 follow a linear progression.
An AQI is calculated for O3, NO2, PM10 and PM2.5 pollutant, and the general AQI is the maximum value of these four.
The ¾ circle shows the general AQI, and it’s filled with a different color for each category, so you can easily see the pollution level. The maximum value for the circle and bars is 250. At greater value, the circle will always be fulfilled.
Currently show pollens for current day, will be updated in the future to show for the current hour.
Shows a maximum of two most dominant pollens (excluding mold) for that day, with at least concentration > 0. The details of supported allergens by the source can be seen by tapping on the block and accessing the pollen details page.
For each displayed pollen:
Shows the relative humidity percentage, and the dew point.
In the background, you can see the block being filled by a percentage close to the relative humidity percentage (there are 5 different background images, so it’s always approximate).
Shows the current UV index.
In the bottom of the block, there are 5 dots, with one of them enabled with the color of the current UV level. You can find details about the UV scale by tapping on the block.
Shows the current visibility.
The small text below shows the visibility level.
Here are the thresholds:
| Level | From | To |
|---|---|---|
| Very poor | 0 km | 1 km |
| Poor | 1 km | 4 km |
| Moderate | 4 km | 10 km |
| Good | 10 km | 20 km |
| Clear | 20 km | 40 km |
| Perfectly clear | 40 km | No limit |
Shows the current pressure at sea level.
The circle is filled from 963 mb/hPa to 1,063 mb/hPa (converted into your selected unit, if that’s the case).
This means that when the pressure is half filled (filled up to the top of the circle), the pressure is at a normal level (1,013.25 mb/hPa).
Arc show the progression of sun during their course for the currently observed day. The starting point is the sunrise time (the first one after midnight) and the endpoint is the sunset time. The sun icon remains on the endpoint after the sun set for the rest of the day.
The textual information are:
Special cases: when sun is always up, it will show “Polar day”, and when sun is always down, it will show “Polar night”.
Arc show the progression of moon during their course for the currently observed day. The starting point is the moonrise time and the endpoint is the moonset time. The moon icon remains on the endpoint after the moon set for the rest of the day.
The textual information are:
Special cases:
The clock will show the current time in this location. It automatically updates every minute.
An analog clock is displayed if one of the following conditions is met:
In the footer, you have credits and acknowledgment for the forecast source used for this location, and you can access them for all other sources by tapping the “More” link.