洛雪音乐（LX‑Music）是开源、无广告、跨平台音乐播放器，本体不存储音乐资源，依靠第三方音源脚本实现多平台歌曲搜索播放。

一、基础信息

• 开发技术：Electron + Vue3GitHub

• 支持系统：Windows7 及以上、macOS、Linux、Android；无 iOS 官方版本

• 开源协议：Apache‑2.0，源码托管于 GitHub，官方只在 GitHub 发布安装包，其他网盘、网站都属于第三方转发GitHub

• 核心定位：播放器外壳，本身不带任何曲库，播放能力完全依赖导入的音源脚本（.js）

• ⚠️重要：原版软件安装完默认搜不到歌，必须手动导入第三方音源才能使用搜索播放功能。

二、核心功能

1. 聚合搜索 导入音源后可同时调取多家音乐平台曲库，一个软件搜索多平台歌曲，不用来回切换 App。支持选择不同音质：标准、高清、无损 FLAC。

2. 歌单迁移与管理

• 粘贴网易云、QQ 音乐公开歌单链接一键导入歌单；

• 本地歌单导出备份；支持本地缓存；

• 可自建私有同步服务，实现多设备歌单同步（需要自己部署服务端）GitHub。

3. 播放体验

• 桌面悬浮歌词，字体、颜色、透明度全部自定义；

• 10 段均衡器 DSP 音效，自带流行、摇滚、重低音预设；

• 睡眠定时关闭、全局快捷键、多种播放模式；

• 主题配色、深色 / 浅色模式自定义。

4. 本地音乐库 可以导入电脑本地音频文件，统一管理本地歌曲、匹配歌词封面。

5. 下载功能 软件本体有下载开关，下载能力由音源决定，部分音源支持批量下载无损；安卓原版不支持下载，第三方修改版才提供下载功能lxmusic.cc。

三、关键概念：音源

音源是.js脚本文件，相当于插件，告诉软件去哪里抓取歌曲接口。

• 两种导入方式：①本地导入 js 文件；②在线导入音源链接

• 音源是社区网友维护，没有永久稳定的音源，会因为音乐平台接口变动随时失效，经常出现 “昨天能用今天搜不到歌”，建议同时导入 2‑3 个音源互为备用。

• 风险点：不要导入来路不明的陌生音源脚本，恶意 js 脚本可能带来安全隐患，尽量选用社区公开仓库的音源。

四、优缺点

优点

1. 完全无广告，无会员付费入口，软件本体纯净；

2. 跨平台，Windows 老系统 Win7 也支持；

3. 强大歌词、均衡器、快捷键、歌单导入导出；

4. 开源可审计，没有内置数据收集。

缺点

1. 音源完全依赖第三方，稳定性不可控，随时失效，需要定期更换更新音源；

2. 上手有门槛，新手需要自己找、导入音源；

3. 不提供官方云端同步，多端同步需要自己搭建服务；

4. 没有官方推荐音源，所有音源均为社区第三方，与原项目无关。

五、常见问题

1. 安装完搜不到歌：没有导入音源，设置‑自定义源导入 js 音源链接或本地文件。

2. 部分歌曲灰色无法播放：该音源没有拿到这首歌的播放资源，切换别的音源尝试。

3. 突然全部搜不到歌：音源接口失效，更换更新版本音源。

4. 下载按钮灰色：设置打开下载开关；部分音源不支持下载，安卓原版无下载功能。

六、版权与安全提醒

1. 洛雪音乐本体只是播放器，音源解析第三方平台资源仅用于个人技术测试学习；试听、下载音乐请尊重版权，禁止商用传播，建议支持正版音乐服务。

2. 只从 GitHub Releases 下载软件本体，不要网上随便下载所谓 “豪华版、内置音源版”，第三方修改包有可能植入恶意代码。

3. 第三方音源脚本不属于官方项目，使用音源产生的风险由使用者自行承担。

七、官方项目地址

• 桌面版链接：github.com/lyswhut/lx‑music‑desktop

• 安卓移动版链接：github.com/lyswhut/lx‑music‑mobile

• 提示：网上流传的各种 “内置音源打包版” 不是官方发布。