{{ lrcxResult }}{{ i18n.pages.playlistPage.description }} {{ desc }}
{{ i18n.pages.fileMaintenance.kicker }}
{{record.summaryText}}
{{emptyText}}
{{record.summaryText}}
{{ i18n.pages.fileMaintenance.noCandidates }}
使用指南
MiuPlayer Box 选择网页路线，不做二进制分发，尽量跟随浏览器新特性来实现本地音乐播放、歌词展示和数据管理。下面是关键能力、限制和常见配置说明。
浏览器对文件访问、缓存、PWA、媒体控制和画中画的支持已经足够承担一部分桌面音乐播放器场景。相比传统桌面软件，网页播放器更轻、更容易更新，也更容易控制权限边界。
文件和目录访问由浏览器授权，风险操作需要用户明确确认。
无需安装完整桌面程序，可离线使用，也方便保留或回退版本。
面向万级曲库做渲染优化，避免为播放器额外启动一个完整浏览器壳。
尊重磁盘结构，不做多余缓存；歌单数据可导入、导出和备份。
网页平台仍有边界。例如系统级快捷键、直接打开文件资源管理器等能力会受到浏览器限制。MiuPlayer Box 会尽量提供替代方案。
| 限制 | 补救 | 权衡 |
|---|---|---|
| 无法注册系统级快捷键 | 播放器内快捷键与系统媒体控制 | 不会抢占其他应用快捷键。 |
| 网页不能直接打开文件资源管理器 | 安装 pwa-enhancer.exe 后使用自定义协议 | 该能力需要用户主动安装并授权。 |
| 没有桌面歌词 | 歌词小窗播放器可以部分替代 | 浏览器目前不会支持透明顶层窗口这种危险API这个网页做不了≧ ﹏ ≦ |
pwa-enhancer想确认浏览器能力是否完整？
请打开 兼容性检测 页面查看结果。
支持 .lrc 和 .lrcx 歌词文件，并会在需要时回退到内嵌歌词。
MiuPlayer Box 提供两类 Picture-in-Picture 播放器：迷你控制器和歌词播放器。
该功能允许网页应用通过自定义协议打开系统文件资源管理器。
pwa-enhancer.exepwa-enhancer.exepwa-enhancer，并放在固定目录。pwa-enhancer.exe --install。pwa-enhancer.exe 会注册 explorerlink: 协议，使网页应用可以发起受控的资源管理器打开请求。卸载可运行 pwa-enhancer.exe --uninstall。你可以把 MiuPlayer Box 安装为独立窗口运行的 PWA。
Chromium 内核浏览器，版本高于 110。
Guide
MiuPlayer Box takes the web app route instead of binary distribution. It follows modern browser features to provide local playback, lyric display, and data management. This page covers key features, limits, and common setup steps.
Browser support for file access, caches, PWA installation, media controls, and picture-in-picture is now strong enough for part of the desktop music player workflow. Compared with traditional desktop software, a web player stays lighter, easier to update, and clearer about permission boundaries.
File and folder access is controlled by the browser, and risky actions require explicit user confirmation.
No heavy desktop installation. Offline use and version staying are easier to manage.
The UI is optimized for large libraries and avoids launching another full browser shell just for playback.
The app respects your folder structure, avoids unnecessary caches, and supports playlist import, export, and backup.
The web platform still has boundaries. System-wide shortcuts and directly revealing files in Explorer are limited by the browser, so MiuPlayer Box provides practical workarounds where possible.
| Limit | Workaround | Note |
|---|---|---|
| No system-wide shortcut registration | Use in-player shortcuts and system media controls | The app will not hijack shortcuts from other apps. |
| A web page cannot directly open File Explorer | Install pwa-enhancer.exe and use the custom protocol | This requires explicit installation and user-level authorization. |
| No desktop lyric overlay | The lyric popup player can partially replace it | Browsers are not going to support risky APIs like transparent always-on-top windows, so this web app cannot do that. |
pwa-enhancer installed if you need reveal-in-file-explorer supportWant to verify browser support?
Open the Compatibility Check page and review the result.
Supports .lrc and .lrcx lyric files, with fallback to embedded lyrics when needed.
MiuPlayer Box provides two Picture-in-Picture players: a compact controller and a lyric player.
This feature lets the web app open a system file explorer through a custom protocol.
pwa-enhancer.exe installedpwa-enhancer.exepwa-enhancer below or from GitHub, then place it in a fixed folder.pwa-enhancer.exe --install in a terminal.pwa-enhancer.exe registers the explorerlink: protocol, allowing controlled Explorer launches from the web app. Uninstall it any time with pwa-enhancer.exe --uninstall.You can install MiuPlayer Box as a standalone PWA window.
Chromium-based browser, version above 110.
由于设备字体涉及指纹隐私，浏览器过去不提供枚举本机字体的功能，并对探测字体行为严格监控。但这限制了网页字体的丰富性。 最早Chromium在v1???版本加入该功能，调用网站需要通过用户授权。
在MiuPlayerBox中被用于指定输出设备。 最早Chromium在v1???版本加入该功能，调用网站需要通过用户授权。
关于项目
一个主打轻量、灵活和本地优先的网页音乐播放器。它尽量把浏览器的新能力用到音乐管理、歌词播放和歌单整理上，同时保留网页应用的低负担体验。 Web Platform New API 实验性项目， light but not slight!
当前应用界面和主要能力仍在持续完善。MiuPlayer Box 已经可以承担日常本地音乐播放，但歌单、设置、历史记录和高级歌词体验还会持续演进。
我通常每周都会花大量时间听歌。在项目启动之初，我对当时的桌面音乐播放器感到沮丧，因为它们要么操作笨拙、设计过时，要么功能不符合个人习惯。 我对本地音乐做了大致文件夹分类，希望至少有直观的类文件浏览器式的音乐导航并且支持播放列表。 同时，我需要歌词渲染。
当时（2024年末）桌面端也有现成方案，但往往基于Electron，安装包重、占用偏高、灵活度一般。没有满足我设想的期望。 大概我很挑剔吧，何不自己造一个呢？ 基于一些Web平台新的实验性API，MiuPlayer Box从自用需求开始，逐步把这些想法落在网页平台上。
2MB。MiuPlayer Box是一款按个人喜好随心所欲的音乐播放器，也是拒绝循规蹈矩的 Web Experiment Project。
作者想做点不一样的东西，目标是最强网页本地音乐播放器；（据说代码非常优雅ヾ(≧▽≦*)o）
同时也是 LRCX 高级歌词播放器示例项目。（我也绝对不会告诉你作者大费周章设计歌词格式写播放器只是为了方便学喜欢的歌的!!￣へ￣）
About
A lightweight, flexible, local-first web music player. It brings modern browser capabilities into music browsing, lyric playback, and playlist management while keeping the app easy to open and update.
The interface and major features are still evolving. MiuPlayer Box is already useful for daily local playback, while playlist editing, settings, listening history, and advanced lyric tools will keep improving.
I spend a lot of time listening to music every week. When this project started, I was frustrated with the desktop music players I had at the time: they were either awkward to use, visually dated, or just did not fit my own habits. I had already organized my local music roughly by folders, so I wanted at least an intuitive file-browser-style way to navigate music, with proper playlist support. I also needed lyric rendering.
Back then, around late 2024, there were workable desktop options, but many were based on Electron: heavier install packages, higher resource use, and only average flexibility. None of them really matched what I had in mind. Maybe I am just picky, but then why not build one myself? With a few experimental new APIs from the web platform, MiuPlayer Box started as a tool for my own use and gradually turned those ideas into a web app.
2MB.MiuPlayer Box is a music player built around personal taste and freedom, and also a distinct Web experiment plus an advanced LRCX lyric-playback ecosystem project. Rumor says the code is very elegant (show-off work, maybe)
常见问题
由于 MiuPlayer Box 全力押注网页APP的特殊技术路线，功能和使用细节上与常规播放器有许多差异。 这里可以找到一些常见问题和回答。
浏览器对文件访问、缓存、PWA、媒体控制和画中画的支持已经足够承担一部分桌面音乐播放器场景。相比传统桌面软件，网页播放器更轻、更容易更新，也更容易控制权限边界。
文件和目录访问由浏览器授权，风险操作需要用户明确确认。
无需安装完整桌面程序，可离线使用，也方便保留或回退版本。
面向万级曲库做渲染优化，避免为播放器额外启动一个完整浏览器壳。
尊重磁盘结构，不做多余缓存；歌单数据可导入、导出和备份。
这事还得赖 Chromium 。截止v148，对于枚举设备 API 的支持都过于粗糙，完整获取输出设备需要一次性枚举所有音频设备。 当然，同期 firefox 可以仅获取媒体输出设备，不过本地播放功能在 firefox 上几乎不可用
Q & A
Because MiuPlayer Box goes all in on a web-app-first technical route, many details in its features and usage differ from conventional music players. This page collects a few common questions and short answers.
Browser support for file access, caches, PWA installation, media controls, and picture-in-picture is already strong enough to cover part of the desktop music-player workflow. Compared with traditional desktop software, a web player stays lighter, easier to update, and clearer about permission boundaries.
File and folder access is mediated by the browser, and risky actions require explicit user confirmation.
There is no need to install a full desktop program, it can work offline, and it is easier to keep or roll back versions.
The interface can be optimized for very large libraries without launching an extra heavyweight desktop shell just for playback.
The app respects your disk structure, avoids unnecessary caching, and lets playlist data be imported, exported, and backed up.
This is mostly a Chromium limitation. As of Chromium v148, support for the device-enumeration APIs is still fairly rough, and a complete list of output devices generally requires enumerating all audio devices in one go. Firefox from the same period can expose media output devices more selectively, but local playback support there is still close to unusable for this project.
{{pItem.desc}}
{{emptyText}}
{{item.reason}}
{{item.value}}{{ i18n.pages.settings.exportPlaylistDesc }}
{{ i18n.pages.settings.clearOfflineCacheDesc }}
{{ i18n.pages.settings.deleteDatabaseDesc }}