2015-11-09 16:38:45 -08:00

50 lines
1.4 KiB
Markdown

# Limnoria plugin for Weather Underground
## Installation
1) Download the plugin, either via Git clone or Limnoria's PluginDownloader (`install GLolol Weather`).
2) Load the plugin:
```
/msg bot load Weather
```
3) [Fetch an API key from Wunderground](http://www.wunderground.com/weather/api/) by signing up (free).
Once getting this key, you will need to set it on your bot before things will work.
```
/msg <yourbot> config plugins.Weather.apiKey <APIKEY>
```
## Example Usage
When calling the `weather` command, you can use zip codes (10002), cities (New York, NY), etc.
```
<GLolol> @weather 10002
<Atlas> New York, NY :: Mostly Cloudy :: 55F/12C (Humidity: 53%) | Monday: Mostly cloudy. Low 11C. Monday Night: Cloudy. Slight chance of a rain shower. Low 11C. Winds ENE at 10 to 15 km/h.
```
Users can also have their location remembered by the plugin's internal database so that
they will not have to continually type in their location.
```
<GLolol> @setweather 10002
<Atlas> Done.
```
This now allows a user to type in the weather command without any arguments:
```
<GLolol> @weather
<Atlas> New York, NY :: Clear :: 64F/17C | Wind: N@7kph | Thursday: Clear. Low 14C. Thursday Night: A clear sky. Low 14C. Winds SSE at 10 to 15 km/h.
```
Users can also have the bot remember their preferred options, such as using metric units when displaying forecasts:
```
<GLolol> @setuser metric False
<Atlas> Done.
```