asturbike/bateria repository overview

⁠Indicador de Batería para Home Assistant (Docker)

Contenedor Docker para mostrar en una web ligera y móvil el estado actual de una batería conectada a Home Assistant. Consulta datos mediante su API REST y los muestra visualmente como un gauge en tiempo real.

⁠Características

• Muestra el estado estimado de batería (%).
• Gauge animado y responsive.
• Compatible con móvil y escritorio.
• Configuración vía archivo .env para facilitar despliegues.

⁠Requisitos

• Home Assistant accesible desde el contenedor (local o remoto).
• Token de largo plazo de Home Assistant.
• Sensor de batería con valores en % (ej: sensor.bateria_estimada).

⁠Variables de entorno

Crea un archivo .env junto al docker-compose.yaml o bien usa variables en el entorno de ejecución:

.env
HA_URL=https://tu-homeassistant.local:8123
HA_TOKEN=eyJ...tu-token...etc
ENTITY_BATTERY=sensor.victron_buelles_bateria_estimada     # Porcentaje estimado de batería (%)
ENTITY_VOLTAGE=sensor.victron_ble_battery_voltage          # Voltaje instantáneo (V)
ENTITY_CURRENT=sensor.victron_ble_battery_current          # Corriente instantánea (A)
ENTITY_STATE=sensor.victron_ble_mppt_state                 # Estado de carga, flotación,etc. 

⁠docker-compose

---
services:
  battery-monitor:
    image: asturbike/bateria:v0.1
    ports:
      - 5000:5000
    env_file:
      - .env
    restart: unless-stopped