desktop-music-launcher

检索本机已安装音乐软件,启动它,并根据用户需求推荐、搜索或播放歌曲;在 macOS 上可用 AppleScript 控制 Spotify 和 Apple Music,并为 Spotify 增加可选的精确点播链路。

安装

概览

什么是desktop-music-launcher

desktop-music-launcher 是一款专为音乐爱好者设计的本地命令行工具,旨在帮助用户快速发现、启动和管理电脑上已安装的音乐播放软件。它通过统一的 Python 脚本接口,实现对 Spotify、Apple Music、QQ 音乐、网易云音乐、VLC、mpv 等多种主流音乐应用的智能调度。用户无需在多个客户端间切换,只需一条命令即可搜索歌曲、推荐歌单、打开本地音频文件或网络流,并直接交由对应播放器执行。该工具特别针对 macOS 系统优化,利用 AppleScript 实现与 Spotify 和 Apple Music 的深度集成,支持播放控制、状态查询甚至自动化点播,极大提升了跨平台音乐操作的效率与一致性。其设计原则强调安全与透明:所有操作均在本地完成,不依赖远程 API、账号密码或私有协议,确保用户隐私不被泄露。同时,工具明确声明不伪造播放状态、不绕过版权限制、不自动登录服务,仅提供基于现有应用能力的“尽力而为”式交互体验。

核心功能特点

  1. 扫描本机已安装的所有音乐播放软件,识别支持的功能及运行路径
  2. 一键打开任意音乐应用(如 Spotify、Apple Music、VLC、mpv 等)
  3. 按关键词搜索歌曲、歌手或专辑,并支持自动跳转至目标应用内搜索
  4. 根据使用场景(如学习、跑步、睡前)智能推荐音乐方向并生成可执行的搜索词
  5. 在 macOS 上通过 AppleScript 精确控制 Spotify 和 Apple Music 的播放/暂停/切歌/状态查询
  6. 支持播放本地音频文件或网络 URL,自动匹配支持的文件类型交给对应播放器

适用场景

这款工具最适合那些希望在日常使用中简化音乐操作流程的技术型用户。例如,当你正在编程或写作,突然想换一首适合专注的背景音乐时,可以直接输入 `python3 scripts/music_skill.py recommend “适合写代码的歌”`,系统会优先调用已安装的 Spotify 或 Apple Music,尝试通过 UI 自动化开始播放符合氛围的歌曲;若失败则退而求其次,在应用中打开搜索结果页面。对于经常通勤或健身的用户,它可以将‘跑步音乐’、‘放松助眠’等模糊需求转化为具体可搜索的关键词,避免手动筛选歌单的繁琐。在 macOS 环境下,开发者还能借助其控制功能实现自动化工作流——比如结合日历提醒,在会议开始前自动暂停音乐并调低音量。此外,即使面对不支持深度控制的播放器(如 Linux 上的 VLC),工具也能优雅降级:指定文件路径后自动调用 `vlc ~/Music/demo.mp3`,或将在线音频链接交给 mpv 播放。整个过程无需记忆各平台差异,也无需频繁切换窗口,真正实现‘一句话搞定音乐’的流畅体验。