spothomelight 0.1.0__py3-none-any.whl

spothomelight/auth.py

@@ -0,0 +1,47 @@
+import spotipy
+from spotipy.oauth2 import SpotifyOAuth
+import logging
+from .config import TOKEN_FILE
+
+def get_spotify_client(config):
+    client_id = config['SPOTIFY']['client_id']
+    client_secret = config['SPOTIFY']['client_secret']
+    redirect_uri = config['SPOTIFY']['redirect_uri']
+    
+    if not client_id or not client_secret:
+        print("错误: 请先在配置文件中填写 Client ID 和 Client Secret。")
+        print("运行 'spothomelight -c' 进行配置。")
+        return None
+
+    scope = "user-read-playback-state"
+
+    sp_oauth = SpotifyOAuth(
+        client_id=client_id,
+        client_secret=client_secret,
+        redirect_uri=redirect_uri,
+        scope=scope,
+        open_browser=False,
+        cache_path=TOKEN_FILE
+    )
+
+    token_info = sp_oauth.get_cached_token()
+
+    if not token_info:
+        auth_url = sp_oauth.get_authorize_url()
+        print("初次运行需要登录 Spotify。")
+        print("考虑到服务器环境，请复制以下 URL 到你电脑的浏览器中打开：")
+        print(f"\n{auth_url}\n")
+        print("登录并授权后，浏览器会重定向到 127.0.0.1。")
+        print("请复制地址栏中的完整 URL，并粘贴到下面。")
+        
+        response = input("粘贴 URL: ").strip()
+        
+        try:
+            code = sp_oauth.parse_response_code(response)
+            token_info = sp_oauth.get_access_token(code)
+            print(f"登录成功。Token 已保存至: {TOKEN_FILE}")
+        except Exception as e:
+            print(f"登录失败: {e}")
+            return None
+
+    return spotipy.Spotify(auth=token_info['access_token'], oauth_manager=sp_oauth)

spothomelight/config.py

@@ -0,0 +1,87 @@
+import os
+import sys
+import configparser
+import subprocess
+import platform
+from appdirs import user_config_dir
+
+APP_NAME = "spothomelight"
+CONFIG_DIR = user_config_dir(APP_NAME)
+CONFIG_FILE = os.path.join(CONFIG_DIR, "spothomelight.conf")
+TOKEN_FILE = os.path.join(CONFIG_DIR, "token.json")
+
+DEFAULT_CONFIG = """[SPOTIFY]
+client_id = 
+client_secret = 
+redirect_uri = http://127.0.0.1:29092/callback
+
+[HOME_ASSISTANT]
+ha_url = http://127.0.0.1:8123
+webhook_id = 
+
+[GENERAL]
+interval = 5
+"""
+
+HA_YAML_TEMPLATE = """
+配置完毕后，请配置 Home Assistant 的自动化配置。
+
+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
+"""
+
+def ensure_config():
+    if not os.path.exists(CONFIG_DIR):
+        os.makedirs(CONFIG_DIR)
+    if not os.path.exists(CONFIG_FILE):
+        with open(CONFIG_FILE, 'w', encoding='utf-8') as f:
+            f.write(DEFAULT_CONFIG)
+        print(f"配置文件已生成: {CONFIG_FILE}")
+
+def load_config():
+    ensure_config()
+    config = configparser.ConfigParser()
+    config.read(CONFIG_FILE)
+    return config
+
+def open_config_editor():
+    ensure_config()
+    
+    print(f"\n正在打开配置文件: {CONFIG_FILE}")
+    print("请填写 Spotify Client ID/Secret 和 Home Assistant Webhook ID。")
+    print(HA_YAML_TEMPLATE)
+
+    system_platform = platform.system()
+    
+    if system_platform == "Windows":
+        try:
+            os.startfile(CONFIG_FILE)
+        except Exception as e:
+            print(f"无法自动打开编辑器: {e}")
+            print("请手动打开修改。")
+    else:
+        editor = os.environ.get('EDITOR')
+        if not editor:
+            if os.path.exists("/usr/bin/nano"):
+                editor = "nano"
+            elif os.path.exists("/usr/bin/vi"):
+                editor = "vi"
+            else:
+                print("未找到默认编辑器，请手动编辑。")
+                return
+
+        subprocess.call([editor, CONFIG_FILE])

spothomelight/core.py

@@ -0,0 +1,83 @@
+import time
+import requests
+import json
+from .utils import get_image_color, write_pid
+from .auth import get_spotify_client
+
+def run_loop(config):
+    write_pid()
+
+    sp = get_spotify_client(config)
+    if not sp:
+        return
+
+    ha_url = config['HOME_ASSISTANT']['ha_url'].rstrip('/')
+    webhook_id = config['HOME_ASSISTANT']['webhook_id']
+    interval = int(config['GENERAL']['interval'])
+    
+    if not webhook_id:
+        print("错误: 配置文件中 webhook_id 为空，无法发送数据。")
+        return
+
+    webhook_full_url = f"{ha_url}/api/webhook/{webhook_id}"
+    
+    print(f"服务已启动。监控频率: {interval}秒")
+    print(f"Home Assistant 地址: {webhook_full_url}")
+
+    last_track_id = None
+    last_is_playing = False
+
+    while True:
+        try:
+            playback = sp.current_playback()
+            
+            if playback and playback['is_playing']:
+                item = playback['item']
+                if not item: 
+                    time.sleep(interval)
+                    continue
+
+                track_id = item['id']
+                
+                if track_id != last_track_id or not last_is_playing:
+                    print(f"检测到正在播放: {item['name']} - {item['artists'][0]['name']}")
+                    
+                    images = item['album']['images']
+                    image_url = images[0]['url'] if images else None
+                    
+                    if image_url:
+                        rgb = get_image_color(image_url)
+                        if rgb:
+                            payload = {
+                                "state": "playing",
+                                "title": item['name'],
+                                "artist": item['artists'][0]['name'],
+                                "image_url": image_url,
+                                "rgb": list(rgb),
+                                "hex": '#%02x%02x%02x' % rgb
+                            }
+                            
+                            try:
+                                requests.post(webhook_full_url, json=payload, timeout=5)
+                                print(f"已发送颜色 {payload['hex']} 到 HA")
+                            except Exception as e:
+                                print(f"发送 Webhook 失败: {e}")
+                    
+                    last_track_id = track_id
+                
+                last_is_playing = True
+            
+            else:
+                if last_is_playing:
+                    print("播放已暂停/停止")
+                    # try:
+                    #     requests.post(webhook_full_url, json={"state": "paused"}, timeout=5)
+                    # except:
+                    #     pass
+                last_is_playing = False
+
+        except Exception as e:
+            print(f"运行循环发生错误: {e}")
+            time.sleep(10)
+
+        time.sleep(interval)

spothomelight/main.py

@@ -0,0 +1,48 @@
+import argparse
+import sys
+from .config import load_config, open_config_editor
+from .service import setup_autostart
+from .utils import check_running, stop_process
+from .core import run_loop
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="SpotHomeLight",
+        description="Spotify 专辑封面颜色控制智能家居（Home Assistant）。",
+        formatter_class=argparse.RawTextHelpFormatter,
+        epilog="""
+        """
+    )
+    
+    parser.add_argument("-c", "--config", action="store_true", help="打开配置文件")
+    parser.add_argument("-a", "--autostart", action="store_true", help="配置开机自动运行")
+    parser.add_argument("-s", "--stop", action="store_true", help="停止正在运行的服务")
+    
+    args = parser.parse_args()
+
+    if args.config:
+        open_config_editor()
+        sys.exit(0)
+
+    if args.stop:
+        stop_process()
+        sys.exit(0)
+
+    if args.autostart:
+        setup_autostart()
+        sys.exit(0)
+
+    pid = check_running()
+    if pid:
+        print(f"错误: 服务已在运行中 (PID: {pid})。请先停止或直接使用。")
+        sys.exit(1)
+
+    config = load_config()
+    try:
+        run_loop(config)
+    except KeyboardInterrupt:
+        print("\n用户手动停止。")
+        stop_process()
+
+if __name__ == "__main__":
+    main()

spothomelight/service.py

@@ -0,0 +1,52 @@
+import os
+import sys
+import platform
+import subprocess
+
+def setup_autostart():
+    system = platform.system()
+    python_exec = sys.executable
+    script_cmd = f'"{python_exec}" -m spothomelight.main'
+
+    if system == "Linux":
+        service_dir = os.path.expanduser("~/.config/systemd/user")
+        if not os.path.exists(service_dir):
+            os.makedirs(service_dir)
+        
+        service_content = f"""[Unit]
+Description=SpotHomeLight Service
+After=network.target
+
+[Service]
+ExecStart={script_cmd}
+Restart=always
+RestartSec=10
+
+[Install]
+WantedBy=default.target
+"""
+        service_path = os.path.join(service_dir, "spothomelight.service")
+        with open(service_path, "w") as f:
+            f.write(service_content)
+        
+        print(f"已生成 Systemd 服务文件: {service_path}")
+        print("正在启用服务...")
+        os.system("systemctl --user daemon-reload")
+        os.system("systemctl --user enable --now spothomelight")
+        print("完成。请使用 'systemctl --user status spothomelight' 查看状态。")
+
+    elif system == "Windows":
+        task_name = "SpotHomeLightAutoStart"
+        cmd = [
+            "schtasks", "/Create", "/F",
+            "/TN", task_name,
+            "/TR", script_cmd,
+            "/SC", "ONLOGON",
+            "/RL", "HIGHEST"
+        ]
+        try:
+            subprocess.run(cmd, check=True)
+            print(f"已创建 Windows 计划任务: {task_name}")
+            print("下次登录时将自动运行。")
+        except subprocess.CalledProcessError as e:
+            print(f"创建计划任务失败: {e}")

spothomelight/utils.py

@@ -0,0 +1,65 @@
+import os
+import sys
+import signal
+import requests
+from io import BytesIO
+from PIL import Image
+import colorgram
+from appdirs import user_cache_dir
+
+APP_NAME = "spothomelight"
+PID_FILE = os.path.join(user_cache_dir(APP_NAME), "spothomelight.pid")
+
+def get_image_color(image_url):
+    try:
+        response = requests.get(image_url, timeout=10)
+        original_image_data = BytesIO(response.content)
+        
+        with Image.open(original_image_data) as img:
+            img = img.convert('RGB')
+            img.thumbnail((100, 100))
+            
+            buffer = BytesIO()
+            img.save(buffer, format="JPEG")
+            buffer.seek(0)
+        
+        colors = colorgram.extract(buffer, 1)
+        
+        if colors:
+            rgb = colors[0].rgb
+            return (rgb.r, rgb.g, rgb.b)
+
+    except Exception as e:
+        print(f"取色失败: {e}")
+        return None
+
+def write_pid():
+    pid_dir = os.path.dirname(PID_FILE)
+    if not os.path.exists(pid_dir):
+        os.makedirs(pid_dir)
+    with open(PID_FILE, 'w') as f:
+        f.write(str(os.getpid()))
+
+def check_running():
+    if os.path.exists(PID_FILE):
+        try:
+            with open(PID_FILE, 'r') as f:
+                pid = int(f.read().strip())
+            os.kill(pid, 0)
+            return pid
+        except (OSError, ValueError):
+            os.remove(PID_FILE)
+    return None
+
+def stop_process():
+    pid = check_running()
+    if pid:
+        try:
+            os.kill(pid, signal.SIGTERM)
+            print(f"已停止进程 PID: {pid}")
+            if os.path.exists(PID_FILE):
+                os.remove(PID_FILE)
+        except PermissionError:
+            print("权限不足，无法停止进程。")
+    else:
+        print("服务未运行。")

spothomelight/utils_median_cut.py

@@ -0,0 +1,68 @@
+import os
+import sys
+import signal
+import requests
+from io import BytesIO
+from PIL import Image
+from appdirs import user_cache_dir
+
+APP_NAME = "spothomelight"
+PID_FILE = os.path.join(user_cache_dir(APP_NAME), "spothomelight.pid")
+
+def get_image_color(image_url):
+    try:
+        response = requests.get(image_url, timeout=10)
+        image_data = BytesIO(response.content)
+        
+        with Image.open(image_data) as img:
+            img = img.convert('RGB')
+            
+            img.thumbnail((100, 100))
+            
+            p_img = img.quantize(colors=5, method=0)
+            
+            dominant_color = sorted(p_img.getcolors(maxcolors=10), key=lambda x: x[0], reverse=True)[0]
+            
+            palette = p_img.getpalette()
+            color_index = dominant_color[1]
+            
+            r = palette[color_index * 3]
+            g = palette[color_index * 3 + 1]
+            b = palette[color_index * 3 + 2]
+            
+            return (r, g, b)
+
+    except Exception as e:
+        print(f"取色失败: {e}")
+        return None
+
+def write_pid():
+    pid_dir = os.path.dirname(PID_FILE)
+    if not os.path.exists(pid_dir):
+        os.makedirs(pid_dir)
+    with open(PID_FILE, 'w') as f:
+        f.write(str(os.getpid()))
+
+def check_running():
+    if os.path.exists(PID_FILE):
+        try:
+            with open(PID_FILE, 'r') as f:
+                pid = int(f.read().strip())
+            os.kill(pid, 0)
+            return pid
+        except (OSError, ValueError):
+            os.remove(PID_FILE)
+    return None
+
+def stop_process():
+    pid = check_running()
+    if pid:
+        try:
+            os.kill(pid, signal.SIGTERM)
+            print(f"已停止进程 PID: {pid}")
+            if os.path.exists(PID_FILE):
+                os.remove(PID_FILE)
+        except PermissionError:
+            print("权限不足，无法停止进程。")
+    else:
+        print("服务未运行。")

spothomelight-0.1.0.dist-info/METADATA

@@ -0,0 +1,147 @@
+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.

spothomelight-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+spothomelight/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+spothomelight/auth.py,sha256=TGmR28lIBZnEVkMv7jIDBToZT3rcFUaqv4ZineIO-Do,1706
+spothomelight/config.py,sha256=URC1WwzZN2gRIfwNlMRwHNVtoviayYzmf6F0w3lMhLA,2274
+spothomelight/core.py,sha256=u87Q3BTdwbpjQIT4sZAK9-g79Rr-KHOepSLs2jDufPo,3002
+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-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

spothomelight-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+spothomelight = spothomelight.main:main

spothomelight-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+spothomelight