Accessible desktop weather for Windows, macOS, and Linux.
AccessiWeather is a screen-reader-friendly weather app with keyboard navigation, desktop notifications, optional alert sounds, and multiple weather sources. It separates current conditions, daily forecast, hourly forecast, and alerts so the information is easier to scan with speech or braille.
- Combines multiple weather sources instead of locking you to one provider
- Shows separate
Current Conditions,Daily Forecast,Hourly Forecast, andWeather Alertssections - Supports US and international locations
- Tracks alert lifecycle changes such as new, updated, escalated, extended, and cancelled alerts
- Offers optional AI weather explanations and a conversational Weather Assistant
- Includes weather history, air quality, UV index, aviation weather, NOAA Weather Radio, and sound pack support
AccessiWeather supports four weather providers:
- National Weather Service (NWS): Best for US forecasts, US alerts, and forecast discussions. This is the authoritative alert source for US locations.
- Open-Meteo: No API key required. Good global baseline forecasts, Open-Meteo model selection, and broad international coverage. It does not provide weather alerts in AccessiWeather.
- Pirate Weather: Optional API key. Best when you want worldwide WMO alerts, minutely precipitation guidance, and Dark Sky-style daily summaries. It is especially useful outside the US.
- Visual Crossing: Optional API key. Useful for weather history, global forecasts, and some alert coverage where available.
Automatic is the default. It merges available sources and uses source priority rules to fill gaps.
- For US locations, AccessiWeather uses NWS alerts only. Pirate Weather and Visual Crossing alerts are intentionally ignored there to avoid duplicate alerts with weaker metadata.
- For international locations, AccessiWeather uses Pirate Weather alerts when available, otherwise Visual Crossing if configured.
- If you add a Pirate Weather key, Automatic mode can also pull minutely precipitation guidance.
Automaticstill uses your configured US and International source-priority presets for current conditions and forecast merging.
Alert behavior depends on the source and location:
- NWS alerts: Best for US users. They include stronger metadata such as severity, urgency, certainty, and NWS-specific targeting options.
- Pirate Weather alerts: Based on worldwide WMO alert feeds. These are useful outside the US, but they may be broader regional alerts and may not match your exact county or zone.
- Visual Crossing alerts: Available in some regions, but they are generally less detailed than NWS for US use.
In the app you can:
- Enable or disable alerts entirely
- Enable desktop alert notifications separately
- Choose alert area behavior for NWS alerts: county, point, zone, or state
- Filter notifications by severity
- Turn on event notifications for forecast discussion updates, severe risk changes, and minutely precipitation start/stop
AccessiWeather works without paid services, but some features need optional keys:
- Pirate Weather: Global alerts, minutely precipitation, Dark Sky-style summaries
- Get a key at pirate-weather.apiable.io
- Visual Crossing: Weather history, global forecast enrichment, some regional alerts
- Get a key at visualcrossing.com/weather-api
- OpenRouter: Required for
Explain WeatherandWeather Assistant- Get a key at openrouter.ai/keys
- AVWX: Optional for better international aviation weather translations and speech output
- Entered from the
Aviation Weatherdialog, not the main Settings dialog - Get a key at account.avwx.rest
- Entered from the
API keys are stored in your system keyring by default.
Settings export/import does not include API keys. If you want to move keys between machines:
- Open
Settings > Advanced. - Choose
Export API keys (encrypted). - Save the encrypted bundle and remember the passphrase.
- On the other machine, use
Import API keys (encrypted)and enter the same passphrase.
Download builds from orinks.net/accessiweather or the GitHub releases page.
- Windows: MSI installer or portable ZIP
- macOS: DMG
- Linux: Build from source for now
Using uv:
git clone https://github.com/Orinks/AccessiWeather.git
cd AccessiWeather
uv sync
uv run accessiweatherUsing a virtual environment:
git clone https://github.com/Orinks/AccessiWeather.git
cd AccessiWeather
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
accessiweatherPortable mode is also available:
accessiweather --portableOn a fresh setup, AccessiWeather shows a short onboarding wizard.
- Launch AccessiWeather.
- In the onboarding wizard, add your first location or skip it for now.
- Optionally enter OpenRouter, Visual Crossing, and Pirate Weather API keys during onboarding.
- In portable mode, if you enter API keys, you can also create an encrypted portable key bundle during onboarding.
- After the wizard closes, review the readiness summary, then refresh to load current conditions, daily forecast, hourly forecast, and alerts.
If you need to run the onboarding wizard again manually, launch the app with --wizard.
- Current Conditions: Temperature, condition, wind, humidity, and other enabled metrics
- Daily Forecast: Multi-day forecast in its own section
- Hourly Forecast: Separate short-range outlook with configurable hour count
- Weather Alerts: Active alerts with lifecycle labels when alerts change
- Forecast Discussion: NWS Area Forecast Discussion for US locations
- Explain Weather: One-shot AI summary of the current weather
- Weather Assistant: Chat-style AI weather help
The main window also includes quick-action buttons for common tasks such as Add, Remove, Refresh, Explain, Discussion, Settings, and View Alert Details.
If Pirate Weather minutely data is available, AccessiWeather adds a short precipitation outlook to current conditions and can notify you when precipitation is about to start or stop.
The Settings dialog currently includes these tabs:
- General: Update interval, Nationwide location, tray text
- Display: Units, visible metrics, forecast length, hourly hours, time display, verbosity
- Data Sources: Source selection, Pirate Weather key, Visual Crossing key, Open-Meteo model, NWS station selection
- Notifications: Alert behavior, severities, event notifications, cooldowns
- Audio: Sound packs and per-event sound controls
- Updates: Update channel and check interval
- AI: OpenRouter key, model, explanation style, custom prompts
- Advanced: Portable/config tools, settings backup, encrypted API key transfer, resets
The current code binds these global shortcuts:
Ctrl+RorF5: Refresh weatherCtrl+L: Add locationCtrl+D: Remove locationCtrl+H: Weather historyCtrl+S: Open settingsCtrl+Q: QuitCtrl+E: Explain WeatherCtrl+T: Open Weather AssistantCtrl+Shift+R: Open NOAA Weather Radio
See CONTRIBUTING.md and AGENTS.md.
MIT. See LICENSE.
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}
![@factory-droid[bot]](https://avatars.githubusercontent.com/in/358017?s=64&v=4){kind=small}
![@repobird[bot]](https://avatars.githubusercontent.com/in/1115674?s=64&v=4){kind=small}
