Skip to content
This repository has been archived by the owner on Feb 11, 2024. It is now read-only.
/ noaa Public archive

View an NOAA weather forecast for a specific geographic location.

License

Notifications You must be signed in to change notification settings

thomp/noaa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

noaa.el

<2024-02-11> Archived & moved to codeberg.org. https://codeberg.org/thomp/noaa

View a simple summary of an NOAA weather forecast

The NOAA exposes a number of services which provide weather-related data. noaa.el provides an interface for viewing USA forecast data at api.weather.gov.


Getting started without the Emacs package manager

  1. Download noaa.el.

  2. Load noaa.el. For example, you might add the following line to ~/.emacs:

    (load "/path/to/noaa.el")

Use

  1. Use M-x noaa to invoke noaa.

  2. When done, use q to invoke noaa-quit.

Configure noaa.el

If calendar-latitude and calendar-latitude are already defined, those values will be used. If they are not defined, ensure noaa-latitude and noaa-longitude are set to the desired values. For example, one might set them via ielm (M-x ielm):

;; set latitude and longitude for noaa.el
(setq noaa-latitude 45)
(setq noaa-longitude 120)

NOAA accepts coordinates as floating point numbers with up to four digits of precision (eg. 45.1234).

Additional notes on use

  • The header line lists useful keybindings

    • n to cycle through forecast view styles

    • h to view an hourly forecast

    • d to view a daily forecast (the default)

    • c to view a forecast for a different USA location.

      • You can enter a CITY, ST location string, or if you just press enter you'll be prompted for latitude and longitude coordinates.
    • q to quit

Customization

The default forecast presentation styles don't present all of the possible data available from NOAA. You can customize the styles to suit your needs by modifying variables noaa-daily-styles and noaa-hourly-styles with reference to the NOAA api. Two useful reference URLs are indicated in the source code.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

If you did not receive a copy of the GNU General Public License along with this program, see http://www.gnu.org/licenses/.

About

View an NOAA weather forecast for a specific geographic location.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •