本文及资源最后更新时间 2020-10-04 by sky995

洛雪音乐助手桌面版

lx-music-desktop 一个基于electron的音乐软件

洛雪音乐助手桌面版

说明

一个基于 Electron + Vue 开发的音乐软件。

所用技术栈：

• Electron 10
• Vue 2

已支持的平台：

• Windows 7 及以上
• Mac OS
• Linux

软件变化请查看：更新日志
软件下载请转到：发布页面
或者到网盘下载（网盘内有MAC、windows版）：https://www.lanzoux.com/b0bf2cfa/ 密码：glqw
使用常见问题请转至：常见问题

源码使用方法

环境要求：Node.js 12.x+

# 开发模式
npm run dev

# 构建免安装版
npm run pack:dir

# 构建安装包（Windows版）
npm run pack

# 构建安装包（Mac版）
npm run pack:mac

# 构建安装包（Linux版）
npm run pack:linux

UI界面

启动参数

目前软件已支持的启动参数如下：

• -search 启动软件时自动在搜索框搜索指定的内容，例如：-search="突然的自我 - 伍佰"
• -nt 以非透明模式启动，对于未开启AERO效果的win7系统可加此参数启动以确保界面正常显示

常见问题

常见问题已移至：https://github.com/lyswhut/lx-music-desktop/blob/master/FAQ.md

项目协议

本项目基于 Apache License 2.0 许可证发行，以下协议是对于 Apache License 2.0 的补充，如有冲突，以以下协议为准。

词语约定：本协议中的“本项目”指洛雪音乐桌面版项目；“使用者”指签署本协议的使用者；“官方音乐平台”指对本项目内置的包括酷我、酷狗、咪咕等音乐源的官方平台统称；“版权数据”指包括但不限于图像、音频、名字等在内的他人拥有所属版权的数据。

1. 本项目的数据来源原理是从各官方音乐平台的公开服务器中拉取数据，经过对数据简单地筛选与合并后进行展示，因此本项目不对数据的准确性负责。
2. 使用本项目的过程中可能会产生版权数据，对于这些版权数据，本项目不拥有它们的所有权，为了避免造成侵权，使用者务必在24小时内清除使用本项目的过程中所产生的版权数据。
3. 本项目内的官方音乐平台别名为本项目内对官方音乐平台的一个称呼，不包含恶意，如果官方音乐平台觉得不妥，可联系本项目更改或移除。
4. 本项目内使用的部分包括但不限于字体、图片等资源来源于互联网，如果出现侵权可联系本项目移除。
5. 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害（包括但不限于因商誉损失、停工、计算机故障或故障引起的损害赔偿，或任何及所有其他商业损害或损失）由使用者负责。
6. 本项目完全免费，且开源发布于 GitHub 面向全世界人用作对技术的学习交流，本项目不对项目内的技术可能存在违反当地法律法规的行为作保证，禁止在违反当地法律法规的情况下使用本项目，对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担，本项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。

若你使用了本项目，将代表你接收以上协议。

音乐平台不易，请尊重版权，支持正版。
若对此有疑问请 mail to: lyswhut+qq.com (请将+替换成@)

lx-music-desktop 常见问题

在阅读本常见问题后，仍然无法解决你的问题，请提交issue或者加企鹅群830125506反馈（无事勿加，入群先看群公告），反馈时请注明已阅读常见问题！

软件为什么没有桌面歌词与自定义列表功能

洛雪音乐的最初定位不是作为播放器开发的，它主要用于查找歌曲，软件的播放功能仅用于试听，不建议用作为常用播放器使用。

歌曲无法试听与下载

该问题解决顺序如下：

1. 尝试更新到最新版本
2. 尝试切换其他歌曲（或直接搜索该歌曲），若全部歌曲都无法试听与下载则进行下一步
3. 尝试到 设置-音乐来源 切换到其他接口
4. 尝试切换网络，比如用手机开热点（目前存在某些网络无法访问接口服务器的情况）
5. 若还不行请到这个链接查看详情：https://github.com/lyswhut/lx-music-desktop/issues/5
6. 若没有在第5条链接中的第一条评论中看到接口无法使用的说明，则应该是你网络无法访问接口服务器的问题，如果接口有问题我会在那里说明。

想要知道是不是自己网络的问题可以看看http://ts.tempmusic.tk能不能在浏览器打开，浏览器显示404是正常的，如果不是404那就证明所在网络无法访问接口服务器。 若网页无法打开或打来不是404，则应该是DNS的问题，可以尝试以下办法：

1. 将DNS改成自动获取试试
2. 手动把DNS改一下，不要用360的DNS，可以把DNS改成114.114.114.114、8.8.8.8

列表多选

从v0.18.0起，列表多选需要键盘配合，想要多选前需按下Shift或Ctrl键然后再鼠标点击想要选中的内容即可触发多选机制，其中Shift键用于连续选择，Ctrl键用于不连续选择，Ctrl+a用于快速全选。

• 例子一：想要选中1-5项，则先按下Shift键后，鼠标点击第一项，再点击第五项即可完成选择；
• 例子二：想要选中1项与第3项，则先按下Ctrl键后，鼠标点击第一项，再点击第三项即可完成选择；
• 例子三：想要选中当前列表的全部内容，键盘先按下Ctrl键不放，然后按a键，即可完成选择。

用Shift或Ctrl选择时，鼠标点击未选中的内容会将其选中，点击已选择的内容会将其取消选择，若想全部取消选择，在不按Shift或Alt键的情况下，随意点击列表里的一项内容即可全部取消选择。(P.S：Ctrl键对应Mac OS上的Command键)

播放整个歌单或排行榜

播放在线列表内的歌曲需要将它们都添加到我的列表才能播放，你可以全选列表内的歌曲然后添加到现有列表或者新创建的列表，然后去播放该列表内的歌曲。

桌面歌词显示异常

Windows 7 系统桌面歌词显示异常

Windows 7 未开启 Aero 效果时桌面歌词会有问题，详情看下面的**Windows 7 下界面异常（界面显示不完整）**方法解决。

MAC OS 系统、桌面歌词有残留阴影

此问题似乎是Electron的Bug，翻阅electron的issue列表发现该Bug以存在很久了，遗憾的是没有一直都没有修复，由于我没有装MAC平台的电脑，没法重现，就没再去electron提issue，更多信息看：

• https://github.com/electron/electron/issues/21173
• https://github.com/electron/electron/issues/14304

Linux 系统下桌面歌词窗口异常

目前在 Ubuntu 18.10 下第一次开启桌面歌词时歌词窗口会变白，需要关闭后再开启，

其他 Linux 系统未测试，如有异常也是意料之中，目前不打算去处理 Linux 平台的桌面歌词问题。

软件安装包说明

软件发布页及网盘中有多个类型的安装文件，以下是对这些类型文件的说明：

文件名带 win_ 的是在Windows系统上运行的版本，
其中安装版（Setup）可自动更新软件，
绿色版（green）为免安装版，自动更新功能不可用；

以 .dmg 结尾的文件为 MAC 版本；

以 .AppImage、.deb 结尾的为 Linux 版本。

带有x64的为64位的系统版本，带x86的为32位的系统版本；若两个都带有的则为集合版，安装时会自动根据系统位数选择对应的版本安装。

软件更新

软件启动时若发现新版本时会自动从本仓库下载安装包，下载完毕会弹窗提示更新。
若下载未完成时软件被关闭，下次启动软件会再次自动下载。
若还是更新失败，可能是无法访问GitHub导致的，这时需要手动更新，即下载最新安装包直接覆盖安装即可。
注意：绿色版的软件自动更新功能不可用，建议使用安装版！！
注意：Mac版、Linux deb版不支持自动更新！

Windows 7 下界面异常（界面显示不完整）

由于软件默认使用了透明窗口，根据Electron官方文档的说明：

在 windows 操作系统上, 当 DWM 被禁用时, 透明窗口将无法工作。

因此，当 win7 没有使用AERO主题时界面将会显示异常，开启AERO的方法请自行百度：win7开启aero效果（开启后可看到任务栏变透明）。
从0.14.0版本起不再强制要求开启透明效果，若你实在不想开启（若非电脑配置太低，墙裂建议开启！），可通过添加运行参数-nt来运行程序即可，例如：.\lx-music-desktop.exe -nt，添加方法可自行百度“给快捷方式加参数”，该参数的作用是用来控制程序是否使用非透明窗口运行。

对于一些完全无法正常显示界面的情况，请阅读下面的 软件启动后，界面无法显示

软件启动后，界面无法显示

软件启动后，可以在任务栏看到软件，但软件界面在桌面上无任何显示。
原始问题看：https://github.com/electron/electron/issues/19569#issuecomment-522231083
解决办法：下载.NET Framework 4.7.1或更高版本安装即可(建议安装最新版，若安装过程中遇到问题可尝试自行百度解决)。
微软官方下载地址：https://dotnet.microsoft.com/download/dotnet-framework
下载Runtime(运行时)版即可，安装完成后可能需要重启才生效。

若还是不行可尝试以下操作：

• 更新显卡驱动
• 尝试将绿色版的软件放在桌面或我的文档运行

安装版安装失败，提示安装程序并未成功地运行完成

对于部分电脑出现安装失败的问题，可以做出以下尝试：

• 若你之前可以安装成功，但现在安装失败，就去控制面板-程序和功能或用第三方卸载工具看下有没有之前的版本残留，若同时在不同路径下安装了多个版本就可能会出现该问题，这种情况卸载掉所有版本重新安装即可
• 清理安装路径下的残留文件
• 清理注册表（建议用清理工具清理）

缺少xxx.dll

这个是电脑缺少某些dll导致的，正常的系统是没有这个问题的，可以尝试如下几个解决办法：

• 以管理员权限打开cmd，输入sfc /scannow回车等待检查完成重启电脑
• 若上面的方法修复、重启电脑后仍然不行，就自行百度弹出的错误信息看下别人是怎么解决的

杀毒软件提示有病毒或恶意行为

本人只能保证我写的代码不包含任何恶意代码、收集用户信息的行为，并且软件代码已开源，请自行查阅，软件安装包也是由CI拉取源代码构建，构建日志：windows包、Mac/Linux包
尽管如此，但这不意味着软件是100%安全的，由于软件使用了第三方依赖，当这些依赖存在恶意行为时（供应链攻击），软件也将会受到牵连，所以我只能尽量选择使用较多人用、信任度较高的依赖。
当然，以上说明建立的前提是在你所用的安装包是从本项目主页上写的链接下载的，或者有相关能力者还可以下载源代码自己构建安装包。

从0.17.0起，由于加入了音频输出设备切换功能，该功能调用了 MediaDevices.enumerateDevices()，可能导致安全软件提示洛雪要访问摄像头（目前发现卡巴斯基会提示），但实际上没有用到摄像头，并且摄像头的提示灯也不会亮，你可以选择阻止访问。

最后，若出现杀毒软件报毒、存在恶意行为，请自行判断选择是否继续使用本软件！

软件无法联网

软件的排行榜、歌单、搜索列表都无法加载：

• 检查是否在设置界面开启了代理（当代理乱设置时软件将无法联网）
• 检查软件是否被第三方软件/防火墙阻止联网

无法打开外部歌单

对于分享出来的歌单，若打开失败，可尝试先在浏览器中打开后，再从浏览器地址栏复制URL地址到软件打开；
或者如果你知道歌单 id 也可以直接输入歌单 id 打开。