[Support] HAPass Invitations - Nebur692

## English

Fork of [Rohithkadaveru/ha-pass](https://github.com/Rohithkadaveru/ha-pass), an MIT-licensed

Home Assistant tool that creates shareable, time-limited guest links for controlling specific

entities (lights, locks, thermostats, fans...). Guests get a mobile-friendly PWA, no HA account or

app install needed. All credit for the original design goes to the original author.

This fork adds **advance/recurring scheduling** and related features aimed at replacing what a

smart-intercom "guest invitation" feature typically offers, while staying self-hosted and auditable.

What's new in this fork:

- **Advance scheduling** — a link that only activates at a future date/time.

- **Recurring weekly windows** — restrict a token to specific weekdays + daily time range.

- **Automatic delivery** via any HA notify.* service, configurable lead time.

- *buttoninput_button domain support** (e.g. gate/door relay helpers).

- **Opt-in entity suggestions** for Access/Lights invitation modes.

- **Local-network-only command execution** for access-type domains (checks source IP; honest

limitation, not GPS-based).

- **Single-device link binding** — first device to open a link claims it.

- **Single-use links**, on top of the existing "Never expires" option.

- **Bilingual EN/ES UI** — both admin dashboard and guest PWA.

None of this touches the original security model — same allowlist, rate limiting, and IP

allowlisting from upstream still apply.

**Install:**

- Home Assistant Add-on: add repository https://github.com/Nebur692/ha-pass-invitations under

Settings → Add-ons → Add-on Store → ⋮ → Repositories.

- Unraid (standalone container, for HA Core installs without Supervisor): Docker → Add Container →

Template repositories → add https://raw.githubusercontent.com/Nebur692/ha-pass-invitations/main/ha-pass-invitations.xml

- Docker Compose: see the repo README.

Requires a Home Assistant Long-Lived Access Token. Not yet listed in the Community Applications

search — the template-repository install method above works regardless.

Repo & full docs: https://github.com/Nebur692/ha-pass-invitations

Please report issues either in this thread or on GitHub: https://github.com/Nebur692/ha-pass-invitations/issues

Disclaimer: not affiliated with, endorsed by, or associated with Home Assistant or Nabu Casa Inc.

---

## Español

Fork de [Rohithkadaveru/ha-pass](https://github.com/Rohithkadaveru/ha-pass), una herramienta con

licencia MIT para Home Assistant que crea enlaces de invitado compartibles y con caducidad, para

controlar entidades concretas (luces, cerraduras, termostatos, ventiladores...). Los invitados usan

una PWA pensada para móvil, sin cuenta de HA ni instalar ninguna app. Todo el crédito del diseño

original es del autor original.

Este fork añade **programación por adelantado/recurrente** y funciones relacionadas, pensadas para

sustituir lo que suele ofrecer la función de "invitación de invitados" de un telefonillo

inteligente, manteniéndolo autoalojado y auditable.

**Novedades de este fork:**

- **Programación por adelantado** — un enlace que solo se activa en una fecha/hora futura.

- **Ventanas semanales recurrentes** — restringir un token a días concretos + franja horaria.

- **Envío automático** por cualquier servicio notify.* de HA, con antelación configurable.

- **Soporte de dominio buttoninput_button** (p.ej. helpers de relé de puerta/portón).

- **Sugerencias de entidades opcionales** para modos de invitación Accesos/Luces.

- **Ejecución de comandos restringida a la red local** para dominios de acceso (comprueba IP de

origen; limitación honesta, no es por GPS).

- **Vinculación del enlace a un solo dispositivo** — el primero que lo abre lo reclama.

- **Enlaces de un solo uso**, además de la opción ya existente "No caduca nunca".

- **Interfaz bilingüe EN/ES** — tanto el panel de administración como la PWA de invitado.

Nada de esto toca el modelo de seguridad original — la misma lista blanca, rate limiting y lista

blanca de IP del original siguen aplicando.

**Instalación:**

- Complemento de Home Assistant: añade el repositorio https://github.com/Nebur692/ha-pass-invitations

en Ajustes → Complementos → Tienda de complementos → ⋮ → Repositorios.

- Unraid (contenedor independiente, para instalaciones de HA Core sin Supervisor): Docker → Add

Container → Template repositories → añade

https://raw.githubusercontent.com/Nebur692/ha-pass-invitations/main/ha-pass-invitations.xml

- Docker Compose: ver el README del repo.

Requiere un token de acceso de larga duración de Home Assistant. Todavía no aparece en el buscador

de Community Applications — el método de repositorio de plantillas de arriba funciona igualmente.

Repo y documentación completa: https://github.com/Nebur692/ha-pass-invitations

Reporta problemas aquí o en GitHub: https://github.com/Nebur692/ha-pass-invitations/issues

Aviso: no afiliado, respaldado ni asociado con Home Assistant ni Nabu Casa Inc.