使用MPRIS从您的桌面控制Home Assistant媒体播放器！

什么？

本项目连接您的Home Assistant实例和桌面，以控制Home Assistant实例所知的媒体播放器。

它通过使用Home Assistant的WebSocket API与其通信，并通过广泛实现的MPRIS（"媒体播放器远程接口规范"）接口将媒体播放器暴露给桌面。

功能

• 显示当前播放的信息（艺术家、专辑、标题、封面艺术）
• 基本的播放控制（播放、暂停、上一曲、下一曲）
• 音量控制
• 快进/快退
• 配置简单，自动检测播放器！

tl;dr

我现在就需要，但怎么办？!

1. 从PyPI安装，最简单的方法是使用pipx。或者，简单克隆此仓库并运行poetry install

pipx install homeassistant-mpris-bridge

2. 启动hassbridge

hassbridge --endpoint http://192.168.123.123:8123 --token <long lived token>

除了使用--endpoint和--token，您还可以定义以下环境变量以实现相同的目的

export HASSBRIDGE_ENDPOINT="http://192.168.123.123:8123"
export HASSBRIDGE_TOKEN="<long lived token>"

作为systemd服务运行

要确保桥接器与您的桌面会话一起启动，最简单的方法是为它创建一个systemd用户服务

1. 创建一个服务文件 ~/.config/systemd/user/hassbridge.service，内容如下

[Unit]
Description=hassbridge

[Service]
ExecStart=<PATH TO HASSBRIDGE>
Environment="HASSBRIDGE_TOKEN=<YOUR TOKEN>"
Environment="HASSBRIDGE_ENDPOINT=<URL TO HOMEASSISTANT>"

[Install]
WantedBy=multi-user.target

您需要进行以下替换

• 将 <PATH TO HASSBRIDGE> 替换为 hassbridge 脚本的位置（使用 which hassbridge）
• 将 <YOUR TOKEN> 替换为您长期有效的令牌（https://www.home-assistant.io/docs/authentication/#your-account-profile）
• 将 <URL TO HOMEASSISTANT> 替换为您实例的 URL（例如，http://192.168.123.123:8123）。

2. 启动服务并验证其是否正确运行

systemctl --user start hassbridge
systemctl --user status hassbridge

3. 启用服务以便您登录时自动启动

systemctl --user enable hassbridge

hassbridge --help

$ hassbridge --help
Usage: hassbridge [OPTIONS] COMMAND [ARGS]...

  hass-mpris bridge.

Options:
  --endpoint TEXT
  --token TEXT
  -d, --debug
  --help           Show this message and exit.

Commands:
  connect

它是如何工作的？

使用 homeassistant 的 Websocket API 实现与 Homeassistant 的连接。随后，homeassistant 实例中的每个 media_player 实体都将通过 D-Bus 暴露给其他应用程序使用，实现了两个 MPRIS 接口

• org.mpris.MediaPlayer2
• org.mpris.MediaPlayer2.Player

每次 homeassistant 通过 Websocket API 通知状态变化时，已知实体的详细情况将通过 D-Bus 接口通知客户端。

规格说明

• https://developers.home-assistant.io/docs/api/websocket/
• https://specifications.freedesktop.org/mpris-spec/2.2/

贡献

以拉取请求形式的贡献非常受欢迎。在提交 PR 之前，请通过调用 tox -e lint 验证代码格式是否正确。或者，您可以使用 pre-commit 来强制检查

$ pre-commit install