Files
quick-weather.el/README.md
2025-12-14 09:59:13 +01:00

3.0 KiB

quick-weather

License: GPL v3

Note: Fork of aglet/sparkweather. Replaces hour ranges with single-hour markers, adds minimal brackets UI with NOW/FORECAST/MARKERS sections, and supports unlimited customizable time markers.

Quick weather forecasts with sparklines for Emacs, using data from Open-Meteo.

                                                  NOW
[ 18°C ]  ☀ mainly clear
───────────────────────────────────────────────────────
                                             FORECAST
[ 14—22°C ] ▂▂▃▃▄▅▅▆▇ ▇▇██▇▆▅▄▃▂▂▂▁▁▁
[  40% ⛆ ] ▁▁▁▁▁▁▁▁▁ ▁▁▂▃▄▅▅▅▃▂▁▁▁▁

───────────────────────────────────────────────────────
                                              MARKERS
[ 13 🍽️ ] ☀ clear sky
[ 17 🚌 ] ⛆ slight rain

Installation

(use-package quick-weather
  :vc (:url "https://github.com/tanrax/quick-weather.el")
  :after calendar
  :config
  (setq calendar-latitude 39.46975   ; Valencia, Spain
        calendar-longitude -0.37739)
  (setq quick-weather-time-windows
    '(("🍽️" 13 success)
      ("🚌" 17 warning))))

Configuration

Set your location using standard Emacs calendar variables:

(setq calendar-latitude 39.46975   ; Valencia, Spain
      calendar-longitude -0.37739)

Time Markers

Customize time markers to highlight specific hours in your day:

;; Default configuration (lunch at 1pm, commute at 5pm)
(setq quick-weather-time-windows
  '(("LUNCH"   13 success)
    ("COMMUTE" 17 warning)))

;; With emojis
(setq quick-weather-time-windows
  '(("🍽️" 13 success)
    ("🚌" 17 warning)))

;; Multiple markers
(setq quick-weather-time-windows
  '(("BREAKFAST"  7 success)
    ("LUNCH"     13 success)
    ("DINNER"    20 warning)))

;; No markers
(setq quick-weather-time-windows '())

Each marker is a list of: (LABEL HOUR FACE) where HOUR is 0-23 and FACE can be success, warning, or error.

Usage

M-x quick-weather displays today's forecast with current weather, temperature sparkline, and precipitation info. A small space in the sparklines indicates the current time, and colored blocks mark configured time markers with weather summaries.

Press g to refresh, q to close.

Features

  • Current weather: Temperature and weather condition
  • Minimal brackets UI: Clean, modern design
  • Temperature range: Daily min-max with sparkline visualization
  • Precipitation: Probability percentage with sparkline
  • Time markers: Customizable hour highlights with weather summaries

License

GPL-3.0