聚合音乐 桌面端
MergeMusicDesktop

有何特点？

• 聚合网易云、QQ、B站.... ALL IN ONE !!
• 美观简洁的 UI 设计
• 视觉效果佳且具有一定可玩性的音频可视化
• 桌面跨平台支持（已测试Windows、Ubuntu）

如何使用？

• 对于小白 Windows 用户：下载.zip包，解压到合适的位置，然后双击MergeMusicDesktop.exe运行即可。
• 对于熟悉 Java 环境的 Windows 用户：下载.jar包，双击或使用java命令运行（打包环境为JDK19）。
• 对于小白 Linux 用户：不存在，小白不会用 Linux 。
• 对于一般 Linux 用户：下载解压.tar.gz文件，双击或命令行运行bin目录下的文件即可。最好安装一下ffmpeg（如apt install ffmpeg），否则可能音频解码会失败，另外注意一下整个文件夹是否有可执行权限。
• 对于熟悉 Java 环境的 Linux 用户：同 Windows ，但注意由于 JavaFX 限制，.jar包不通用。
• 对于 MacOS 用户：我之前用 GitHub Action 打了包但给朋友试了跑不起来。等我有钱了买了 Mac 再说吧....或者你可以v我一台😋
• 对于非常熟悉 Java 的用户：直接拉源码呗。
• 对于非常非常非常....熟悉 Java 和 CS 的用户：直接看代码颅内编译。

进阶使用指南 | 可能遇到的问题

• 音频可视化不同步：请在设置面板中调节“音频可视化延迟时间”参数。

• 如何访问会员歌曲或私有歌单：访问 网易云音乐官网 或 QQ音乐官网 或 B站官网，登录，然后F12获取Cookie，具体教程网上有很多（比如这个）。获取Cookie后填到设置面板中，保存即生效。

• 配置文件和缓存：使用设置中的“二向箔”功能可以全部清理。也可以手动到app文件夹（或.jar包同目录下）找到music.sqlite（音乐、收藏夹数据库）、config.properties（设置信息）以及cache文件夹（音乐图片缓存），可以随意删除，但不要随意修改。

• 关于音频可视化：可以自己探索调节设置中的参数玩玩，带有“采样”字样的需要切换歌曲才会生效。

• 关于字体：为了良好的显示体验，全局配置了思源宋体并打包了进去（尽管字体文件有≈10MB），如果使用.jar运行，可以自己下载一个SourceHanSerifCN-Medium.otf放在同一目录下。

• 其他问题：欢迎提 issue o(〃＾▽＾〃)o

主要技术细节

开发环境为IntelliJ IDEA 2022.3 + JDK19 + Windows10，测试还在Ubuntu 22.04 以及 Ubuntu 18.04 上进行过。

主要基于 JavaFX 进行开发并用 maven 进行包管理。还使用了 MaterialFX 这个 UI 框架（真的挺不错的），另外还有阿里巴巴维护的 JSON 处理库 fastjon 、图标库 ikonli（使用了谷歌的 Material Icons ）。 音乐接口部分还写了一点点 JUnit 的单元测试。

打包使用JDK自带的jpackage，并尝试了一下 GitHub Action ，还真挺爽的，写了一个脚本，可以自动拉取代码和字体文件（因为字体文件太大就没有放到仓库里），并一次性完成多平台的打包。