tuiweather 0.3.0 → 0.3.2

package/README.md

@@ -4,7 +4,7 @@ Keyboard-driven terminal weather app: Dark Sky-style rain nowcasting, hourly and
 
 ## Features
 
-- **Rain nowcast** — minute-level "umbrella in N min" warnings derived from 15-minute precipitation buckets
+- **Rain nowcast** — minute-level "umbrella in N min" warnings derived from 15-minute precipitation buckets (Open-Meteo only; NWS has no minute-level precipitation feed — the nowcast panel hides and the watch bell stays inactive under `provider = "nws"`, nothing renders a false "Dry")
 - **Hourly + daily forecast** — sparkline temperature strip, emoji condition icons, precipitation probabilities, and (md+ widths) a UV/humidity/visibility summary row
 - **Location search** — type `/`, search the Open-Meteo geocoder, enter to add; locations persist to config
 - **Guided first run** — choose units and find a location without editing a config file
@@ -52,6 +52,7 @@ Use `tuiweather --help` for command-line options and `tuiweather --version` to p
 | --- | --- |
 | `r` | Refresh current location (bypasses cache) |
 | `[` / `]` | Previous / next location |
+| `l` | Open the locations overlay: switch, set default, delete, reorder |
 | `1`–`9` | Jump to location N by sidebar order (1-based; no-op out of range) |
 | `u` | Toggle metric / imperial units |
 | `/` | Search locations |
@@ -67,6 +68,8 @@ Use `tuiweather --help` for command-line options and `tuiweather --version` to p
 
 While the search overlay is open it owns the keyboard: type to search, up/down to move the cursor, enter to add the highlighted result, esc to cancel. Number, focus, and reorder keys are ignored while the search input is focused (same as `d`/`r`).
 
+The locations overlay (`l`) also owns the keyboard while open: up/down (or `j`/`k`) to move the cursor, enter or `1`–`9` to switch, `s` to set the cursor row as default, `d` twice to delete it, `J`/`K` to reorder it, `/` to jump into search, esc to close.
+
 ### One-line mode
 
 `tuiweather --one-line` prints a single line and exits — designed for tmux status bars and shell prompts:
@@ -113,7 +116,9 @@ tuiweather watch --location seattle
 
 Each poll prints the one-line status (prefixed with the location label). The bell rings only on a
 dry → wet transition, not on every poll. Rain already in progress when the watch starts does not
-bell. Desktop notifications are a planned follow-up.
+bell. The bell depends on the minute-level nowcast, which is Open-Meteo only: under
+`provider = "nws"` the nowcast panel hides and the bell stays inactive — nothing renders a false
+"Dry". Desktop notifications are a planned follow-up.
 
 ## Configuration
 
@@ -154,7 +159,7 @@ longitude = -122.6765
 | `time_format` | `12h` / `24h` / `auto` | `"auto"` | `auto` picks 12h when temperature units are imperial, else 24h |
 | `refresh_minutes` | integer | `10` | Minimum `1` |
 | `theme` | `day` / `night` / `auto` | `"auto"` | Accent palette; `auto` follows the location's sunrise/sunset. Text ink always adapts to your terminal's background |
-| `provider` | `openmeteo` / `nws` | `"openmeteo"` | Weather data source; NWS air quality is not provided |
+| `provider` | `openmeteo` / `nws` | `"openmeteo"` | Weather data source. Open-Meteo is the default full-feature experience; NWS is the official US source fallback — works: conditions, temperatures, precipitation probabilities; goes quiet: minute-level nowcast (panel hides, watch bell inactive), hourly/daily precip amounts (blank bars/chips), air quality |
 | `daily_days` | integer | `7` | `1`–`16` forecast days |
 | `hourly_hours` | integer | `24` | `12`–`48` forecast hours |
 | `default_location` | string | none | Must match a `[[locations]]` slug |