Display current weather conditions from Open Meteo with customizable location, units, and format.

☀️ 15°C            # Dynamic icon mode (default)
󰖐 15°C             # Static icon mode
☀️ 15°C Clear      # With condition text
🌧️ 8°C ↗5km/h     # Temperature with wind
❄️ -5°C 65%        # Negative temperature with humidity

# macOS (Homebrew)
brew install curl

# Linux (usually pre-installed)
sudo apt install curl      # Debian/Ubuntu
sudo dnf install curl      # Fedora
sudo pacman -S curl        # Arch

# Enable plugin (auto-detects location)
set -g @powerkit_plugins "weather"

# Enable plugin
set -g @powerkit_plugins "weather"

# Location (empty for auto-detect, or city name)
set -g @powerkit_plugin_weather_location ""

# Units: m (metric/Celsius), u (US/Fahrenheit), M (SI/Kelvin)
set -g @powerkit_plugin_weather_units "m"

# Format string (%t=temp, %c=condition icon, %C=condition text, %w=wind, %h=humidity)
set -g @powerkit_plugin_weather_format "%t"

# Language code (optional)
set -g @powerkit_plugin_weather_language ""

# Hide + sign on positive temperatures (default: true)
set -g @powerkit_plugin_weather_hide_plus_sign "true"

# Icon (used when icon_mode is static)
set -g @powerkit_plugin_weather_icon "󰖐"

# Icon mode: static (use icon option) or dynamic (use weather condition symbol from API)
set -g @powerkit_plugin_weather_icon_mode "dynamic"

# Cache duration (seconds) - weather updates slowly
set -g @powerkit_plugin_weather_cache_ttl "1800"

# Only show on threshold (not applicable for weather)
set -g @powerkit_plugin_weather_show_only_on_threshold "false"

Open Meteo supports various format codes for customizing weather display:

# Temperature only
set -g @powerkit_plugin_weather_format "%t"
# Output: 15°C

# Temperature with condition
set -g @powerkit_plugin_weather_format "%c %t"
# Output: ☀️ 15°C

# Full weather info
set -g @powerkit_plugin_weather_format "%c %t %C"
# Output: ☀️ 15°C Clear

# Temperature with wind and humidity
set -g @powerkit_plugin_weather_format "%t %w %h"
# Output: 15°C ↗5km/h 65%

Open Meteo Geocoding API supports 27+ languages for location names. Weather descriptions use WMO (World Meteorological Organization) codes and are displayed in English.

Note: Weather descriptions always appear in English (based on WMO weather code standards).

set -g @powerkit_plugins "weather"

Output: ☀️ 15°C

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_location "London"

Output: ☀️ 12°C

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_units "u"

Output: ☀️ 59°F

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_icon_mode "static"
set -g @powerkit_plugin_weather_icon "󰖐"

Output: 󰖐 15°C

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_hide_plus_sign "false"

Output: ☀️ +15°C

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_format "%t %C"

Output: ☀️ 15°C Clear

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_format "%t %C"

Output: ☀️ 15°C Clear

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_format "%t %w %h"

Output: ☀️ 15°C ↗5km/h 65%

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_format "%t %C"
set -g @powerkit_plugin_weather_language "pt"

Output: ☀️ 15°C Limpo

set -g @powerkit_plugins "weather"
set -g @powerkit_plugin_weather_cache_ttl "900"  # 15 minutes

The location option accepts the following formats:

Note: Geocoding is handled automatically via Open Meteo Geocoding API. Location names are converted to coordinates in the background with 24-hour caching.

1. Check network connectivity:

   curl -I https://api.open-meteo.com/v1/forecast

2. Verify curl is installed:

   which curl
   curl --version

3. Test Open Meteo API manually:

   # Auto-detect location based on IP
   curl "https://geocoding-api.open-meteo.com/v1/search?count=1&language=en&format=json"
   
   # Get weather for a specific location (Paris)
   curl "https://api.open-meteo.com/v1/forecast?latitude=48.8566&longitude=2.3522&current=temperature_2m,weather_code,is_day&temperature_unit=celsius"

Auto-detection uses your IP address. To force a specific location:

set -g @powerkit_plugin_weather_location "Paris, France"

The location is geocoded (converted to coordinates) automatically. You can use city names with optional state/country:

• London
• Paris, France
• Paris, Texas

Open Meteo typically responds in under 2 seconds. To improve performance:

1. Increase weather cache duration:

   set -g @powerkit_plugin_weather_cache_ttl "3600"  # 1 hour

2. Increase geocoding cache (locations don't move):

   set -g @powerkit_plugin_weather_geocoding_cache_ttl "604800"  # 7 days

3. Check your internet connection

Ensure your terminal supports Unicode and has proper font:

• Use a Nerd Font or font with emoji support
• Check terminal encoding is UTF-8

Open Meteo is free with no rate limits for reasonable usage. However, the plugin has built-in safety limits:

If you hit rate limits:

• Increase cache_ttl to reduce requests
• Adjust max_requests_per_hour setting if needed
• Avoid refreshing tmux status too frequently (use set -g status-interval 30)

Connection timeout is 5 seconds. If your connection is slow:

• Increase cache TTL to reduce API calls
• Check your internet connection stability
• Try manually testing the API endpoints above

Open Meteo does not provide atmospheric pressure or moon phase data. These placeholders will be removed from output:

• Use %p for precipitation instead of %P for pressure
• Moon phase (%m) is not available

If a location isn't found:

1. Try a more specific format: City, Country or City, State, Country
2. Check spelling and capitalization
3. Try an alternative name for the location
4. Verify the location exists in Open Meteo's database

The plugin caches geocoding results for 24 hours. To clear the cache:

rm -rf ~/.cache/tmux-powerkit/data/geocode*

Then reload tmux:

tmux source ~/.tmux.conf

This plugin uses the Open Meteo API:

• Free and open source
• No API key required
• High-quality weather data
• Supports worldwide locations
• Aggressive caching reduces API calls

1. Geocoding API: Converts location names to coordinates

   • Endpoint: https://geocoding-api.open-meteo.com/v1/search
   • Cache: 24 hours (locations don't move)
   • IP-based fallback for auto-detection

2. Weather API: Retrieves current weather

   • Endpoint: https://api.open-meteo.com/v1/forecast
   • Cache: 30 minutes (configurable)
   • Uses WMO weather code standards

• Typical API response time: < 2 seconds
• Geocoding results cached for 24 hours
• Weather results cached for 30 minutes (default)
• Rate limiting: 60 requests per hour (default, adjustable)

This plugin was migrated from wttr.in to Open Meteo in January 2025. Key differences:

• ✓ Auto-detection of location via IP
• ✓ City name support with intelligent geocoding
• ✓ All format string options (except %P and %m)
• ✓ Multiple unit systems (metric, US, SI)
• ✓ 27+ languages for location names
• ✓ Dynamic weather icons based on WMO codes
• ✓ Caching and rate limiting

• ✗ Moon phase (%m) - not available in Open Meteo
• ✗ Atmospheric pressure (%P) - not in current API variables
• ✗ Airport codes - only city names accepted

• ✓ Faster response times (typically < 2 seconds)
• ✓ Better geocoding with fallback chain
• ✓ More aggressive caching (24h for locations)
• ✓ No external IP service dependency
• ✓ Built-in rate limiting safety

All existing configurations continue to work unchanged. The plugin automatically handles location geocoding in the background, so your @powerkit_plugin_weather_location settings remain valid.

• PluginDatetime - Date and time display
• PluginTimezones - Multiple timezone display
• PluginExternalIp - Public IP address