用途:把 YouTube 视频的音频下载下来,打上标题、艺术家、专辑等元数据,再通过 USB 推送到 iPhone 上的 BookPlayer。BookPlayer 是 iOS 有声书播放器,能记住播放位置,适合讲座、有声书、播客等长音频;文件放入其 /Documents/ 目录后,下次启动应用会自动导入。
主要能力:按阶段执行流程。阶段 0 预检工具与设备,检查 yt-dlp、ffmpeg、exiftool、pymobiledevice3 是否可用,并确认已连接 iOS 设备且已安装 BookPlayer。阶段 1 接收 YouTube URL,用 yt-dlp 预览标题、频道、时长、上传日期并确认元数据。阶段 2 下载音频,命令为 yt-dlp -x --audio-format m4a --audio-quality 0 --no-playlist。阶段 3 用 exiftool 写入 Title、Artist、Album。阶段 4 推送文件,必须使用 Python API 且 documents_only=True,CLI 的 apps push 使用 VendContainer 模式,对 BookPlayer 无效。阶段 5 列出 /Documents/ 验证文件并清理临时目录。
使用方式:需要 macOS 环境,缺失工具可用 brew install yt-dlp、brew install ffmpeg、brew install exiftool 安装;pymobiledevice3 可通过 uvx --python 3.14 --from pymobiledevice3 调用。iPhone 需用 USB 连接、解锁并点按“信任此电脑”。
限制:仅支持通过 USB 推送,未提供无线方式;未提供收费、价格或平台支持范围等信息;若设备未连接或未安装 BookPlayer,流程会中止并提示用户处理。