🌦️ weather-tty
Tiny CLI to print today's weather for your terminal — zero API keys, just vibes.
Preview
Features
- Zero-config: just type
weather-ttyand it will guess your city by IP. - Single-line summary:
🌤️ Pamplona, ES: 25°C/12°C · rain 0.0mm · wind 18 km/h · sun 08:10–19:14 - Multi-day forecast:
weather-tty --forecastfor a 5-day table. --citygeocoding (Open-Meteo) or--lat/--lon.- Units:
metric(default) orimperial. --timezoneto override the auto-detected IANA timezone.--no-emojifor boring terminals.--verbosepretty panel for humans.--versionto print the installed version.
Install
Requires Python 3.10+
Recommended (pipx)
The easiest way to install weather-tty as a CLI tool:
brew install pipx # if you don't have pipx
pipx install weather-tty
This installs weather-tty in an isolated environment and makes it available globally.
Alternative (pip)
pip install weather-tty
⚠️ On macOS with Homebrew Python, you may get an
externally-managed-environmenterror. Usepipxinstead, or create a virtual environment.
Usage
# auto-detect city by IP
weather-tty
# by city
weather-tty --city "Pamplona"
# 5-day forecast table
weather-tty --city "Pamplona" --forecast
# coordinates (overrides city)
weather-tty --lat 40.4168 --lon -3.7038
# imperial units
weather-tty --city "New York" --units imperial
# pretty panel
weather-tty --city "Pamplona" --verbose
# override the timezone
weather-tty --city "Pamplona" --timezone Europe/Madrid
# print version
weather-tty --version
Pro Tip: Terminal Greeting
Add weather-tty to the end of your .zshrc, .bashrc, or .bash_profile to get a fresh weather report every time you open a new terminal session:
# Add this to ~/.zshrc or ~/.bashrc
weather-tty
Notes
- Data source: Open-Meteo
- No API keys required.
- Default view is today's summary; pass
--forecastfor a 5-day table. - Location is resolved via IP by default; override with
--cityor--lat/--lon.
Development
uv sync --group dev
uv run ruff check . # lint
uv run ruff check . --fix # autofix
uv run ty check # type check (Astral ty)
uv run pytest --cov=weather_tty --cov-report=term-missing # tests + coverage
uv run weather-tty --city "Pamplona"
Metadata
Release files for weather-tty 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| weather_tty-0.3.1.tar.gz | 11.4 kB | Without provenance | Details for weather_tty-0.3.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| weather_tty-0.3.1-py3-none-any.whl | Python 3 | none | any | Details for weather_tty-0.3.1-py3-none-any.whl |
Total release size: 21.8 kB
Release files / weather_tty-0.3.1.tar.gz
| Download URL | weather_tty-0.3.1.tar.gz |
|---|---|
| Size | 11.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
186b6ba18a0a730006ad2e42ea092a4ba37e74c9f772a8eea6a2941132aaadbb
|
|
BLAKE2b-256 checksum How to use checksums |
c377d57424d93ae46b6b92ae5ba087c41182ff2400eabe6b32213e9a43981cf4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / weather_tty-0.3.1-py3-none-any.whl
| Download URL | weather_tty-0.3.1-py3-none-any.whl |
|---|---|
| Size | 10.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
362a73f68ad59dc5ae6721b97fb282ab538332404ca0a14808ba5e9e79c59d9e
|
|
BLAKE2b-256 checksum How to use checksums |
765d594ea1bc89e4bdef50f25d1a126db11f262417f04d805487fad3d94fc4fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for weather-tty 0.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.