mirror of
https://github.com/atdunbg/Nekosonic-Music.git
synced 2026-06-21 16:48:48 +08:00
987d34f58b967f6161878359722a68a8b9b2d06f
Nekosonic
一款轻量的跨平台音乐播放器,支持 Windows / Linux / macOS,音源源自网易云音乐。
✨ 特性
播放
- 🎵 在线音乐播放,流式缓冲边下边播
- 🎵 多音质选择(标准 / 较高 / 极高 HQ / 无损 SQ / Hi-Res)
- 🔄 播放模式切换(列表循环 / 随机播放 / 单曲循环)
- ⏯ 播放控制(播放 / 暂停 / 上一首 / 下一首 / 进度跳转 / 音量调节)
- 📋 播放队列管理(查看队列 / 移除歌曲 / 清空队列)
- 📻 私人漫游 FM(个性化推荐,VIP 试听自动跳过)
- 🎵 本地音乐播放(支持 mp3 / flac / wav / ogg / aac / m4a / wma / opus)
- 🔊 音频输出设备选择
发现与浏览
- 🔍 关键词搜索歌曲 + 热门搜索标签
- 📋 歌单浏览(推荐歌单 / 排行榜 / 用户歌单 / 收藏歌单)
- 📋 歌单详情(歌曲列表 + 收藏 / 取消收藏 + 歌单评论)
- 🎤 歌手详情(热门歌曲 / 专辑 / 简介)
- 💿 专辑详情(歌曲列表 + 播放全部)
- 📅 每日推荐歌曲
歌词与评论
- 🎤 实时滚动歌词(自动滚动 / 点击跳转 / 渐变透明度)
- 🎤 全屏漫游模式(大封面 + 歌词 / 评论双标签页)
- 💬 歌曲评论查看(热门评论 + 无限滚动加载 + 点赞)
收藏与下载
- ❤️ 一键喜欢 / 取消喜欢(同步到网易云账号)
- ⬇️ 歌曲下载(带进度显示 / VIP 拦截 / 元数据保存)
- 🎵 本地音乐管理(列出 / 播放 / 删除 / 音频元数据与封面读取)
- 🕐 本地播放历史记录(最多 200 首)
账号
- 🔴 网易云账号登录(二维码扫码 / 手机号密码)
- 🔑 登录态持久化(重启后自动恢复)
系统与设置
- 📡 系统托盘(播放控制 / 显示窗口 / 退出)
- 🛡 单实例运行(防止重复启动)
- ⌨️ 自定义快捷键(应用内 + 系统全局)
- 🌚 Light / Dark Mode 主题切换
- ⚙️ 关闭窗口行为设置(每次询问 / 最小化到托盘 / 直接退出)
- 🔄 自动更新(启动静默检测 + 自定义弹窗 + 忽略版本 + 下载进度)
- 📝 更新日志查看
📦️ 安装
访问本项目的 Releases 页面下载安装包。
💻 配置开发环境
# 安装前端依赖
npm install
# 启动开发服务器
npm run tauri dev
# 构建发布
npm run tauri build
环境要求
- Node.js >= 18
- Rust >= 1.70
- Tauri CLI 2
🛠 技术栈
| 层级 | 技术 |
|---|---|
| 桌面框架 | Tauri 2 |
| 前端 | Vue 3 + TypeScript |
| 样式 | Tailwind CSS v4 + CSS 变量主题系统 |
| 状态管理 | Pinia |
| 路由 | Vue Router 4 |
| 音频播放 | rodio (Rust) |
| 网易云 API | ncm-api-rs |
| 构建工具 | Vite 6 |
☑️ Todo
- 评论系统
- 歌曲下载
- 本地音乐管理
- 歌手详情页
- 专辑详情页
- 自定义全局快捷键
- 自动更新
- MV 播放
- 音乐云盘
- 歌词翻译
- 更多主题
- 桌面歌词
欢迎提 Issue 和 Pull request。
📜 开源许可
本项目仅供个人学习研究使用,禁止用于商业及非法用途。
基于 MIT license 许可进行开源。
致谢
- ncm-api-rs — 网易云音乐 API 的 Rust 封装
- Tauri — 跨平台桌面应用框架
- Vue.js — 渐进式 JavaScript 框架
- Tailwind CSS — 实用优先的 CSS 框架
- rodio — Rust 音频播放库
Description
Languages
Vue
55.5%
Rust
26.5%
TypeScript
17%
CSS
0.9%