♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫
    
    🏠  H O M E   M U S I C  🎵
    
    ╔══════════════════════════════════════════╗
    ║   Whole-House Music Scenes               ║
    ║   One command. All speakers. Perfect.    ║
    ╚══════════════════════════════════════════╝
    
    ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫ ♪ ♫

“Why click 17 times when one command does the job?” – Owen 🐸

🎯 此技能的作用是什么？

Home Music 将 Spotify 与 Airfoil 深度整合，打造“全屋音乐场景”。只需一条命令，即可将指定歌单、以理想音量、精准推送到目标扬声器。

想象一下：

• 清晨醒来 → home-music morning → 浴室响起轻柔旋律
• 朋友到访 → home-music party → 所有扬声器同步播放摇滚乐
• 准备放松 → home-music chill → 客厅、卧室处处弥漫慵懒 Lounge 氛围
• 结束一天 → home-music off → 归于寂静。安宁。澄澈。

📋 依赖项

⚠️ 重要提示： 启动任意音乐场景前，请确保 Spotify 和 Airfoil 均已运行！

🎬 场景（Scenes）

🌅 Morning（晨间）

温柔开启你的一天

home-music morning

• 扬声器： Sonos Move
• 音量： 40%
• 歌单： Morning Playlist
• 氛围： ☕ 咖啡 + 美好心情

🎉 Party（派对）

是时候庆祝了！

home-music party

• 扬声器： 全部（Computer、MacBook、Sonos Move、Living Room TV）
• 音量： 70%
• 歌单： Rock Party Mix
• 氛围： 🤘 邻居们最讨厌的这一招

😌 Chill（舒缓）

纯粹的放松时刻

home-music chill

• 扬声器： Sonos Move
• 音量： 30%
• 歌单： Chill Lounge
• 氛围： 🧘 Om…

🔇 Off（关闭）

静音

home-music off

• 暂停 Spotify 播放
• 断开所有扬声器连接
• 氛围： 🤫 终于，宁静与安详

📊 Status（状态）

当前正在播放什么？

home-music status

显示以下信息：

• 当前 Spotify 正在播放的曲目
• 已连接的扬声器列表

🔧 安装方法

# 为脚本添加可执行权限
chmod +x ~/clawd/skills/home-music/home-music.sh

# 创建全局软链接
sudo ln -sf ~/clawd/skills/home-music/home-music.sh /usr/local/bin/home-music

现在，你可在终端任意位置直接运行 home-music 命令！🎉

🎨 自定义歌单与场景

更换歌单

打开 home-music.sh 文件，定位到歌单配置区：

# === PLAYLIST CONFIGURATION ===
PLAYLIST_MORNING="spotify:playlist:19n65kQ5NEKgkvSAla5IF6"
PLAYLIST_PARTY="spotify:playlist:37i9dQZF1DXaXB8fQg7xif"
PLAYLIST_CHILL="spotify:playlist:37i9dQZF1DWTwnEm1IYyoj"

如何获取歌单 URI：

1. 在 Spotify 中右键点击目标歌单
2. 选择 “Share” → “Copy Spotify URI”
3. 或复制网页 URL，并从中提取 /playlist/ 后的完整 ID 部分

新增一个场景

在 main 函数块中新增一个 case 分支：

# 在 home-music.sh 中，位于 "scene_chill" 函数之后：

scene_workout() {
    echo "💪 Starting Workout scene..."
    airfoil_set_source_spotify
    airfoil_connect "Sonos Move"
    sleep 0.5
    airfoil_volume "Sonos Move" 0.8
    "$SPOTIFY_CMD" play "spotify:playlist:YOUR_WORKOUT_PLAYLIST"
    "$SPOTIFY_CMD" volume 100
    echo "✅ Workout: Sonos Move @ 80%, Pump it up!"
}

# 并在 case 区域中添加：
    workout)
        scene_workout
        ;;

可用扬声器列表

ALL_SPEAKERS=("Computer" "Andy's M5 Macbook" "Sonos Move" "Living Room TV")

你可以添加任意 AirPlay 扬声器——只要它在 Airfoil 应用中可见即可。

🐛 故障排查

❌ “扬声器无法连接”

检查 1： Airfoil 是否正在运行？

pgrep -x Airfoil || echo "Airfoil is not running!"

检查 2： 扬声器是否已接入同一网络？

• 打开 Airfoil 应用
• 确认该扬声器是否出现在设备列表中
• 尝试手动连接一次

检查 3： 扬声器名称是否完全一致？

• 名称区分大小写！
• 请在 Airfoil 应用中复制其显示的精确名称

❌ “没有声音输出”

检查 1： Spotify 是否正在播放？

~/clawd/skills/spotify-applescript/spotify.sh status

检查 2： Airfoil 的音频源是否设置正确？

• 打开 Airfoil 应用
• 确认 “Spotify” 是否被选为当前音频源
• 如未选择：点击 “Source” → 选择 Spotify

检查 3： 扬声器音量是否为零？

# 手动查询音量值
osascript -e 'tell application "Airfoil" to get volume of (first speaker whose name is "Sonos Move")'

❌ “Spotify 无法启动”

Spotify 是否已打开？

pgrep -x Spotify || open -a Spotify

spotify-applescript 是否已安装？

ls ~/clawd/skills/spotify-applescript/spotify.sh

❌ “Permission denied（权限拒绝）”

chmod +x ~/clawd/skills/home-music/home-music.sh

🔊 直接调用 Airfoil 命令

如需手动控制 Airfoil，可使用以下 AppleScript 命令：

# 连接指定扬声器
osascript -e 'tell application "Airfoil" to connect to (first speaker whose name is "Sonos Move")'

# 设置扬声器音量（范围：0.0 – 1.0）
osascript -e 'tell application "Airfoil" to set (volume of (first speaker whose name is "Sonos Move")) to 0.5'

# 断开指定扬声器
osascript -e 'tell application "Airfoil" to disconnect from (first speaker whose name is "Sonos Move")'

# 列出当前已连接的所有扬声器
osascript -e 'tell application "Airfoil" to get name of every speaker whose connected is true'

# 设置音频源为 Spotify
osascript -e 'tell application "Airfoil"
    set theSource to (first application source whose name contains "Spotify")
    set current audio source to theSource
end tell'

📁 文件结构

skills/home-music/
├── SKILL.md        # 本文档
└── home-music.sh   # 主脚本文件

💡 高级技巧

1. 设置别名（alias），实现秒级调用：

   alias mm="home-music morning"
   alias mp="home-music party"
   alias mc="home-music chill"
   alias mo="home-music off"
   

2. 与 Clawdbot 协同使用：

   “Hey, start party mode” “Put on some chill music” “Stop the music”

3. 组合多个场景： 创建一个 dinner 场景，搭配爵士乐歌单、音量设为 25%，待客恰到好处！

🐸 致谢

╭─────────────────────────────────────────────╮
│                                             │
│   Crafted with 💚 by Owen the Frog 🐸      │
│                                             │
│   "Ribbit. Music makes everything better."  │
│                                             │
╰─────────────────────────────────────────────╯

作者： Andy Steinberger（并得到他的 Clawdbot —— Owen the Frog 🐸 的协助）
版本： 1.0.0
许可证： MIT
栖息地： 那片长满睡莲的池塘 🪷

这个技能是否改善了你的生活？Owen 很喜欢苍蝇。🪰