Add HA addon

Author: strange-v

hassio/remote_webview_server/Dockerfile

@@ -0,0 +1,15 @@
+ARG SERVER_IMAGE=docker.io/strangev/remote-webview-server:latest
+FROM ${SERVER_IMAGE}
+
+USER root
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends jq socat ca-certificates curl \
+ && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+COPY run.sh /run.sh
+RUN chmod +x /run.sh
+
+EXPOSE 8081 18080 9221
+
+CMD ["/run.sh"]

hassio/remote_webview_server/config.yaml

@@ -0,0 +1,58 @@
+name: "Remote WebView Server"
+version: "1.0.0"
+slug: "remote_webview_server"
+description: "Streams your HA dashboard or any website to ESP32-based displays as tiles via WebSocket."
+url: "https://github.com/strange-v/RemoteWebViewServer/tree/main/hassio/remote_webview_server"
+arch:
+  - amd64
+  - aarch64
+startup: application
+boot: auto
+
+host_network: true
+
+video: true
+udev: true
+init: false
+
+watchdog: "http://[HOST]:[PORT:18080]/"
+
+map:
+  - type: addon_config
+    read_only: false
+
+options:
+  screen_w: 480
+  screen_h: 480
+  tile_size: 32
+  full_frame_tile_count: 4
+  full_frame_area_threshold: 0.5
+  full_frame_every: 50
+  every_nth_frame: 1
+  min_frame_interval_ms: 80
+  jpeg_quality: 85
+  max_bytes_per_message: 61440
+  ws_port: 8081
+  debug_port: 9221
+  expose_debug_proxy: false
+  debug_proxy_port: 9222
+  health_port: 18080
+  user_data_dir: "/pw-data"
+
+schema:
+  screen_w: int
+  screen_h: int
+  tile_size: int
+  full_frame_tile_count: int
+  full_frame_area_threshold: float
+  full_frame_every: int
+  every_nth_frame: int
+  min_frame_interval_ms: int
+  jpeg_quality: int
+  max_bytes_per_message: int
+  ws_port: int
+  debug_port: int
+  expose_debug_proxy: bool
+  debug_proxy_port: int
+  health_port: int
+  user_data_dir: str

hassio/remote_webview_server/run.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OPTIONS_FILE="/data/options.json"
+
+get_opt() {
+  local key="$1" default="$2"
+  if [ -f "$OPTIONS_FILE" ]; then
+    jq -r --arg k "$key" --arg d "$default" '.[$k] // $d' "$OPTIONS_FILE"
+  else
+    echo "$default"
+  fi
+}
+
+export SCREEN_W="$(get_opt screen_w 480)"
+export SCREEN_H="$(get_opt screen_h 480)"
+export TILE_SIZE="$(get_opt tile_size 32)"
+export FULL_FRAME_TILE_COUNT="$(get_opt full_frame_tile_count 4)"
+export FULL_FRAME_AREA_THRESHOLD="$(get_opt full_frame_area_threshold 0.5)"
+export FULL_FRAME_EVERY="$(get_opt full_frame_every 50)"
+export EVERY_NTH_FRAME="$(get_opt every_nth_frame 1)"
+export MIN_FRAME_INTERVAL_MS="$(get_opt min_frame_interval_ms 80)"
+export JPEG_QUALITY="$(get_opt jpeg_quality 85)"
+export MAX_BYTES_PER_MESSAGE="$(get_opt max_bytes_per_message 14336)"
+export WS_PORT="$(get_opt ws_port 8081)"
+export DEBUG_PORT="$(get_opt debug_port 9221)"
+export HEALTH_PORT="$(get_opt health_port 18080)"
+
+USER_DATA_DIR_OPT="$(get_opt user_data_dir "/pw-data")"
+if [ "$USER_DATA_DIR_OPT" = "/pw-data" ]; then
+  mkdir -p /data/pw-data
+  # if not already a symlink, make /pw-data -> /data/pw-data
+  if [ ! -L /pw-data ]; then
+    rm -rf /pw-data 2>/dev/null || true
+    ln -s /data/pw-data /pw-data
+  fi
+  export USER_DATA_DIR="/pw-data"
+else
+  mkdir -p "$USER_DATA_DIR_OPT"
+  export USER_DATA_DIR="$USER_DATA_DIR_OPT"
+fi
+
+EXPOSE_DEBUG_PROXY="$(get_opt expose_debug_proxy false)"
+if [ "$EXPOSE_DEBUG_PROXY" = "true" ]; then
+  DEBUG_PROXY_PORT="$(get_opt debug_proxy_port 9222)"
+  echo "[remote-webview] Starting debug proxy on :${DEBUG_PROXY_PORT} -> 127.0.0.1:${DEBUG_PORT}"
+  socat -d -d "TCP-LISTEN:${DEBUG_PROXY_PORT},fork,reuseaddr,keepalive" "TCP:127.0.0.1:${DEBUG_PORT}" &
+fi
+
+command -v node >/dev/null
+test -f dist/index.js
+
+exec node dist/index.js

repository.yaml

@@ -0,0 +1,3 @@
+name: Remote WebView Add-ons
+url: https://github.com/strange-v/RemoteWebViewServer
+maintainer: strange_v