# aku_ha_showtime

**Repository Path**: pickcode/aku_ha_showtime

## Basic Information

- **Project Name**: aku_ha_showtime
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-23
- **Last Updated**: 2025-11-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Aku HA Showtime - 语音助手状态显示教程

本项目旨在将 Home Assistant (HA) 中的语音助手卫星 (assist_satellite) 的状态（如 `idle`, `listening`, `processing`, `responding`, `unavailable`）实时显示在外部设备（如 Akubox 智能音箱）的屏幕上。

本教程包含两个主要部分：

1.  **在显示设备上安装**: 使用一键安装脚本在您的 Akubox 或类似 Linux 设备上部署 `showtime` 显示程序及其依赖。
2.  **在 Home Assistant 中配置**: 导入并使用蓝图 (Blueprint) 来自动将语音助手的状态发布到 MQTT。

---

## 1. 在显示设备上安装 (Akubox)

此步骤将使用 `install.sh` 脚本自动完成以下任务：
* 检查并尝试安装必要的运行时库 (如 `libpng`, `libfreetype`, `libmosquitto`, `git` 等)。
* 从 Gitee 克隆本仓库。
* 引导您交互式地配置连接 MQTT Broker 所需的信息 (地址、端口、用户名、密码)，并将配置写入 `config.ini`。
* 将 `showtime` 可执行文件、配置文件、字体、状态图片等复制到 `/opt/aku/showtime` 目录。
* 将中文字体复制到 `/opt/aku/xiaozhi/font` 目录。
* 将 `showtime.service` systemd 服务文件复制到 `/etc/systemd/system/`。
* 启用并启动 `showtime` 服务，使其开机自启。

**前提条件:**
* 目标设备 (Akubox) 是基于 Debian/Ubuntu 的 Linux 系统。
* 设备已连接网络，可以访问 Gitee 和您的 MQTT Broker。
* 您拥有设备的 `root` 权限。

**安装步骤:**

1.  通过 SSH 连接到您的 Akubox 设备。
2.  执行以下**任一**命令（推荐使用 `curl`）：

    * **使用 `curl`:**
        ```bash
        curl -fsSL https://gitee.com/pickcode/aku_ha_showtime/raw/master/install.sh | sudo bash
        ```
    * **使用 `wget`:**
        ```bash
        wget -O - https://gitee.com/pickcode/aku_ha_showtime/raw/master/install.sh | sudo bash
        ```

3.  脚本启动后会显示一个菜单：
    * **首次安装**: 输入 `1` 或直接按 **回车键**。
    * **仅重新配置 MQTT**: 如果您之前已安装过，只想修改 MQTT 连接信息，可以输入 `2`。

4.  如果选择 `1` 或首次运行，脚本会：
    * 检查并尝试安装依赖库。
    * 提示您输入 MQTT 主机地址、端口、用户名和密码（密码输入时不会显示）。请根据您的 MQTT Broker 信息填写。MQTT 主题已固定为 `akubox/display/state`，无需配置。
    * 自动完成文件的下载、复制和服务的设置。

5.  安装完成后，脚本会尝试启动 `showtime` 服务并显示其状态。

**检查服务状态:**
* 查看服务是否正在运行: `sudo systemctl status showtime.service`
* 查看实时日志: `sudo journalctl -u showtime.service -f`

---

## 2. 在 Home Assistant 中配置 (导入蓝图)

此步骤将在 Home Assistant 中设置一个自动化，该自动化会在 `assist_satellite.aku_assist_satellite` 实体状态改变时，或 HA 启动时，将该实体的**当前状态**（如 `idle`, `listening` 等）发布到 MQTT 主题 `akubox/display/state`。

**前提条件:**
* 您的 Home Assistant 已正确配置并连接到 MQTT Broker。
* 您已在 HA 中设置好 `assist_satellite.aku_assist_satellite` 实体。

**配置步骤:**

1.  **导入蓝图**:
    * 在 Home Assistant 界面，导航到 **设置** > **自动化与场景**。
    * 选择 **蓝图** 选项卡。
    * 点击右下角的 **导入蓝图** 按钮。
    * 在 **蓝图的 URL** 字段中，粘贴以下 Gitee 文件的链接:
        ```
        https://gitee.com/pickcode/aku_ha_showtime/raw/master/%E5%90%8C%E6%AD%A5%E8%AF%AD%E9%9F%B3%E5%8A%A9%E6%89%8B%E7%8A%B6%E6%80%81%E8%87%B3%20MQTT.yaml
        ```
    * 点击 **预览蓝图**。
    * 确认蓝图名称为 “同步语音助手状态至 MQTT”，然后点击 **导入蓝图**。

2.  **基于蓝图创建自动化**:
    * 导入成功后，您会在蓝图列表中看到 “同步语音助手状态至 MQTT”。
    * 点击该蓝图旁边的 **创建自动化**。
    * 在 **语音助手实体** (Voice Satellite Entity) 下拉菜单中，选择您的 `assist_satellite.aku_assist_satellite` 实体。
    * **MQTT 服务质量 (QoS)** 和 **MQTT 保留标志 (Retain)** 通常保持默认值 (`1` 和 `启用`) 即可。
    * 点击 **保存**，为自动化命名（例如 "Akubox Display Sync"）。

---

## 完成

现在，您的 Akubox 设备上的 `showtime` 程序应该会通过 MQTT 接收来自 Home Assistant 的状态更新，并相应地改变屏幕显示了。您可以尝试与您的语音助手交互，观察屏幕状态的变化。

## 感谢

修改自梁总群的笨笨的蘑菇大佬分享的showtime.c