foobox-cn 完整上手指南：给 foobar2000 换一套现代化中文界面
【免费下载链接】foobox-cnDUI 配置 for foobar2000项目地址: https://gitcode.com/GitHub_Trending/fo/foobox-cn
如果你也遇到这种情况：foobar2000 解码稳、格式全，可一打开界面，菜单、播放列表、按钮还停留在十几年前的风格，找功能要在几个窗口间来回切。foobox-cn 就是为这个问题准备的——它是一套面向 foobar2000 的 DUI（默认用户界面）中文皮肤配置，基于 JSplitter 组件搭建，把播放列表、封面浏览、歌词、艺术家简介、频谱可视化整合进同一个现代化窗口里，同时保持 foobar2000 本身的流畅度。
项目速览
一句话定位：foobox-cn = foobar2000 的 DUI 中文皮肤配置包（含主题与所需第三方组件），属于界面层改造，不改动播放器核心。
| 项目 | 说明 |
|---|---|
| 界面框架 | foobar2000 默认用户界面（DUI），基于 JSplitter（Spider Monkey Panel 系） |
| 内置面板 | 播放列表、封面浏览器、简介（Biography）、可视化，另可选视频面板 |
| 歌词显示 | 集成 ESLyric 歌词组件 |
| 主题 | 深色 / 浅色两套配色，支持高分屏（DPI 缩放） |
| 系统要求 | Windows 10 1607 及以上；foobar2000 v1.5+（x86）或 v2.0+（x86/x64） |
| 获取方式 | Releases 页面提供绿色安装包，不捆绑播放器本体 |
安装 foobox-cn：最短上手路径
环境检查
- Windows 10 1607 或更高版本；
- foobar2000 v1.5 以上（x86）或 v2.0 以上（x86/x64）；
- foobox-cn 中文版与 Asion 制作的 foobar2000 汉化版配合使用，界面文本为中文。
三步装好
- 下载安装包：到项目 Releases 页面取最新版安装包（也可从 https://gitcode.com/GitHub_Trending/fo/foobox-cn 获取源码自行查看结构）。安装包只含 foobox 主题及所需组件，不含 foobar2000 本体，绿色安装、可自由放置。
- 运行安装：按向导把主题与组件装到 foobar2000 目录即可。安装包里已包含界面依赖的第三方组件：基于 Spider Monkey Panel 的 JSplitter、openhacks_mod、歌词组件 ESLyric、频谱组件 foo_enhanced_spectrum_analyzer。
- 首次运行：启动 foobar2000，进入「主菜单 → 视图 → 布局 → 快速设置」，在预设的布局组合里挑一个，界面立即生效。
官方对 DUI 布局的说明见仓库中的示意图：
核心能力：按使用场景看
场景一：管理几千首歌的播放列表
播放列表面板（JS Smooth Playlist Manager）是主区域，提供平滑滚动、列表内过滤框、拖放歌曲/文件夹、多播放列表视图（script/js_panels/ 下jsview_playlist.js、jsview_multiplaylist.js对应单/多列表两种视图）。
配合搜索框（script/js_panels/search.js）可以直接在库中按关键词检索，结果可选择保留为独立播放列表。举个例子：新拖进 300 首歌后，在过滤框输入歌手名，当前列表立刻只剩相关曲目，不需要翻菜单、不需要开新窗口。
场景二：按专辑封面浏览音乐
封面浏览器面板（JSSB）支持按专辑、艺术家、目录、流派等维度浏览，本地目录封面默认识别cover.jpg、folder.jpg这类文件名，浏览过的封面会写入缓存目录（foobox/covercache），二次打开更快。
当本地没有封面时，封面信息面板（script/js_panels/infoArt.js）内置了在线封面搜索入口，可跳转百度图片、必应、Google 图片、Last.fm 用「歌手 + 专辑」关键词找图，找到后保存回专辑目录即可被封面浏览器识别。
场景三：边听边看歌词和背景资料
- 歌词：ESLyric 组件负责歌词抓取与显示，歌词区与播放进度同步；
- 艺术家简介：Biography 简介面板（biography/ 目录）可从 Last.fm、AllMusic、维基百科拉取艺术家照片、简介与评论，并支持把面板放到上、左、右、下或叠加显示，主题可在界面、深色、浅色间切换。
听一张新专辑时，把简介面板挂在一侧，封面、歌词、艺术家背景就在一个窗口内，不用切应用。
场景四：看频谱
foo_enhanced_spectrum_analyzer 以可视化面板形式集成在布局中，播放时实时显示频谱，属于 foobox-cn 默认依赖组件之一，安装后无需单独配置。
进阶玩法：布局与图标自定义
切换布局预设
「主菜单 → 视图 → 布局 → 快速设置」是主要入口，预设了多套面板组合，适合不同用途：
- 想信息密度高：选带多列表 + 可视化面板的布局；
- 想界面干净：选只保留播放列表与封面浏览的精简组合。
面板之间通过 JSplitter 的分隔条拖拽调整大小，习惯后可固定成自己的工作布局。
自定义流派图标映射
foobox-cn 内置约 28 张流派图标（Genre/目录，仅支持 jpg 格式）。中文流派名到图标文件的映射集中在 script/js_common/Genre.js 的GenrePack表中，例如：
"华语流行": "CPop", "摇滚": "Rock", "说唱": "Rap"想加自己的分类，往GenrePack里加一行，并在Genre/目录放同名 jpg 即可，封面浏览按流派分类时就会使用对应图标。
主题与配色
深色/浅色主题随布局预设切换；封面信息面板还支持按当前封面颜色微调界面配色，相关开关都在 foobar2000 的属性设置中，不改动代码即可调整。
避坑指南：现象 → 原因 → 解决
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| 装完后界面和原版没区别 | 第三方组件未就位，或 foobar2000 的 DUI 界面未启用 | 确认 JSplitter、openhacks_mod、ESLyric 等组件已随安装包装入；在 foobar2000 首选项中确认使用默认用户界面（DUI）；重启后重试 |
| 中文界面出现英文混杂或显示异常 | foobox-cn 中文版文本与 Asion 汉化版配套 | 确认 foobar2000 本体为 Asion 汉化版；若用的是英文原版，界面语言表现会不一致 |
| 流派分类下没有图标 | 图标文件缺失、名称对不上或非 jpg | Genre/目录只认 jpg 格式；检查文件名与Genre.js中GenrePack的映射是否一致 |
| 旧系统上装不上或组件报错 | 系统/版本低于要求 | 需要 Windows 10 1607+；foobar2000 至少 v1.5（x86）或 v2.0（x86/x64），低版本先升级播放器 |
| 多套美化脚本并存时界面打架 | 其他 DUI 主题同时生效 | 同一时间只启用一套 DUI 皮肤配置，禁用其余主题后重启 |
写在最后
foobox-cn 做的事情很聚焦：不碰播放核心，只把 foobar2000 的界面层换成现代化、中文化的整套方案，播放列表、封面、歌词、简介、频谱各就各位。
建议的下一步：装好后先进「主菜单 → 视图 → 布局 → 快速设置」挑一套顺眼的布局用一周，再用Genre.js和分隔条拖拽把细节调成自己的习惯——界面这种东西，用顺手比好看更重要。
【免费下载链接】foobox-cnDUI 配置 for foobar2000项目地址: https://gitcode.com/GitHub_Trending/fo/foobox-cn
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
