timeshiftsauce /CeruMusic
Ceru Music 是基于 Electron 和 Vue 开发的跨平台桌面音乐播放器工具,借鉴洛雪音乐插件思想,提供插件运行框架与播放功能,不直接存储、提供任何音乐源文件。用户需通过自行选择、安装合规插件获取音乐相关数据,项目旨在为开发者提供桌面应用技术实践与学习案例,为用户提供合规的音乐播放工具框架。
★ 2,064⑂ 113👁 8⑃ 23● 115▤ 93
+3
Daily
2,064
stars
113
forks
8
watchers
23
prs
115
issues
93
releases
README
Ceru Music(澜音)
一个跨平台的音乐播放器应用,支持基于合规插件获取公开音乐信息与播放功能。
项目简介
Ceru Music 是基于 Electron 和 Vue 开发的跨平台桌面音乐播放器工具,仅提供插件运行框架与播放功能,不直接存储、提供任何音乐源文件。用户需通过自行选择、安装合规插件获取音乐相关数据,项目旨在为开发者提供桌面应用技术实践与学习案例,为用户提供合规的音乐播放工具框架。
!image-20251003173654569
Star History
技术栈
- Electron:用于构建跨平台桌面应用
- Vue 3:前端框架,提供响应式 UI
- TypeScript:增强代码可维护性和类型安全
- Pinia:状态管理工具
- Vite:快速的前端构建工具
- CeruPlugins:音乐插件运行环境(仅提供框架,不包含默认插件)
项目结构
点击查看目录结构
ast
CeruMuisc/
├── .github/
├── scripts/
├── src/
│ ├── common/
│ │ ├── types/
│ │ │ ├── playList.ts
│ │ │ └── songList.ts
│ │ ├── utils/
│ │ │ ├── lyricUtils/
│ │ │ │ ├── kg.js
│ │ │ │ └── util.ts
│ │ │ ├── common.ts
│ │ │ ├── nodejs.ts
│ │ │ └── renderer.ts
│ │ └── index.ts
│ ├── main/
│ │ ├── events/
│ │ │ ├── ai.ts
│ │ │ ├── autoUpdate.ts
│ │ │ ├── directorySettings.ts
│ │ │ ├── musicCache.ts
│ │ │ ├── pluginNotice.ts
│ │ │ └── songList.ts
│ │ ├── services/
│ │ │ ├── music/
│ │ │ │ ├── index.ts
│ │ │ │ ├── net-ease-service.ts
│ │ │ │ └── service-base.ts
│ │ │ ├── musicCache/
│ │ │ │ └── index.ts
│ │ │ ├── musicSdk/
│ │ │ │ ├── index.ts
│ │ │ │ ├── service.ts
│ │ │ │ └── type.ts
│ │ │ ├── plugin/
│ │ │ │ ├── manager/
│ │ │ │ │ ├── CeruMusicPluginHost.ts
│ │ │ │ │ └── converter-event-driven.ts
│ │ │ │ ├── index.ts
│ │ │ │ └── logger.ts
│ │ │ ├── songList/
│ │ │ │ ├── ManageSongList.ts
│ │ │ │ └── PlayListSongs.ts
│ │ │ ├── ai-service.ts
│ │ │ └── ConfigManager.ts
│ │ ├── utils/
│ │ │ ├── musicSdk/
│ │ │ │ ├── api-source-info.ts
│ │ │ │ ├── index.js
│ │ │ │ ├── options.js
│ │ │ │ └── utils.js
│ │ │ ├── array.ts
│ │ │ ├── index.ts
│ │ │ ├── object.ts
│ │ │ ├── path.ts
│ │ │ ├── request.js
│ │ │ └── utils.ts
│ │ ├── autoUpdate.ts
│ │ └── index.ts
│ ├── preload/
│ │ ├── index.d.ts
│ │ └── index.ts
│ ├── renderer/
│ │ ├── public/
│ │ │ ├── default-cover.png
│ │ │ ├── head.jpg
│ │ │ ├── logo.svg
│ │ │ └── wldss.png
│ │ ├── src/
│ │ │ ├── api/
│ │ │ │ └── songList.ts
│ │ │ ├── components/
│ │ │ │ ├── AI/
│ │ │ │ │ └── FloatBall.vue
│ │ │ │ ├── ContextMenu/
│ │ │ │ │ ├── composables.ts
│ │ │ │ │ ├── ContextMenu.vue
│ │ │ │ │ ├── demo.vue
│ │ │ │ │ ├── index.ts
│ │ │ │ │ ├── README.md
│ │ │ │ │ ├── types.ts
│ │ │ │ Top issues
#99考虑出一个性能版,目前的内存占用太大了5 comments · 2026-04-27#128正在播放的歌曲或播放列表中的歌曲无法方便的加入歌单4 comments · 2026-06-05#70HarmonyOS PC版可以提供吗1 comments · 2026-03-05#40[功能请求]添加单曲播放选项2 comments · 2026-01-25#135在进度条栏或者歌曲详情页添加加入歌单的按钮1 comments · 2026-06-19#130建议添加多选/全选歌曲的功能1 comments · 2026-06-10#109关于软件在电脑标题栏应该显示歌曲信息而不是软件名字1 comments · 2026-05-19#108关于歌单封面背景鼠标滑过的一个bug1 comments · 2026-05-19
Discussions
#129建議GitHub Assets裡的文件,有一致的命名格式0 comments · 2026-06-06#106下载的问题0 comments · 2026-05-15#83希望。
增加安卓的版本4 comments · 2026-03-28#51提问0 comments · 2026-02-05#32Welcome to CeruMusic Discussions!1 comments · 2026-01-01
Latest release
v2.4.0 v2.4.0 2026-10-21这次更新以「界面与手感」为主线:设置页整体重做(分组导航、本页目录、全局搜索), 播放页新增钛金属流沙背景并重做背景鼓点,Apple 风格歌词换用上游未发布快照后滚动更跟手、更省 CPU, 社区评论区支持贴纸 / Emoji / 颜文字与长文折叠,同时修掉一批下载、搜索与歌词时序问题。 ⚙️ 设置页重做 - 左侧导航重排为 聆听体验 / 内容与扩展 / 应用管理 三组、共 11 个分类,并新增两个独立页面: 「歌词」(歌词字体、桌面歌词、macOS 菜单栏歌词)与 「系统与性能」(窗口关闭行为、页面预加载、 系统媒体控件高清封面)。 - 每个分类顶部新增标题与一句话说明;右上角新增 「本页目录」 下拉,可直接跳到本页任意设置项并高亮目标区块。 - 分类名更直白:外观设置 → 外观与主题、播放设置 → 播放与音效、音乐源 → 音乐源与音质、 存储管理 → 下载与存储、网络设置 → 网络与代理、AI 功能 → AI 助手、关于 → 关于与更新。 - 搜索更准:结果始终显示中文分类名(不再出现英文 key),能搜到「全局背景」「页面预加载」 「系统媒体控件高清封面」「播放画面与动效」「联系方式」等新增或迁移项;窄窗口下下拉不再溢出或被裁切。 - 切换分类会分别记住各自的滚动位置;页内跳转只滚动内容区(顶部留 16px),目标区块显示 2 秒描边高亮, 系统开启「