Weather Widget

Widget de escritorio para Linux que muestra el clima en tiempo real con iconos animados y efectos visuales.

Características

Feature	Descripción
Iconos animados	Sol, luna, nubes, lluvia, nieve, tormenta con animaciones
Clima en tiempo real	Datos de Open-Meteo, WeatherAPI y 7Timer
Geolocalización	Detecta tu ubicación por IP automáticamente
Ciudad manual	Cambiar ciudad con un clic
Expandible	Clic para ver humedad, viento y sensación térmica
Transparente	Fondo translúcido, siempre al fondo
Arrastrable	Mover el widget con el ratón
Auto-inicio	Se ejecuta automáticamente al iniciar sesión
Múltiples estilos	Colorido (emoji), plano o minimal

Requisitos

• Python 3.8+
• PyQt6
• requests
• Linux (GNOME, KDE o similar)

Instalación rápida

git clone https://github.com/yhas1984/Weather-Widget.git
cd Weather-Widget
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python weather_widget.py

Uso

python weather_widget.py

El widget aparecerá en la esquina inferior derecha de la pantalla.

Interacciones

Acción	Efecto
Clic	Expandir/colapsar detalles
Arrastrar	Mover widget
Clic derecho	Menú de opciones
Cambiar ciudad	Menú contextual → Cambiar Ciudad

APIs Meteorológicas

API	Prioridad	Descripción
Open-Meteo	1ª	Gratuita, sin key
WeatherAPI	2ª	Requiere API key
7Timer	3ª	Gratuita, alternativa

Iconos

El repositorio incluye múltiples versiones del icono:

Archivo	Descripción
icon.png	Icono principal (sol + nube + lluvia)
icon.svg	Versión SVG del icono principal
icon-minimal.png	Versión minimalista
icon-clean.png	Versión limpia y moderna

Estructura

Weather-Widget/
├── weather_widget.py    # Widget principal (PyQt6)
├── appPyQt.py           # Versión alternativa
├── requirements.txt     # Dependencias
├── icon.png             # Icono principal
├── icon.svg             # Icono SVG
├── icon-minimal.png     # Icono minimalista
├── icon-clean.png       # Icono limpio
└── .gitignore

Solución de problemas

Error de Qt platform plugin:

sudo apt install libxcb-xinerama0

Error de API: El widget usa múltiples APIs como respaldo. Si una falla, usa la siguiente automáticamente.

Instalación desde .deb

Los paquetes compilados se publican como assets en la sección Releases. Descarga el archivo weather-widget_*_amd64.deb y ejecuta:

sudo apt install ./weather-widget_*_amd64.deb

Open-Meteo funciona sin credenciales. WeatherAPI es opcional: define WEATHERAPI_KEY en el entorno si quieres habilitar ese respaldo.

Compilar el .deb

python -m pip install -r requirements.txt
bash packaging/build-deb.sh 5.0.4

Al crear un tag v5.0.4, GitHub Actions compila el paquete y lo publica automáticamente como asset del release.

Licencia

MIT