基于 Electron + Python(Flask) + Vue 3 混合架构的原神主题音乐播放器。 本地音乐库 + 自定义源在线播放、桌面歌词卡拉OK、迷你播放器与三大地区主题换肤, 本地与在线共用同一套播放内核。
本地音乐库与自定义源在线播放共用同一套播放内核,覆盖日常听歌的每一个场景。
选择目录扫描音乐,扫描到的文件自动归档到软件根目录的 music,数据库与数据统一随软件目录存放。
基于 HTTP Range 分段流式播放,支持拖动进度条,本地大文件也能即时响应。
兼容洛雪音乐自定义源脚本(.js),在 Node vm 沙箱中运行;应用不内置任何源,由你自行导入。
内置 tx / kg / wy / kw 四平台适配器,只搜「有启用源支持」的平台,避免搜到却播不了。
flac24bit → flac → 320k → 128k 逐级降档,同一音质内多源自动换源,全部失败给出聚合原因。
四平台歌词接口,酷狗 KRC 解密后可显示逐字卡拉OK;翻译行自动合并为双语,三处界面统一生效。
Electron 透明窗口 HTML 渲染,当前句逐字高亮,颜色、字号、字体皆可自定义,双击歌词切播放暂停。
一键切换置顶小窗,封面 / 标题 / 进度齐备,可遥控播放,打开即自动隐藏主窗口。
蒙德、璃月、稻妻三套主题,景区地标图标,无限循环切换,主色自动联动。
听过的在线歌曲缓存到 cache/,重播秒开、拖动进度条也走本地;LRU 淘汰,容量上限可配。
基于 Web Audio API 的 10 段图形均衡器 + 8 档预设,支持 0.25x–3x 播放倍速。
启动后静默查询 GitHub Release,有新版本才提示,点「前往下载」跳浏览器;也可忽略某个版本。
Electron 主进程负责窗口与桌面能力,Python Flask 提供媒体与在线代理服务,Vue 3 驱动界面,三层各司其职。
Flask(threaded=True)提供 API / 音频流 / 音乐库 / 元数据解析 / 数据库 / 同源在线代理,由 Electron 主进程 spawn,运行于 127.0.0.1:5000。
主窗口、系统托盘、单实例锁、透明桌面歌词与迷你小窗;preload 兼容层接管 window.pywebview.api.* 语义,前端零改动接入。
Hash 路由 + Pinia 状态管理,前端经 vite build 产出后由 Flask 托管;页面遵循 script-src 'self' CSP,不含内联脚本。
扫描本地目录自动建立音乐库,流式分段让任意大文件即时开播;元数据解析采样率 / 码率 / 声道, 专辑封面统一缓存展示。在线歌曲与本地歌曲共用同一套播放内核 —— 队列、播放模式、桌面歌词、 迷你小窗、睡眠定时与音效都无需区分。
收藏 / 歌单 / 最近播放,三大入口一屏管理,多歌单卡片式浏览;支持按歌名 / 艺术家 / 专辑实时筛选。
自定义字体与歌词字号,支持上传 .ttf / .otf / .woff / .woff2 持久化复用;中英界面一键切换。
可选启动恢复上次播放队列与进度;全局快捷键与托盘常驻,兼顾效率与沉浸。
安装版与免安装版两种分发,两者数据完全通用,整个软件目录可整体搬移。
安装版(exe):常规安装,可自定义安装目录;卸载走「设置 → 应用 → 已安装的应用」里的「提瓦特旋律」。升级时安装器会保留 data/ music/ sources/ cache/,数据不丢。
免安装版(zip):解压即用,自包含可运行;没有卸载程序是正常的 —— 直接删除整个文件夹即可。
数据与迁移:数据一律放在软件目录(跟 EXE 同级)。把旧目录的 data/、music/、.appdata/、sources/ 复制到新目录,音乐库、歌单、设置与自定义源都会保留。
提醒:安装包未做代码签名,Windows SmartScreen 可能拦截,点「更多信息 → 仍要运行」即可。