aboutsummaryrefslogtreecommitdiff

wttrin.el

Emacs frontend for weather web service wttr.in.

This fork has a few minor improvements:

  • It displays the date and time the weather was displayed.
  • It allows for customizing the font and font height used to display.
  • On location re-query, the original weather buffer is closed, reducing buffer clutter.
  • The license has changed from the MIT license to the GNU General Public License Version 3.

In addition, this fork applies the following patches (outstanding in bcbcarl/emacs-wttrin):

All changes have been tested and are working as of Monday, April 01, 2024.

Bug reports and PRs are welcome.

Enjoy!

Usage

Set a default cities list for completion:

(setq wttrin-default-cities '( "Berkeley, California" "Taipei, Taiwan" "Tainan, Taiwan"))```

You can also specify default HTTP request Header for Accept-Language:

```elisp
(setq wttrin-default-accept-language '("Accept-Language" . "zh-TW")))```

As well as the unit system, "m" for metric and "u" for USCS/imperial (the default is to choose based on your location):

```elisp
(setq wttrin-unit-system "m")```

If you want the weather to display in a monospaced font other than your default, you may specify it:

```elisp
(setq wttrin-font-name "Hack Nerd Font Mono")```

You can specify the font height as well:

```elisp
(setq wttrin-font-name "Liberation Mono")```

Then run `M-x wttrin` to display the weather.

After the weather is displayed you may press `q` to quit the buffer or `g` to query the weather for another location.

![screenshot](https://raw.githubusercontent.com/cjennings/emacs-wttrin/master/wttrin.png?raw=true)

## LICENSE

GPL-v3