sibbl/hass-lovelace-kindle-screensaver

Home Assistant Lovelace to Kindle Renderer 镜像文档

镜像概述与主要用途

本Docker镜像用于将Home Assistant的Lovelace界面视图转换为灰度PNG图片，核心功能是适配Kindle设备的显示需求。通过将智能家居控制面板（Lovelace视图）渲染为灰度图像，用户可在Kindle设备上便捷查看Home Assistant状态，实现低成本、低功耗的智能家居信息展示方案。

核心功能与特性

• Lovelace视图渲染：支持解析并渲染Home Assistant的Lovelace界面视图，保留原布局结构
• 灰度图像转换：自动将彩色界面转换为灰度图像，适配Kindle设备的电子墨水屏显示特性
• PNG格式输出：生成标准PNG图像文件，兼容Kindle设备的图片浏览功能
• 轻量级运行：基于精简基础镜像构建，资源占用低，适合长期后台运行

使用场景与适用范围

适用场景

• Home Assistant用户希望在Kindle设备上展示智能家居控制面板
• 需要在家庭固定位置（如客厅、卧室）部署低功耗的智能家居状态显示终端
• 利用闲置Kindle设备作为Home Assistant的辅助信息屏

适用范围

• 已部署Home Assistant的用户（支持Lovelace界面的版本）
• 拥有支持PNG图片显示的Kindle设备（如Kindle Paperwhite、Kindle Oasis等）
• 具备基础Docker环境的设备（如树莓派、NAS、家庭服务器等）

使用方法与配置说明

前置条件

1. 已安装Docker环境
2. Home Assistant实例可通过网络访问，且已启用Lovelace界面
3. 已获取Home Assistant的长期访问令牌（Long-Lived Access Token）
4. 已知目标Lovelace视图的ID或路径

Docker部署示例

基础运行命令

bash
docker run -d \
  --name hass-kindle-renderer \
  -e HOME_ASSISTANT_URL="http://your-home-assistant-ip:8123" \
  -e HASS_TOKEN="your-long-lived-access-token" \
  -e LOVELACE_VIEW="0" \
  -v /host/path/to/output:/app/output \
  [镜像名称]:latest

Docker Compose配置示例

yaml
version: '3'
services:
  hass-kindle-renderer:
    image: [镜像名称]:latest
    container_name: hass-kindle-renderer
    environment:
      - HOME_ASSISTANT_URL=http://your-home-assistant-ip:8123
      - HASS_TOKEN=your-long-lived-access-token
      - LOVELACE_VIEW=0
      - IMAGE_WIDTH=600
      - IMAGE_HEIGHT=800
      - RENDER_INTERVAL=300  # 渲染间隔（秒）
    volumes:
      - /host/path/to/output:/app/output
    restart: unless-stopped

配置参数说明

操作步骤

1. 获取Home Assistant访问令牌：

   • 登录Home Assistant管理界面
   • 进入「用户」→「个人资料」→「长期访问令牌」→「创建令牌」
   • 保存生成的令牌字符串（仅显示一次）

2. 确定Lovelace视图ID：

   • 在Home Assistant中打开Lovelace界面
   • 进入编辑模式，查看目标视图的URL路径（如/lovelace/0中的0即为视图ID）

3. 运行Docker容器：

   • 使用上述docker run命令或docker-compose配置启动容器
   • 检查输出目录，确认生成PNG文件（默认文件名：lovelace-kindle.png）

4. 传输图像到Kindle：

   • 通过Kindle的「发送至Kindle」***功能推送PNG文件
   • 或通过USB连接将文件传输至Kindle的documents目录

注意事项

• 确保Home Assistant与Docker容器之间网络通畅，可通过curl测试访问性
• Kindle设备需开启图片浏览功能（部分旧型号可能不支持PNG透明通道）
• 建议设置合理的RENDER_INTERVAL，避免频繁渲染导致资源占用过高
• 若Lovelace视图包含动态内容（如实时传感器数据），需通过定时渲染更新图像内容