A console-oriented weather forecast service that delivers weather data via curl, HTTP, and various output formats.
wttr.in is a console-oriented weather forecast service that allows users to retrieve weather information via simple HTTP requests, primarily using curl. It provides weather data in various formats like ANSI sequences for terminals, HTML for browsers, PNG images, and JSON for APIs, making it versatile for different use cases. The service handles millions of queries daily and supports locations worldwide with features like internationalization and moon phase tracking.
Developers, system administrators, and terminal enthusiasts who need quick, scriptable access to weather data from the command line or want to embed weather information in applications, status bars, or web pages.
Developers choose wttr.in for its simplicity, ease of integration, and multi-format support, enabling weather data retrieval with a single curl command without complex APIs. Its open-source nature and self-hosting capability offer full control and customization compared to proprietary weather services.
:partly_sunny: The right way to check the weather
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Supports ANSI, HTML, PNG, JSON, and Prometheus metrics, allowing integration into terminals, web pages, scripts, and monitoring systems with simple HTTP requests, as highlighted in the 'Supported output formats' section.
Optimized for command-line use with one-line output formats perfect for status bars in tmux, WeeChat, and other applications, demonstrated in the integrations examples with configurable update intervals.
Provides weather reports in over 50 languages with automatic detection based on browser headers or manual selection via URL parameters, enhancing accessibility for international users.
Can be embedded into various tools and scripts using curl commands, with documented examples for conky, IRC, and even Squeak, making it highly adaptable for custom workflows.
Advanced views like data-rich (v2) and map (v3) are experimental, with v2 limited to English and terminal-only, and v3 having restricted format support depending on terminal capabilities.
Relies on WorldWeatherOnline for weather data and GeoLite for geolocation, meaning service availability, data accuracy, and potential costs are out of the project's control, as admitted in the installation section.
Installing and configuring wttr.in locally requires multiple steps, including obtaining API keys, setting up dependencies like wego and Python libraries, and configuring web servers, which can be daunting for casual users.
Emoji and moon phase representations can be ambiguous or broken depending on terminal fonts and settings, requiring manual configuration for proper display, as noted in the 'Emojis support' and moon phase caveats.