https://github.com/jason0x43/alfred-weather

Get weather forecast using Alfred
https://github.com/jason0x43/alfred-weather

Last synced: 3 months ago
JSON representation

Get weather forecast using Alfred

• Host: GitHub
• URL: https://github.com/jason0x43/alfred-weather
• Owner: jason0x43
• License: mit
• Created: 2016-09-12T03:58:32.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2022-10-08T17:46:05.000Z (over 1 year ago)
• Last Synced: 2024-01-25T05:38:25.614Z (5 months ago)
• Language: Go
• Size: 3.85 MB
• Stars: 158
• Watchers: 7
• Forks: 20
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Lists

• awesome-stars - jason0x43/alfred-weather - Get weather forecast using Alfred (Go)
• alfred-workflows - Weather - Get latest weather for the day, week. (Productivity)

README

        
# alfred-weather

An [Alfred][alfred] workflow for showing weather forecasts

![Screenshot](doc/daily.png?raw=true)

This workflow lets you access weather forecasts from several APIs:

- [ClimaCell][climacell]

- [OpenWeather][openweather]

- [Dark Sky][darksky]\*

\*Note that [Dark Sky was purchased by Apple](https://blog.darksky.net/dark-sky-has-a-new-home/) in early 2020 and has sunset their API. API keys are no longer being issued, and the API will cease service at the end of 2021.

---

## Installation

Download the latest workflow package from the [releases page](https://github.com/jason0x43/alfred-weather/releases) and double click it — Alfred will take care of the rest.

## Setup

The workflow has one top-level command, `wtr`, and three sub-commands, daily (`wtd`), hourly (`wth`), and options (`wto`). The first thing you'll need to do is configure some options.

![Options](doc/options.png?raw=true)

Some options are, well, optional, but the Service and related Key options, and a default location, are required. You need an API key for the service you choose. Both of the currently supported services (Dark Sky and OpenWeather) are free to use (for a reasonable number of requests per day).

- [OpenWeather API](https://openweathermap.org/api)

- [ClimaCell API](https://developer.climacell.co)

- [Dark Sky API](https://darksky.net/dev/) (no longer offering new API keys)

Once you've entered the service key, selection the "Location" option then enter a ZIP code or city name, then wait a couple of seconds. When it looks like your desired location has been found, press Enter to save it.

## Usage

The `wtd` keyword will show a forecast for the next several days.

![Daily forecast](doc/daily.png?raw=true)

The `wth` keyword will show a forecast for the next several hours.

![Hourly forecast](doc/hourly.png?raw=true)

In either case, you can enter a location query to get the forecast for somewhere other than your default location.

![Name query](doc/daily_name.png?raw=true)

![ZIP query](doc/daily_zip.png?raw=true)

Actioning a day in the daily forecast will jump to an hourly forecast for that day, if hourly data is available. Actioning the list heading will jump back to the daily forecast.

If there are any active weather alerts, they'll show at the top of the forecast. Actioning an alert will open more detailed information in a browser window.

If there is a newer version of the workflow available, a message will be displayed at the top of the result list. Actioning it will open a release page for the new version in a browser window.

![Update notice](doc/update.png?raw=true)

## Credits

The package includes a number of icon sets from the [Weather Underground](wund) and from [weathericonsets.com][icons] (I'm not up to drawing weather icons yet). Each set includes an `info.json` file that gives a short description and provides a source URL for the icon set.

[alfred]: https://www.alfredapp.com

[icons]: https://www.weathericonsets.com

[wund]: https://www.weatherunderground.com

[darksky]: https://darksky.net

[openweather]: https://openweathermap.org

[climacell]: https://climacell.co