signalk-mareas-ihm 2.1.5 → 2.1.7

package/README.md

@@ -1,108 +1,129 @@
 # signalk-mareas-ihm
 
-🇪🇸 [Español](#español) · 🇬🇧 [English](#english)
+**A complete anchor watch and marine safety webapp for Signal K.**
+Voice alarms, shelter forecasting, on-board wave measurement, multi-source charts and official Spanish IHM tide predictions — running on your OpenPlotter / Raspberry Pi.
 
----
-
-## Español
+🇬🇧 [English](#english) · 🇪🇸 [Español](#espanol)
 
-Plugin de Signal K que convierte tu OpenPlotter / Raspberry Pi en un **visor completo de fondeo**: mareas oficiales del **IHM (Instituto Hidrográfico de la Marina)**, previsión de abrigo, medición de olas a bordo, alarmas inteligentes y soporte para domótica.
+---
 
-### Características principales
+## English
 
-#### Mareas
-- **Predicción de mareas** automática por GPS o selección manual entre 70 estaciones del IHM.
-- **Curvas de marea interactivas** con HAT/LAT anuales, cursor y etiquetas de pleamar/bajamar.
-- **Coeficientes oficiales IHM** con descarga automática.
-- **Caché offline** de al menos 2 meses de predicciones.
-- **Tendencia y coeficiente** visibles en la barra superior del visor.
+### What you get
+
+A single Signal K plugin that turns your boat computer into a serious **anchor watch** with everything a cruiser actually needs:
+
+- 🗺️ **Marine charts** — customizable transparencies and multilayer viewer with highly detailed worldwide **Bathymetry** + **Esri Satellite** + **IHM ENC S-52** + **MBTiles charts for offline use** + **OpenStreetMap** + **OpenSeaMap** + **SK Charts plugin integration**
+- ⚓ **Smart anchor watch** with predictive swing radius based on tide and weather
+- 🌐 **Real-time multi-device sync** via SSE — phone, tablet and chartplotter all show the same state
+- 🚢 **AIS anchoring potential collision watch** — drag detection on neighbouring boats with voice alarm and per-target ACK
+- 🎙️ **Voice alarms** for anchor drag, AIS collision and grounding (in your language, not synth voices)
+- 🏔️ **Shelter forecast** — when anchoring, auto-detection of which sectors are open vs sheltered depending on the current conditions and a 12 h hour-by-hour forecast
+- 🌅 **Tide predictions** — official IHM Spain for >70 stations, FES2014 global fallback for anywhere else; open to suggestions for other countries' free official or just reliable tide APIs
+- 🌊 **On-board wave measurement** from your IMU (no extra sensor needed)
+- 📊 **Sounder calculator** — chain, scope, depth, swing prediction
+- 🌤️ **Weather forecast** with Open-Meteo (multiple models, sea temperature, wave height & period)
+- 🌀 **Windy integration**: access to Windy map and forecast directly from your viewer
+- ⛵ **Windregatta.com integration**: a new and promising cutting-edge free sailing route planner — a great discovery!
+- 🚀 **Shortcuts to KIP and SK Freeboard** directly from your viewer
+- 🇬🇧 🇪🇸 **Fully bilingual UI** (English / Spanish) — switch from the menu
+
+Runs on **Raspberry Pi** (OpenPlotter), **any Linux box** or **macOS / Windows** with Signal K Server.
+
+### ⭐ Why this plugin
+
+Most anchor watch apps are paid, closed source, single-device and tied to a vendor's hardware. This one:
+
+- Is **free and open source** (Apache 2.0).
+- Runs **on your existing Signal K server** — no extra hardware.
+- Shows the **same alarm on every device** (phone, tablet, chartplotter, Pi screen).
+- Uses your **boat's real sensors** (anemometer, depth, IMU) when available; falls back to forecast when not.
+- Has **mobile-first UI** that works on phone screens, big monitors and the Pi browser.
+- Handles **edge cases** real cruisers hit: AudioContext suspended after backgrounding, browser autoplay blocks, multiple AIS targets in zone, snooze + un-snooze, etc.
+
+### Key features in detail
+
+#### Anchor watch
+- **Predictive swing radius**: combines depth, chain deployed and tide cycle to predict the actual swing area over the next 12 h — not just a static circle.
+- **Two chain calculation methods**: classic ratio and the Vicente method (15 + 2 × depth).
+- **Drag detection** with audible siren that bypasses user mute for safety.
+- **GPS track** with time-gradient colouring so you can see exactly where the boat has been.
+- **Favourite anchorages** saved with a custom name (or auto-named from geolocation).
+
+#### AIS collision watch
+- **Voice alarm** when an AIS target enters your swing zone.
+- **30 s grace window** before voice starts — see the modal first, hit ACK if it's a false positive.
+- **Per-target ACK** with timestamp, so silencing one boat doesn't disable the alarm for others.
+- **Drag detection on neighbours** — if an ACKed boat starts approaching >5 m/min, the alarm re-engages.
+- **Anchor estimation** for other boats via track centroid analysis.
+
+#### Shelter forecasting
+- **16-sector wind rose** with automatic open/sheltered detection from OpenStreetMap coastline.
+- **A–F grade** + **0–100 % protection score** computed from forecast wind in exposed sectors.
+- **12 h strip** with per-hour grade and peak wind.
+- **24 h wave history** from on-board IMU (acceleration RMS by intensity band).
+- **Real-time degrade**: if measured wind on the anemometer is higher than the forecast in an exposed sector, the grade is downgraded automatically.
 
-#### Previsión de abrigo
-- **Rosa de 16 sectores** con detección automática del abrigo según la costa (OpenStreetMap).
-- **Grado A-F y porcentaje de protección** combinando viento y olas previstos.
-- **Strip de exposición** próximas 12 h con previsión hora a hora.
-- **Resumen "AHORA / PREDICCIÓN"** con datos en tiempo real de sensores y previsión.
-- **Edición manual** de sectores cuando el detector automático no convence.
-
-#### Medición de olas en fondeo
-- **Dirección, período y altura** de ola calculados a bordo desde sensores de actitud y aceleración (pypilot IMU u otros compatibles).
-- **Historial de las últimas 24 h** en barras de 15 minutos.
-- **El grado de abrigo se ajusta automáticamente** cuando la ola medida supera la prevista.
-
-#### Visor de fondeo
-- **Mapa Leaflet** con posición GPS en tiempo real y capas múltiples (ESRI, Bing, Google, IHM S-52, Batimetría, MBTiles offline).
-- **Anchor Watch** con alarma de garreo visual y sonora.
-- **Cadena largada** con slider bidireccional y cálculo automático (métodos tradicional y Vicente).
-- **Radio de borneo y alarma** con etiquetas en la carta y predicción según marea.
-- **Sincronización multi-dispositivo** en tiempo real (SSE).
-- **Cartas náuticas locales** vía servidor MBTiles integrado.
-
-#### Sensores en tiempo real
-- Lectura directa de **viento (veleta)**, **temperatura aire/agua** y **presión atmosférica** de Signal K.
-- Etiquetas **"Veleta"** y **"Sensor"** distinguen datos reales de previsión.
-- **Fallback automático a Open-Meteo** cuando un sensor falla.
-- **Sonda inteligente**: detecta congelación / spikes / valores absurdos y deja de mostrar lecturas inventadas.
-
-#### AIS inteligente
-- **Detección de colisión** con targets AIS en zona de borneo.
-- **ACK por target individual** — silencia alarma de un barco sin desactivar la alarma general.
-- **Detección de garreo ajeno** — si un target ACKed se acerca >2 m/min, la alarma se reactiva.
-- **Estimación de ancla** de otros barcos mediante análisis de track (centroide + radio máximo).
-
-#### Alarmas y audio
-- **Alarmas independientes**: garreo, varada, AIS y sonda con control individual.
-- **Voces pregrabadas (OGG)** por idioma — más naturales que el sintetizador.
-- **Detección automática** de la salida de audio del Raspberry Pi (USB → analog → HDMI).
-- **Soporte móvil** fiable (audio funciona incluso con la pestaña en segundo plano).
-- **Patrones distintos** por evento ("tuc tuc tuc" para AIS, sirena para garreo, etc.).
-
-#### Domótica / KIP
-- **Botones KIP** para fondear/levar y activar/desactivar alarmas.
-- **Endpoints REST** para Alexa, Google Home, Node-RED, MQTT.
-- **Endpoint toggle** para mandos a distancia con un solo botón.
-
-#### Bilingüe completo
-- Interfaz en **español e inglés** en todas las vistas.
-- Compass cardinal en español correcto (N/NE/E/SE/S/SO/O/NO).
-- Banderas de idioma en la barra inferior del visor.
+#### Tides
+- **Official IHM Spain predictions** for >70 stations with annual HAT/LAT and constituent coefficients.
+- **Worldwide fallback** via Open-Meteo / FES2014 (USA, UK, Australia, Japan, etc.).
+- **Interactive tide curve** with cursor, peaks and 2-month offline cache.
+- **No API key required** for any tide source.
+
+#### Weather forecast
+- **Open-Meteo** integrated (free, no API key, no rate limit issues).
+- **Multiple models**: ICON (DWD), GFS (NOAA), ECMWF, Météo-France Arome, GEM, JMA.
+- **Sea temperature, wave height, period and direction** when available.
+- **48 h hourly table** + collapsible plain-language summary.
+
+#### Audio & alarms
+- **Per-language voice clips (OGG)** — natural, no robotic synth.
+- **Snooze 5 min** for AIS (anchor drag is never snoozable for safety).
+- **60 s user-mute window** — if you mute manually, even garreo cannot override for 60 s.
+- **Visibility-aware**: when phone screen wakes from sleep, AudioContext is resumed automatically.
+- **Vibration fallback** on Android when autoplay policy blocks audio.
+
+#### Charts & layers
+- **Esri Satellite**, **IHM ENC S-52** (Spain official charts), **Bathymetry overlay**, **OpenStreetMap**, **OpenSeaMap** seamarks, **Bing Hybrid**, **Esri Clarity**, **Google Satellite**.
+- **MBTiles offline** — drop your `.mbtiles` files in a folder and they show up automatically.
+- **Signal K registered charts** — any chart you've registered with Signal K appears as a layer.
+- **Per-layer opacity slider** with default values you can tweak.
+
+#### Home Automation / KIP / Freeboard
+- **KIP buttons** for drop/lift and toggle alarms — open Freeboard-SK with one tap from the side bar.
+- **REST endpoints** for Alexa, Google Home, Node-RED, MQTT bridges, custom dashboards.
+- **`/toggle` endpoint** for single-button remote controls.
 
 ### URLs
 
-| URL | Función |
-|-----|---------|
-| `/signalk-mareas-ihm/` | Landing — selector Mareas / Visor de Fondeo |
-| `/signalk-mareas-ihm/mareas` | Vista de Mareas (directo) |
-| `/signalk-mareas-ihm/visorfondeo` | Visor de Fondeo (directo) |
+| URL | What it does |
+|-----|----------|
+| `/signalk-mareas-ihm/` | Landing — choose Tides or Anchor Watch |
+| `/signalk-mareas-ihm/mareas` | Tides view (direct) |
+| `/signalk-mareas-ihm/visorfondeo` | Anchor Watch viewer (direct) |
+| `/signalk-mareas-ihm/mobile` | Mobile-first viewer (recommended on phones) |
 
-### Domótica — Endpoints REST
+### Home Automation — REST endpoints
 
 ```bash
-# Fondear/Levar con un solo botón
+# One-button drop or lift (auto detects current anchor state)
 curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/toggle
 
-# Fondear en posición GPS actual
+# Drop anchor at current GPS
 curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/drop
 
-# Levar ancla
+# Lift anchor
 curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/lift
 
-# Estado simple (para monitorización)
+# Simple JSON status (for monitoring / dashboards)
 curl http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/simple
 ```
 
-### KIP — Paths para Boolean Control
+### Quick install
 
-| Path | Función |
-|------|---------|
-| `environment.anchor.mareasIhm.anchorCommand` | Fondear (true) / Levar (false) |
-| `environment.anchor.mareasIhm.garreoAlarmCommand` | Alarma garreo ON/OFF |
-| `environment.anchor.mareasIhm.aisAlarmCommand` | Alarma AIS ON/OFF |
+From the **Signal K Appstore**: search `signalk-mareas-ihm` and click install.
 
-### Instalación
-
-Desde el **Signal K Appstore**: buscar `signalk-mareas-ihm` e instalar.
-
-O por línea de comandos:
+Or from the command line:
 
 ```bash
 cd ~/.signalk
@@ -110,99 +131,149 @@ npm install signalk-mareas-ihm@latest --save
 sudo systemctl restart signalk
 ```
 
+Then open: `http://your-pi.local:3000/signalk-mareas-ihm/`
+
+### Tested on
+
+- Raspberry Pi 4 (OpenPlotter V4) — primary target.
+- Linux x64, macOS, Windows 11.
+- Firefox, Chrome, Safari on iOS / Android.
+
+### Disclaimer
+
+This is a navigation aid, **not** a replacement for proper anchor watch with eyes on the boat. The author takes no responsibility for dragging, collision, grounding or any other incident. Use at your own risk.
+
+### Contributing & support
+
+Issues, PRs and feature requests welcome at the [GitHub repo](https://github.com/Aitonos/signalk-mareas-ihm).
+
+### License
+
+Apache 2.0. Derived from `signalk-tides` (Brandon Keepers, Joachim Bakke, Scott Bender and contributors).
+
 ---
 
-## English
+<a id="espanol"></a>
 
-Signal K plugin that turns your OpenPlotter / Raspberry Pi into a **complete anchor watch viewer**: official Spanish tides from **IHM (Instituto Hidrográfico de la Marina)**, shelter forecast, on-board wave measurement, smart alarms and home automation support.
+## Español
 
-### Main Features
+Plugin de Signal K que convierte tu OpenPlotter / Raspberry Pi en una **webapp completa de anchor watch y seguridad marina**: alarmas de voz, previsión de abrigo, medición de olas a bordo, cartas náuticas multi-fuente y mareas oficiales del IHM (Instituto Hidrográfico de la Marina) de España.
 
-#### Tides
-- **Automatic tide prediction** by GPS or manual selection among 70 IHM stations.
-- **Interactive tide curves** with annual HAT/LAT, cursor and high/low tide labels.
-- **Official IHM coefficients** with automatic download.
-- **Offline cache** of at least 2 months of predictions.
-- **Tendency and coefficient** visible in the viewer's top bar.
-
-#### Shelter forecast
-- **16-sector rose** with automatic shelter detection from coastline (OpenStreetMap).
-- **Grade A-F and protection percentage** combining forecast wind and waves.
-- **12 h exposure strip** with hourly forecast.
-- **"NOW / FORECAST" summary** with real-time sensor and forecast data.
-- **Manual sector override** when the automatic detector is wrong.
-
-#### On-board wave measurement
-- **Direction, period and height** of waves computed on board from attitude and acceleration sensors (pypilot IMU or compatible).
-- **24 h history** in 15-minute bars.
-- **Shelter grade auto-adjusts** when measured wave exceeds forecast.
-
-#### Anchor watch viewer
-- **Leaflet map** with real-time GPS position and multiple layers (ESRI, Bing, Google, IHM S-52, Bathymetry, offline MBTiles).
-- **Anchor Watch** with visual and audible drag alarm.
-- **Chain deployed** with bidirectional slider and automatic calculation (traditional and Vicente methods).
-- **Swing and alarm radius** with chart labels and tide-aware prediction.
-- **Multi-device real-time sync** (SSE).
-- **Local nautical charts** via integrated MBTiles server.
-
-#### Real-time sensors
-- Direct reading of **wind (anemometer)**, **air/water temperature** and **atmospheric pressure** from Signal K.
-- **"Veleta"** and **"Sensor"** badges distinguish real data from forecast.
-- **Automatic Open-Meteo fallback** when a sensor drops.
-- **Smart depth sounder**: detects frozen / spike / absurd values and stops showing made-up readings.
-
-#### Smart AIS
-- **Collision detection** with AIS targets in swing zone.
-- **Per-target ACK** — silence alarm for one boat without disabling the general alarm.
-- **External dragging detection** — if an ACKed target approaches >2 m/min, alarm reactivates.
-- **Anchor estimation** for other boats via track analysis (centroid + max radius).
-
-#### Alarms and audio
-- **Independent alarms**: drag, grounding, AIS and depth with individual control.
-- **Pre-recorded voices (OGG)** per language — more natural than synthesizer.
-- **Automatic detection** of Raspberry Pi audio output (USB → analog → HDMI).
-- **Reliable mobile support** (audio works even when the tab is in background).
-- **Distinct patterns** per event (rapid beep for AIS, siren for drag, etc.).
-
-#### Home Automation / KIP
-- **KIP buttons** for drop/lift and alarm enable/disable.
-- **REST endpoints** for Alexa, Google Home, Node-RED, MQTT.
-- **Toggle endpoint** for single-button remote controls.
-
-#### Full Bilingual
-- Interface in **Spanish and English** across all views.
-- Correct Spanish cardinal compass (N/NE/E/SE/S/SO/O/NO).
-- Language flags in the viewer's bottom bar.
+### Qué te llevas
+
+Un único plugin de Signal K que convierte el ordenador del barco en un **anchor watch serio** con todo lo que un navegante de verdad necesita:
+
+- 🗺️ **Cartas náuticas** — transparencias configurables y visor multicapa con **Batimetría mundial de alto detalle** + **Satélite Esri** + **IHM ENC S-52** + **MBTiles para uso offline** + **OpenStreetMap** + **OpenSeaMap** + **integración con plugin SK Charts**
+- ⚓ **Anchor watch inteligente** con radio de borneo predictivo según marea y meteo
+- 🌐 **Sincronización multi-dispositivo en tiempo real** vía SSE — móvil, tablet y chartplotter muestran el mismo estado
+- 🚢 **Vigilancia de colisión AIS al fondear** — detección de garreo en barcos vecinos con alarma de voz y ACK por target
+- 🎙️ **Alarmas de voz** para garreo, colisión AIS y varada (en tu idioma, no voz sintética)
+- 🏔️ **Previsión de abrigo** — al fondear, autodetección de qué sectores están abiertos vs abrigados según las condiciones actuales y previsión hora a hora durante 12 h
+- 🌅 **Mareas oficiales** — IHM España para >70 estaciones, fallback global FES2014 para el resto del mundo; abierto a sugerencias de otras APIs oficiales gratuitas o fiables
+- 🌊 **Medición de olas a bordo** desde tu IMU (sin sensor extra)
+- 📊 **Calculadora de fondeo** — cadena, scope, sonda, predicción de borneo
+- 🌤️ **Previsión meteo** con Open-Meteo (varios modelos, temperatura del mar, altura y período de ola)
+- 🌀 **Integración Windy**: acceso al mapa y previsión de Windy directamente desde el visor
+- ⛵ **Integración Windregatta.com**: un nuevo y prometedor planificador de rutas a vela libre y muy puntero — ¡un gran descubrimiento!
+- 🚀 **Accesos directos a KIP y SK Freeboard** desde el propio visor
+- 🇬🇧 🇪🇸 **UI bilingüe completa** (Inglés / Español) — cambio desde el menú
+
+Funciona en **Raspberry Pi** (OpenPlotter), **cualquier Linux** o **macOS / Windows** con Signal K Server.
+
+### ⭐ Por qué este plugin
+
+La mayoría de apps de anchor watch son de pago, código cerrado, un solo dispositivo y atadas al hardware del fabricante. Esta:
+
+- Es **libre y open source** (Apache 2.0).
+- Corre en tu **Signal K Server existente** — sin hardware extra.
+- Muestra la **misma alarma en todos los dispositivos** (móvil, tablet, plotter, pantalla del Pi).
+- Usa los **sensores reales del barco** (veleta, sonda, IMU) cuando están; cae a previsión si no.
+- Tiene **UI mobile-first** que funciona en móvil, monitor grande y el navegador del Pi.
+- Maneja los **casos límite** que sufre el navegante real: AudioContext suspendido tras background, bloqueo de autoplay del navegador, múltiples targets AIS en zona, snooze + un-snooze, etc.
+
+### Funcionalidades en detalle
+
+#### Anchor watch
+- **Radio de borneo predictivo**: combina sonda, cadena largada y ciclo de marea para predecir el área real de borneo en las próximas 12 h — no un círculo estático.
+- **Dos métodos de cálculo de cadena**: ratio clásico y método Vicente (15 + 2 × sonda).
+- **Detección de garreo** con sirena audible que bypassa el mute del usuario por seguridad.
+- **Track GPS** con coloreado por gradiente temporal para ver exactamente por dónde ha pasado el barco.
+- **Fondeos favoritos** guardados con nombre personalizado (o auto-nombrados por geolocalización).
+
+#### Vigilancia de colisión AIS
+- **Alarma de voz** cuando un target AIS entra en tu zona de borneo.
+- **30 s de gracia** antes de que arranque la voz — ves el modal primero, ACK si es falso positivo.
+- **ACK por target** con timestamp, así silenciar un barco no desactiva la alarma para otros.
+- **Detección de garreo en vecinos** — si un barco ya ACKeado empieza a acercarse >5 m/min, la alarma se reactiva.
+- **Estimación del ancla** de otros barcos vía análisis de centroide del track.
+
+#### Previsión de abrigo
+- **Rosa de 16 sectores** con detección automática abierto/abrigado desde la línea de costa de OpenStreetMap.
+- **Grado A-F** + **% de protección 0-100** calculado desde el viento previsto en sectores expuestos.
+- **Strip de 12 h** con grado por hora y viento pico.
+- **Historial de olas 24 h** desde el IMU a bordo (RMS de aceleración por banda de intensidad).
+- **Degradación en tiempo real**: si el viento medido por la veleta es mayor que el previsto en un sector expuesto, el grado baja automáticamente.
+
+#### Mareas
+- **Predicciones oficiales IHM España** para >70 estaciones con HAT/LAT anual y coeficientes de constituyentes.
+- **Fallback mundial** vía Open-Meteo / FES2014 (USA, UK, Australia, Japón, etc.).
+- **Curva de marea interactiva** con cursor, picos y caché offline de 2 meses.
+- **Sin API key** para ninguna fuente de mareas.
+
+#### Previsión meteo
+- **Open-Meteo** integrado (gratis, sin API key, sin problemas de rate limit).
+- **Múltiples modelos**: ICON (DWD), GFS (NOAA), ECMWF, Météo-France Arome, GEM, JMA.
+- **Temperatura del mar, altura, período y dirección de ola** cuando están disponibles.
+- **Tabla horaria 48 h** + resumen colapsable en lenguaje claro.
+
+#### Audio y alarmas
+- **Clips de voz por idioma (OGG)** — naturales, no síntesis robótica.
+- **Snooze 5 min** para AIS (garreo nunca es snoozable por seguridad).
+- **Ventana mute-usuario 60 s** — si silencias manualmente, ni el garreo crítico puede reactivar el audio durante 60 s.
+- **Consciente de visibilidad**: cuando la pantalla del móvil despierta, el AudioContext se reanuda automáticamente.
+- **Vibración fallback** en Android cuando la política de autoplay bloquea el audio.
+
+#### Cartas y capas
+- **Satélite Esri**, **IHM ENC S-52** (cartas oficiales España), **Batimetría**, **OpenStreetMap**, **OpenSeaMap** señalización marítima, **Bing Hybrid**, **Esri Clarity**, **Google Satélite**.
+- **MBTiles offline** — pon tus archivos `.mbtiles` en una carpeta y aparecen automáticamente.
+- **Cartas registradas en Signal K** — cualquier carta registrada con Signal K aparece como capa.
+- **Slider de opacidad por capa** con valores por defecto editables.
+
+#### Domótica / KIP / Freeboard
+- **Botones KIP** para echar/levar y conmutar alarmas — abre Freeboard-SK con un toque desde la sidebar.
+- **Endpoints REST** para Alexa, Google Home, Node-RED, puentes MQTT, dashboards a medida.
+- **Endpoint `/toggle`** para mandos remotos de un solo botón.
 
 ### URLs
 
-| URL | Function |
-|-----|----------|
-| `/signalk-mareas-ihm/` | Landing — Tides / Anchor Watch selector |
-| `/signalk-mareas-ihm/mareas` | Tides view (direct) |
-| `/signalk-mareas-ihm/visorfondeo` | Anchor Watch Viewer (direct) |
+| URL | Función |
+|-----|---------|
+| `/signalk-mareas-ihm/` | Landing — Mareas o Anchor Watch |
+| `/signalk-mareas-ihm/mareas` | Vista mareas (directo) |
+| `/signalk-mareas-ihm/visorfondeo` | Anchor Watch viewer (directo) |
+| `/signalk-mareas-ihm/mobile` | Vista mobile-first (recomendada en móviles) |
 
-### Home Automation — REST Endpoints
+### Domótica — endpoints REST
 
 ```bash
-# Drop/Lift with single button
+# Echar o levar con un botón (auto-detecta el estado actual)
 curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/toggle
 
-# Drop anchor at current GPS
+# Echar ancla en GPS actual
 curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/drop
 
-# Lift anchor
+# Levar ancla
 curl -X POST http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/lift
 
-# Simple status (for monitoring)
+# Estado JSON simple (para monitorización / dashboards)
 curl http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/simple
 ```
 
-### Installation
+### Instalación rápida
 
-From the **Signal K Appstore**: search `signalk-mareas-ihm` and install.
+Desde el **Appstore de Signal K**: busca `signalk-mareas-ihm` y pulsa instalar.
 
-Or via command line:
+O desde la línea de comandos:
 
 ```bash
 cd ~/.signalk
@@ -210,6 +281,22 @@ npm install signalk-mareas-ihm@latest --save
 sudo systemctl restart signalk
 ```
 
----
+Después abre: `http://tu-pi.local:3000/signalk-mareas-ihm/`
+
+### Probado en
+
+- Raspberry Pi 4 (OpenPlotter V4) — objetivo principal.
+- Linux x64, macOS, Windows 11.
+- Firefox, Chrome, Safari en iOS / Android.
+
+### Aviso legal
+
+Es una **ayuda a la navegación**, NO un sustituto del anchor watch con vigilancia humana. El autor no se responsabiliza de garreos, colisiones, varadas ni ningún otro incidente. Uso bajo tu propia responsabilidad.
+
+### Contribuir y soporte
+
+Issues, PRs y peticiones de funcionalidad en el [repo de GitHub](https://github.com/Aitonos/signalk-mareas-ihm).
+
+### Licencia
 
-© IHM — Official data from Spain's Instituto Hidrográfico de la Marina
+Apache 2.0. Derivado de `signalk-tides` (Brandon Keepers, Joachim Bakke, Scott Bender y contribuidores).