Also available in English. Click HERE to see document of English version
★ netPlayer Next | netPlayer | netPlayer Mobile
Note
这是netPlayer的Flutter版本，本仓库发布的netPlayer版本从2.0.0开始
Warning
这个版本的netPlayer不兼容Windows 7系统，如果你要查找支持Windows 7版本的netPlayer，转至netPlayer查找v1版本的netPlayer
桌面歌词组件在这里
| v1 | v2 | v3 | |
|---|---|---|---|
| 支持Windows版本 | Windows7~ | Windows10~ | Windows10~ |
| 框架 | Electron | Flutter | Flutter |
| 支持macOS | ✅ | ✅ | ✅* |
| 单曲循环 | ❌ | ✅ | ✅ |
| 定位歌曲 | ❌ | ✅ | ✅ |
| 全局快捷键 | 仅macOS | ✅ | ✅ |
| WebSocket服务 | ❌ | ❌ | ✅ |
| 多语言支持 | ❌ | ❌ | ✅** |
* 由于本人换电脑，macOS没法打包，如果你有需要可以在自己的设备上打包v3版本(所以也不清楚macOS版本的运行情况，欢迎给予反馈!)
** 多语言从v3.2.0 版本开始支持多语言，你点击这里查看详细的语言支持
Note
受限于Subsonic API，“所有歌曲”和“专辑”只能显示500首/张（随机的500首歌曲排序展示）
Tip
在所有歌曲页面歌曲数量的右侧有完全随机播放按钮，这个功能不受歌曲数量限制
这是一个基于Subsonic (Navidrome) API的一个桌面端App，你可以点击这里查看如果使用Navidrome (推荐) 搭建一个音乐服务器。
在使用前务必确保运行netPlayer的设备可以通过网络连接到你的音乐服务器
空格：播放/暂停command →(macOS)或Ctrl →(Windows)：下一首command ←(macOS)或Ctrl ←(Windows)：上一首command L(macOS)或Ctrl L(Windows)：显示/隐藏歌词
- ⏯️(macOS & Windows)或
Ctrl Alt 空格(Windows)：播放/暂停 - ⏩(macOS & Windows)或
Ctrl Alt →(Windows)：下一首 - ⏪(macOS & Windows)或
Ctrl Alt ←(Windows)：上一首
Note
歌词组件的代码在这里，你可以在Release页中下载没有这个功能的版本，桌面歌词的开关在设置-启用歌词组件，打开这个功能需要启用ws服务
- 简体中文
- 繁体中文 (由ChatGPT翻译)
- 英语
你可以通过pull&request添加你所需要的语言。语言目录位于lib/lang
如果有一些翻译不那么准确，你可以添加一个Issue
Note
这个功能至少需要v3.0.0版本，下面的接口适用的版本为v3.3.0或更新的版本，如果你想要查看过去版本的接口，你可以查找以往版本Tag的README文档
{
"title": <标题>,
"artist": <艺人>,
"lyric": <当前歌词>,
"cover": <专辑封面链接>,
"fullLyric": <完整歌词>,
"line": <当前歌词进行到多少行>,
"isPlay": <是否正在播放>,
"mode": <播放模式>,
}详细的见lib/views/functions/ws.dart内容
{
"command": <操作>
"data": <数据>
}WebSocket服务器默认地址为: localhost:9098
这个功能可以二次开发，用于直播背景音乐信息显示，详细步骤如下：
- 设计一个Web页面用于直播（边框）
- 在你觉得合适的地方设计一个背景音乐信息显示，内容为WebSocket服务获取的信息
你需要先检查你的客户端设备是否可以直接打开音乐库网页，很大概率是服务器防火墙或者设置问题
另外务必检查地址，http和https
Subsonic音乐库的API并不支持查看所有的歌曲，因此至多只能显示500首歌曲 但是你可以通过完全随机播放来随机播放所有的歌曲，不受歌曲数量显示，v2版本在左边栏，v3版本在所有歌曲页标题右侧
可能老版本的netPlayer Next和新版本冲突
解决办法为删除这两个目录:
C:\Users<你的用户名>\AppData\Roaming\zhouc\net_player_next
C:\Users<你的用户名>\AppData\Roaming\zhouc\netPlayer
歌词API见文末，没有找到歌词就是字面意思
歌词的内容取决于歌曲标题、所属专辑、艺人和歌曲长度
- spotify-downloader用于下载歌曲，通过这种方式下载的歌曲一般会包含一些信息
- Live-BG用于直播的配合netPlayer显示当前播放歌曲信息和歌词的背景
- netPlayer-mini-kit桌面歌词系统
本项目使用Flutter 3.24开发，你可以直接使用这个版本的Flutter在你的设备上Debug
建议直接使用Visual Studio Code，在安装完Flutter扩展和Dart扩展之后就可以Debug/Profile/Release了，我已经在.vscode文件夹中添加了launch类型
Warning
不要使用Flutter3.7或更低版本的Flutter，确保Dart版本至少有3.0.0
如果你在Windows上Debug或者Release，注意不要在国内的网络环境下操作，可能会等非常长的时间，Mac上没有这个问题
在Windows上的打包：
flutter build windows在macOS上打包：
flutter build macos你需要前往netPlayer-mini-kit页面中以同样的方法打包，放置到<程序路径>/lyric下即可
- 添加窗口缩放自动滚动歌词的功能
- 改进ws服务端口输入框
- 改进一处翻译
过去的版本
- 修复歌词重复请求的问题
- 更新了桌面歌词组件(更新内容: v0.1.1)
- 添加许可证页
- 修复歌词最后一行无法高亮的问题
- 修复部分歌词缺少最后一行的问题
- 改进歌词匹配逻辑
- 改进歌词匹配逻辑
- 修复重启后音量显示与实际音量不符的问题 (#3)
- 添加调整歌词字号的功能
- 添加ws服务控制播放的功能
- 添加桌面歌词组件
- 修复停止播放时候播放状态错误的问题
- 修复一些没有销毁的监听器
- 添加重命名hint
- 添加自动识别语言
- 添加从歌词页获取艺人/专辑信息
- 修复ws服务关闭异常的问题
- 添加从网易云音乐获取歌词
- 修复歌单名称过长的显示问题
- 修复获取歌词可能出现崩溃的问题
- 修复翻译缺失
- 修复进度条闪烁的问题
- 提高了一些性能
- 改进一些英文翻译
- 修复一个弹窗问题
- 修复注销出错的问题
- 添加多语言支持
- 修复一些提示的错误文本
- 改进一些动画
- 解决Windows下图标模糊的问题
- 添加刷新音乐库的功能
- 添加一些鼠标移动到图标的提示
- 添加歌曲超出API范围的提示
- 添加本地化支持
- 修复当没有喜欢的歌曲时加载错误
- 添加了可以自定义ws服务端口的功能
- 添加了ws服务端口冲突的提示
- 解决了在连接服务器失败卡住的问题
- 解决了ws服务端口冲突崩溃的问题
- 解决错误的用户名或者密码登录崩溃的问题
- 添加从歌曲跳转到艺人和专辑的菜单
- 添加了Windows的音频控制模块，现在你可以使用Windows上的音频控制了
原有的全局快捷键也可以一样使用
- 修复在输入框输入空格触发快捷键的问题
- 隐藏了一些无效按钮
- 搜索框自动清空结果
- 重构了整个软件，现在看起来更加美观
- 大幅提高了运行效率
- 添加了ws服务功能
- 添加了音量调节功能
- 添加了歌曲界面艺人显示
- 现在搜索不区分大小写了
- 改进了搜索逻辑
- 修复软件信息在Windows下的显示问题
- 修复歌单为0时添加歌单崩溃的问题
- 修复歌单发生变化时的定位问题
- 添加全局快捷键
- 添加是否添加全局快捷键的开关
- 添加显示/隐藏歌词的快捷键
- 添加Windows上切换歌曲的快捷键
- 修复macOS系统上点击菜单无效的问题
- 添加了托盘功能和Windows上的关闭隐藏窗口的功能
- 修复没有登录时歌曲操作的问题
- 添加清理封面图片缓存的功能(macOS系统)
- 添加在Windows上Debug的配置开发条件
现在可以复制一些文本- 修复没有进入歌词第一句时的滚动状态问题
- 修复无法在文本框输入空格的问题
- 本地化一些系统控件语言
- 修复歌词滚动问题
- 修复macOS语言问题
- 修复macOS从菜单切换页面的问题
- 统一Windows和macOS一些组件
- 修复运行在Windows系统上稳定性的问题
- 修复进度条崩溃的问题
- 提高了程序运行效率
- 恢复全局搜索功能
- 恢复检查更新功能
- 恢复歌词显示功能
- 修复窗口没有聚焦的问题
- 修复播放栏信息显示问题
- 修复播放栏封面图片圆角问题
- 修复定位图标是否可用没有区分的问题
- 修复Windows上窗口按钮图标错误的问题
- 使用Flutter重构了整个项目
- 添加单曲循环播放模式
- 添加记住播放模式功能
- 添加了歌曲项中右键菜单
- 改进歌曲显示的布局
- 改进滚动到播放歌曲
- 🚫全局搜索功能暂时无法使用
- 🚫检查更新功能暂时无法使用
- 🚫Windows版隐藏到状态栏暂时无法使用
- 🚫歌词功能暂时无法使用
网易云音乐