weather-tui 1.0.0

A TUI application for displaying weather forecasts with hour-by-hour graphs

Weather TUI

A terminal user interface for displaying weather forecasts with hour-by-hour graphs and multi-day forecasts.

Features

• Current weather conditions with temperature
• Hourly temperature and precipitation graphs
• 7-day weather forecast with clickable day selection
• Location search powered by OpenWeatherMap Geocoding
• Keyboard-friendly navigation

Installation

Using uvx (recommended, no install needed)

# Run directly without installing
uvx --with weather-tui python -m weather_tui

From PyPI

pip install weather-tui

From source

# Clone the repository
git clone https://github.com/benedikt-mayer/weather-tui.git
cd weather-tui

# Install with uv (recommended)
uv sync

# Or with pip
pip install -e .

Usage

# If installed via pip
python -m weather_tui

Environment Variables

Variable	Required	Description
OPENWEATHERMAP_API_KEY	Yes	API key for geocoding. Get a free key at OpenWeatherMap

Create a .env file in your working directory:

OPENWEATHERMAP_API_KEY=your_api_key_here

Keyboard Shortcuts

Key	Action
s	Search for a new location
r	Refresh weather data
q	Quit
Escape	Cancel search
Click	Select a day to view its hourly forecast

Development

# Install dev dependencies
uv sync --extra dev

# Run tests
uv run pytest

# Run linting
uv run ruff check .
uv run ruff format --check .

# Fix linting issues
uv run ruff check --fix .
uv run ruff format .

Tech Stack

• Textual - TUI framework
• textual-plotext - Terminal plotting
• Open-Meteo - Weather data API (no key required)
• OpenWeatherMap Geocoding - Location search

License

MIT License - see LICENSE for details.