Weather Dock is a MacOS headless application that shows popover view under the menu bar with weather info. Application requests and uses user location data to provide weather forecast by coordinates. Also user could type any desired city name inline to get weather info for any city of his choise.
Application built with SwiftUI, requires MacOS Monterey 12.0 or later
- Refresh icon is a button that refreshes current weather status
- Locate icon is a button that updates current and forecasted weather data by current user location and sets this behaviour as default
- City name is an inline editable text field, where user can submit (with enter hit) any city name and application will try to get and update weather info based on entered value. Application will remember city name for further updates, if user wants to switch back to updates by coordinates, he should click Locate icon button.
- Mouse over Air quality data will show popover with Pollutants info
- Mouse over future day forecast will show popover with forecast details for that day
- Right click on Menu item (dock) element will show Quit button to close app
- Settings gear icon is a button that opens Setting view, following app settings are available:
- Units of measurement: imperial/metric
- Pressure unit: inHG/mmHG/hPa
- Time format 12h/24h
- Settings for customization of menu bar button to display temperature, short weather description, city name
- Launch at login setting
- Application updates data in a background, but update frequency is limited by OpenWeatherAPI free tier restrictions:
- Current weather data - every 1 hour
- Forecasted weather data - every 24 hours
- Also current weather data would be updated on popover open, but not more than once every 20 minutes
- Application powered by OpenWeatherAPI
- From version 2.0 application uses Apple's WeatherKit as data source
- Launch at login setting added as a dependency on LaunchAtLogin helper
- For changelog please visit Releases page
Application build requires Xcode 14.1 or later
-
Clone repository and open project with Xcode
-
Register OpenWeatherAPI free tier account and get your own API key
-
Create keys.plist file under project folder and add
Key Type Value openweather_api_key String {your API key} -
Starting from version 2.0 application uses WeatherKit from Apple, so make sure it's enabled in your https://developer.apple.com account in Services section
-
Build, run and enjoy!
If you need a support or have any questions, feedback, bug reports or feature requests, please, contact via Telegram chat https://t.me/weather_dock_app or Whatsapp https://chat.whatsapp.com/FtHmQLWtE4jBijg1THdgBJ