Meteorología en tu terminal: weathr – Aplicación de clima con arte ASCII

Clima en tu terminal: weathr – Aplicación de clima con arte ASCII

Si amas la comodidad de la línea de comandos y quieres un recordatorio visual diario de que el clima está a pocos clics, weathr es la herramienta que has estado esperando. Construido en Rust, weathr recupera las condiciones actuales desde la API gratuita de Open‑Meteo y muestra el clima animado directamente en tu terminal con arte ASCII nítido.

¿Por qué weathr?

• Retroalimentación instantánea: Sin navegadores web – el clima está directamente en tu consola.
• Atractivo visual: Lluvia, copos de nieve, relámpagos y nubes de avión se animan sobre un fondo diurno/nocturno.
• Multiplataforma: Funciona nativamente en Linux, macOS, Windows e incluso en WSL.
• Autocontenido: Un solo binario, sin dependencias externas más allá de la toolchain de Rust.
• Código abierto y bajo GPL‑v3: Haz fork, modifica o envía una solicitud de extracción.

Inicio rápido

Instalar a través de Cargo – la forma más fácil si ya usas Rust:

cargo install weathr

Homebrew (macOS)

brew install Veirt/veirt/weathr

AUR (Arch)

yay -S weathr

Windows (Winget)

winget install -i Veirt.weathr

Compilar desde la fuente (requiere Rust):

git clone https://github.com/Veirt/weathr.git
cd weathr
cargo install --path .

Configuración

La aplicación busca config.toml bajo las carpetas de configuración convencionales de cada SO:

| Sistema | Ruta de configuración predeterminada | |--------|-----|-------------| | Linux | ~/.config/weathr/config.toml | | macOS | ~/Library/Application Support/weathr/config.toml | | Windows | ~/AppData/Roaming/weathr/config.toml |

Crea el directorio, edita el archivo y configura tus preferencias. Configuración de ejemplo:

# Ocultar la pantalla de información (HUD)
hide_hud = false
# Ejecutar silenciosamente (solo errores son mostrados)
silent = false

[location]
# Sobrescribir localización automática; establecer a `true` para consultar la ubicación por IP
auto = true
# Latitud y longitud para sobreescritura manual
latitude = 51.5074
longitude = -0.1278
# Ocultar el nombre de la ubicación en el HUD
hide = false

[units]
# Unidad de temperatura: "celsius" o "fahrenheit"
temperature = "celsius"
# Unidad de velocidad del viento: "kmh", "ms", "mph", o "kn"
wind_speed = "kmh"
# Unidad de precipitación: "mm" o "inch"
precipitation = "mm"

Ejecutando la aplicación

Solo escribe:

weathr

La aplicación resolverá tu ubicación, obtendrá el clima actual y comenzará el bucle de animación. Los controles de teclado son mínimos:

• q o Q – Salir.
• Ctrl+C – Salida inmediata.

Simular condiciones

Para desarrolladores o pruebas, puedes simular cualquier condición climática:

weathr --simulate rain
weathr --simulate snow --night
weathr --simulate clear --leaves

Opciones de línea de comandos

Los banderas pueden combinarse, por ejemplo, weathr --imperial --auto-location.

Variables de entorno

• NO_COLOR=1 – Desactivar salida en color.
• COLORTERM=truecolor – Forzar soporte de color 24‑bit.
• TERM=xterm-256color – Detección de capacidades de terminal.

Nota de privacidad

Cuando se activa la localización automática, weathr realiza una única solicitud a ipinfo.io para resolver tu IP a latitud/longitud. Esto es opcional y puede desactivarse estableciendo auto = false o omitiendo la bandera. No se almacenan ni envían datos personales al proveedor de clima.

Roadmap

1. API de clima adicionales – Integrar OpenWeatherMap y WeatherAPI para redundancia.
2. Atajos de teclado – Refresco manual, control de velocidad, pausar animación, alternar HUD.
3. Módulo Home-Manager – Soporte completo de configuración NixOS.
4. Temas personalizados – Importar conjuntos de arte ASCII definidos por el usuario.

Contribuir

¡Damos la bienvenida a contribuciones! Haz fork del repositorio, realiza tus cambios y abre una solicitud de extracción. El proyecto se prueba con CI en Linux y macOS. Las contribuciones pueden incluir corrección de errores, nuevas condiciones climáticas o mejoras de usabilidad.

Créditos

• Datos meteorológicos – Open‑Meteo.com (CC BY‑4.0)
• Arte ASCII – Diversos artistas de asciiart.eu
• Crates de Rust – reqwest, serde, crossterm, clap

weathr es una aplicación de clima centrada en el terminal y de código abierto que convierte tu línea de comandos en un widget meteorológico. Si buscas una manera ligera y elegante de estar informado sobre el cielo sin salir de tu terminal, instala weathr hoy y deja que las animaciones pronostiquen tu día.