spothomelight 0.1.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

{spothomelight-0.1.0.dist-info → spothomelight-1.0.1.dist-info}/METADATA

@@ -1,147 +1,154 @@
-Metadata-Version: 2.4
-Name: spothomelight
-Version: 0.1.0
-Summary: Sync Spotify cover color to Home Assistant via Webhook
-Author-email: "ZGQ Inc." <zgqinc@gmail.com>
-Project-URL: Homepage, https://domain.zgqinc.gq/
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: requests
-Requires-Dist: spotipy
-Requires-Dist: colorgram.py
-Requires-Dist: Pillow
-Requires-Dist: appdirs
-
-# SpotHomeLight 🎵🏠💡
-
-**SpotHomeLight** 是一个轻量级的 Python 服务，用于将 Spotify 当前播放封面的主色调同步到 Home Assistant。
-
-它运行在你的家用服务器（Linux 或 Windows）上，通过 K-Means 聚类算法提取封面颜色，并通过 Webhook 实时推送到 Home Assistant，让你的智能灯光跟随音乐氛围律动。
-
-## ✨ 功能特性
-
-* **跨平台支持**：完美支持 Linux (Systemd) 和 Windows (计划任务)。
-* **无头模式设计**：专为无显示器的家用服务器设计，支持终端内完成 OAuth 认证。
-* **智能取色**：使用 K-Means 聚类算法提取最主要颜色，并进行缩略图预处理以降低 CPU 占用。
-* **开机自启**：内置一键配置开机自动运行 (`-a`)。
-* **低资源占用**：去重机制，仅在切歌时进行下载和计算。
-
-## 🛠️ 前置要求
-
-1.  **Home Assistant**: 一个运行中的 HA 实例。
-2.  **Spotify 开发者账号**: 用于获取 API 凭证。
-
-## 📦 安装
-
-使用 pip 安装：
-
-```bash
-pip install spothomelight
-```
-
-## 🚀 快速开始
-
-### 准备 Spotify API
-
-1. 登录 [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/).
-2. 创建一个新的 App (例如命名为 `SpotHomeLight`)。
-3. 将 Redirect URI 设置为：
-
-```
-[http://127.0.0.1:29092/callback](http://127.0.0.1:29092/callback)
-```
-
-4. 记下 **Client ID** 和 **Client Secret**。
-
-### 初始化配置
-
-运行以下命令打开配置文件：
-
-```bash
-spothomelight -c
-```
-
-conf描述：
-
-```ini
-[SPOTIFY]
-client_id = Client ID
-client_secret = Client Secret
-redirect_uri = 重定向URI（一般不需要修改，除非你知道自己在干什么。）
-
-[HOME_ASSISTANT]
-ha_url =  Home Assistant 地址（局域网/广域网）
-webhook_id = 从 Home Assistant 获取的 Webhook ID
-
-[GENERAL]
-interval = 循环周期（秒）
-```
-
-### 配置 Home Assistant
-
-登录 Home Assistant 后台，设置，自动化与场景，创建自动化，创建新的自动化，右上角三点菜单，YAML 编辑，将下面的yaml粘贴进去，保存。
-
-右上角三点菜单，可视化编辑，复制 每当 里面的 Webhook ID，注意不要点复制按钮，那会复制API地址，需要选中输入框的内容并复制。
-
-就执行 的实体删除pending，添加目标，选择自己的RGB灯，保存。
-
-```yaml
-alias: Spotify Cover Sync
-description: ""
-mode: restart
-trigger:
-  - platform: webhook
-    webhook_id: ""
-    local_only: true
-condition: []
-action:
-  - service: light.turn_on
-    target:
-      entity_id: light.pending
-    data:
-      rgb_color: "{{ trigger.json.rgb }}"
-      brightness_pct: 100
-      transition: 2
-```
-
-### 首次运行与认证
-
-在终端运行：
-
-```bash
-spothomelight
-```
-
-考虑到服务器通常没有浏览器，程序会打印一个认证 URL。
-
-1. 复制该 URL 到你电脑的浏览器中打开。
-2. 登录并点击“同意”。
-3. 浏览器会跳转到一个 `127.0.0.1` 的无法连接页面。
-4. 复制浏览器地址栏中完整的 URL。
-5. 回到服务器终端，粘贴 URL 并回车。
-
-认证成功后，程序应该开始监控并在终端输出日志，观察输出是否正常。
-
-### 第五步：设置开机自启
-
-确认运行正常后，Ctrl+C 停止程序，然后运行：
-
-```bash
-spothomelight -a
-```
-
-* **Linux**: 会自动创建并启用 Systemd User Service。
-* **Windows**: 会自动创建 Windows 计划任务（登录时运行）。
-
-停止服务：
-
-```bash
-spothomelight -s
-```
-
-## 📝 License
-
-MIT License. Copyright (c) 2026 ZGQ Inc.
+Metadata-Version: 2.4
+Name: spothomelight
+Version: 1.0.1
+Summary: Sync Spotify cover color to Home Assistant via Webhook
+Author-email: "ZGQ Inc." <zgqinc@gmail.com>
+Project-URL: Homepage, https://github.com/ZGQ-inc/SpotHomeLight
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: spotipy
+Requires-Dist: colorgram.py
+Requires-Dist: Pillow
+Requires-Dist: appdirs
+Dynamic: license-file
+
+# SpotHomeLight 🎵🏠💡
+
+**SpotHomeLight** 是一个轻量级的 Python 服务，用于将 Spotify 当前播放封面的主色调同步到 Home Assistant。
+
+它运行在你的家用服务器（Linux 或 Windows）上，通过 K-Means 聚类算法提取封面颜色，并通过 Webhook 实时推送到 Home Assistant，让你的智能灯光跟随音乐氛围律动。
+
+## ✨ 功能特性
+
+* **跨平台支持**：完美支持 Linux (Systemd) 和 Windows (计划任务)。
+* **无头模式设计**：专为无显示器的家用服务器设计，支持终端内完成 OAuth 认证。
+* **智能取色**：使用 K-Means 聚类算法提取最主要颜色，并进行缩略图预处理以降低 CPU 占用。
+* **开机自启**：内置一键配置开机自动运行 (`-a`)。
+* **低资源占用**：去重机制，仅在切歌时进行下载和计算。
+
+## 🛠️ 前置要求
+
+1.  **Home Assistant**: 一个运行中的 HA 实例。
+2.  **Spotify 开发者账号**: 用于获取 API 凭证。
+
+## 📦 安装
+
+使用 pip 安装：
+
+```bash
+pip install spothomelight
+```
+
+## 🚀 快速开始
+
+### 准备 Spotify API
+
+1. 登录 [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/).
+2. 创建一个新的 App (例如命名为 `SpotHomeLight`)。
+3. 将 Redirect URI 设置为：
+
+```
+http://127.0.0.1:29092/callback
+```
+
+4. 记下 **Client ID** 和 **Client Secret**。
+
+### 初始化配置
+
+运行以下命令打开配置文件：
+
+```bash
+spothomelight -c
+```
+
+conf描述：
+
+```ini
+[SPOTIFY]
+client_id = Client ID
+client_secret = Client Secret
+redirect_uri = 重定向URI（一般不需要修改，除非你知道自己在干什么。）
+
+[HOME_ASSISTANT]
+ha_url =  Home Assistant 地址（局域网/广域网）
+webhook_id = 从 Home Assistant 获取的 Webhook ID
+
+[GENERAL]
+interval = 循环周期（秒）
+```
+
+### 配置 Home Assistant
+
+登录 Home Assistant 后台，设置，自动化与场景，创建自动化，创建新的自动化，右上角三点菜单，YAML 编辑，将下面的yaml粘贴进去，保存。
+
+右上角三点菜单，可视化编辑，复制 每当 里面的 Webhook ID，注意不要点复制按钮，那会复制API地址，需要选中输入框的内容并复制。
+
+就执行 的实体删除pending，添加目标，选择自己的RGB灯，保存。
+
+```yaml
+alias: Spotify Cover Sync
+description: ""
+mode: restart
+trigger:
+  - platform: webhook
+    webhook_id: ""
+    local_only: true
+condition: []
+action:
+  - service: light.turn_on
+    target:
+      entity_id: light.pending
+    data:
+      rgb_color: "{{ trigger.json.rgb }}"
+      brightness_pct: 100
+      transition: 2
+```
+
+### 首次运行与认证
+
+在终端运行：
+
+```bash
+spothomelight
+```
+
+考虑到服务器通常没有浏览器，程序会打印一个认证 URL。
+
+1. 复制该 URL 到你电脑的浏览器中打开。
+2. 登录并点击“同意”。
+3. 浏览器会跳转到一个 `127.0.0.1` 的无法连接页面。
+4. 复制浏览器地址栏中完整的 URL。
+5. 回到服务器终端，粘贴 URL 并回车。
+
+认证成功后，程序应该开始监控并在终端输出日志，观察输出是否正常。
+
+### 第五步：设置开机自启
+
+确认运行正常后，Ctrl+C 停止程序，然后运行：
+
+```bash
+spothomelight -a
+```
+
+* **Linux**: 会自动创建并启用 Systemd User Service。
+* **Windows**: 会自动创建 Windows 计划任务（登录时运行）。
+
+停止服务：
+
+```bash
+spothomelight -s
+```
+
+## 🐛 已知问题
+
+* **取色结果与客户端不一致**: 
+  本工具目前使用 **K-Means 聚类算法** 来提取封面主色调。由于 Spotify 官方客户端的动态取色算法（涉及饱和度筛选、亮度平衡、以及如何排除纯黑/纯白背景等逻辑）并未公开且较为复杂，**本工具计算出的颜色可能与你在 Spotify 电脑或手机端看到的背景色存在差异**。
+
+## 📝 License
+
+MIT License. Copyright (c) 2026 ZGQ Inc.

{spothomelight-0.1.0.dist-info → spothomelight-1.0.1.dist-info}/RECORD

@@ -6,8 +6,9 @@ spothomelight/main.py,sha256=jX8esko2yj8c09HKBb1qmQloWE0mUQEc0F_CL27l5t8,1377
 spothomelight/service.py,sha256=jrlnIn9LL1YIEUrWoiVzPQgEFNvh0L0QBUSqNBMvAOg,1649
 spothomelight/utils.py,sha256=TnGji05MKMTsoqWUq5wFPx6jLthqA-KWVH-dCu5VbIc,1814
 spothomelight/utils_median_cut.py,sha256=9sqUBk0ZpHWwfoPl4YPRcljE_K05w8trZFQo8bVCMds,1991
-spothomelight-0.1.0.dist-info/METADATA,sha256=aSN5SM6XWzXhpX6ivYF3RHVr8blqbc-oXduXWODBxFE,4248
-spothomelight-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-spothomelight-0.1.0.dist-info/entry_points.txt,sha256=f9haGAoi-aXDTCkoxuSkdN78sHbvfbrr9gwaOIewuvw,58
-spothomelight-0.1.0.dist-info/top_level.txt,sha256=70ecLHIP1BNR5ZLYC-IfQ6ceydH0AZaDGIoH_wGrQZY,14
-spothomelight-0.1.0.dist-info/RECORD,,
+spothomelight-1.0.1.dist-info/licenses/LICENSE,sha256=_r815CZLcqdQJmXH7FeFNoBT8gmiGtsdqo4aynUS-DM,1065
+spothomelight-1.0.1.dist-info/METADATA,sha256=Sl-lIhnLB9Pl9Fk1LY6xya3JNPu4zY4SI0D5dN1cpq4,4545
+spothomelight-1.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+spothomelight-1.0.1.dist-info/entry_points.txt,sha256=f9haGAoi-aXDTCkoxuSkdN78sHbvfbrr9gwaOIewuvw,58
+spothomelight-1.0.1.dist-info/top_level.txt,sha256=70ecLHIP1BNR5ZLYC-IfQ6ceydH0AZaDGIoH_wGrQZY,14
+spothomelight-1.0.1.dist-info/RECORD,,

spothomelight-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZGQ Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.