YouTube音乐投屏

技能简介

YouTube Music Cast 是一款命令行工具，用于从 YouTube 或 YouTube Music 下载音频，并通过 Home Assistant 投放到本地网络中的 Chromecast 设备。无需订阅付费服务，音乐文件保存在本地，支持离线播放。

业务背景

解决家庭音乐播放的订阅成本与网络依赖问题。通过本地下载与投屏能力，用户无需持续付费即可构建私人音乐库，并在局域网内灵活推送至任意音箱设备，实现离线场景下的高品质音频体验。

落地案例：某智能家居用户希望将YouTube Music上的健身歌单同步至客厅音箱。使用本工具批量下载播放列表为320K MP3，通过Home Assistant一键投送至Chromecast Audio。即使健身房断网，本地文件仍可随时调用，同时可选生成带歌词的MP4用于电视跟练。

能做什么

• 下载 YouTube/YouTube Music 音频为 320K MP3 格式
• 将下载的音乐投放到任意 Chromecast 设备
• 批量下载整个播放列表
• 生成带封面和歌词的 MP4 视频文件
• 自动发现相关歌曲并连续播放（电台模式）
• 多房间同步播放同一曲目

使用说明

安装步骤：

1. 确保系统已安装 yt-dlp、Python 3、curl、jq
2. 克隆仓库并进入目录：cd youtube-music-cast
3. 赋予脚本执行权限：chmod +x scripts/*
4. 全局安装：./install.sh --global 或本地安装：./install.sh
5. 运行配置向导：cast-setup，按提示输入 Home Assistant 地址、访问令牌、服务器 IP 和默认播放器

基本使用：

1. 下载歌曲：cast-download https://youtube.com/watch?v=xxx
2. 启动本地服务器：cast-server start
3. 播放指定文件：cast-play 文件名.mp3

输入与输出

见下方输入与输出表格。

风险提示

• 下载受版权保护的内容可能违反当地法律法规
• 需自行承担内容来源的合规责任
• 依赖 yt-dlp 工具，该工具更新频繁，建议定期升级
• 需要 Home Assistant 长期运行并保持网络连通
• 本地 HTTP 服务器仅在内网可用，请勿暴露至公网

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/aidanthebandit/ytm-cast/SKILL.md
来源类型：GitHub 仓库