0.2.0

Default Theme 0.2.0

中文

这次更新围绕背景、歌词和窄窗口布局展开，并加入本地服务的准备与状态控制。

背景与界面

• 新增随封面配色的流动背景，深浅模式可分别调节亮度、饱和度和磨砂效果。背景也可改为跟随强调色。
• 调整主视图、播放栏和右侧视图的背景层级，修正切歌、停止播放、缺少封面及退出沉浸视图时的闪烁与残留。
• 窄窗口中的左右浮层与文件夹、艺人、流派侧栏使用统一的间距和展开收起动效，修正菜单、重命名和按键关闭侧栏的问题。
• 右侧视图支持独立的前进与后退；设置中补充界面缩放、动效和沉浸视图的选项。

歌词与播放

• 搜索结果显示更多歌词信息，并在来源提供时显示封面；可先预览候选歌词，再使用或设为曲目的默认歌词。
• 支持提前或延后歌词和重播当前句。可调整字体、译文和音译显示，以及不同类型歌词的优先级。
• 有时间轴歌词时，在进度条上悬停或拖动可查看目标位置附近的歌词；跳转和切歌时提供连续的进度反馈。
• 修正部分词源查询、候选信息和搜索页面返回时的状态恢复。

兼容与稳定性

• 在 Windows 10 或窗口材质不可用时改用主题色背景；材质应用失败时显示提示。
• 更新日志跟随当前界面语言，播放统计的部分读取失败不再影响其他可用内容。
• 修正从托盘恢复后窗口再次收起的问题；窗口不可见时暂停相关背景和可视化任务。
• 新增本地服务的状态查看与重试入口。首次运行按需下载运行环境和服务文件，安装完成后可离线复用。服务未就绪不影响音乐播放和主题界面。

从 0.1.0 更新

在 设置 > 关于 检查并安装主题更新，完成后重启 foobar2000。沿用现有模板目录和设置，无需先删除旧主题。

本版仍要求 foo_ui_webview2 2.0.0 或更高版本，以独立窗口运行；不支持 DUI 或 CUI 面板。本版发布时没有新的插件版本，主题也不会自动替换 foo_ui_webview2 或 foobar2000 本体。

首次安装使用完整主题安装包，解压后让 index.html 直接位于 <profile>\webview-ui\<模板名>\ 内，再在插件首选项中选择该模板。fe-*.zip、后端包和运行时分块由更新器使用，不作为首次安装包。GitHub 的 Source code 归档是源码。

---

English

This update focuses on backgrounds, lyrics and narrow-window layouts, and adds runtime preparation and status controls for the local service.

Backgrounds and interface

• Flowing backgrounds follow cover colors, with separate brightness, saturation and frosted-effect settings for light and dark modes. The background can also use your accent color instead.
• Refined surfaces across the main view, player bars and right pane. Fixed background flashes and lingering images when changing tracks, stopping playback, displaying tracks without covers or leaving the immersive view.
• Side overlays and folder, artist and genre sidebars use consistent spacing and transitions in narrow windows, with fixes for menus, renaming and keyboard dismissal.
• The right pane has its own back and forward history. Settings now include controls for interface scaling, motion and the immersive view.

Lyrics and playback

• Search results show more lyric details and cover art when supplied by the source. Preview a candidate before using it or saving it as the track's default lyrics.
• Move lyrics earlier or later and replay the current line. Adjust fonts, translations, romanization and the priority of different lyric types.
• When timed lyrics are available, hover over or drag the progress bar to preview lyrics near the target time, with continuous progress feedback when seeking or changing tracks.
• Fixed queries to some lyric sources, candidate details and state restoration when returning to search.

Compatibility and reliability

• Uses an accent-tinted background on Windows 10 or when window materials are unavailable, with feedback when a material fails to apply.
• Release notes follow the current interface language. A failed playback-statistics request no longer affects other available content.
• Fixed the window hiding again after restoration from the tray. Related background and visualization tasks pause while the window is hidden.
• Added local-service status and retry controls. The first run downloads runtime and service files as needed; installed files can be reused offline. Music playback and the theme remain available if the service is not ready.

Updating from 0.1.0

Check for and install the theme update under Settings > About, then restart foobar2000. Keep your existing template folder and settings; there is no need to delete the old theme first.

This release still requires foo_ui_webview2 2.0.0 or later in standalone window mode. DUI and CUI panels are not supported. No new plugin version accompanies this release, and the theme does not replace foo_ui_webview2 or foobar2000 automatically.

For a first install, use the complete theme package and extract it with index.html directly inside <profile>\webview-ui\<template>\, then select that template in the plugin preferences. The fe-*.zip archive, backend package and runtime chunks are used by the updater, not for first-time installation. GitHub's Source code archives contain source files.

0.1.0

Default Theme 0.1.0

中文

Default Theme 是 foo_ui_webview2 的默认主题，为 foobar2000 提供 WinUI 3 风格的界面

首发亮点

• 封面取色：配色随封面而变，也可选择 Windows 强调色或自定义颜色。
• 媒体库：按专辑、艺人、流派、歌曲与文件夹浏览，支持全局搜索。
• 歌词：支持逐字高亮与双语对照，可读取本地歌词或搜索在线歌词。
• 沉浸视图：封面、频谱、声场、整轨波形与歌词集中呈现。
• 迷你播放器：紧凑与封面两种形态，可始终置顶。
• 在线更新：在主题内检查、下载和安装新版，校验签名与哈希；新版启动失败时可自动回退。

安装

1. 安装 foo_ui_webview2 2.0.0 或更高版本，选择 Webview2 UI 作为独立窗口界面。
2. 下载 foo-webview-default-theme-0.1.0.zip。
3. 解压到 <profile>\webview-ui\<模板名>\，确认 index.html 直接位于模板目录内，不要多套一层文件夹。
4. 在 foo_ui_webview2 首选项中选择该模板、应用设置，重启 foobar2000。

主题不支持 DUI 或 CUI 面板。安装和使用步骤见中文教程。

附件

文件	用途
foo-webview-default-theme-0.1.0.zip	完整安装包，首次安装下载这个
fe-0.1.0.zip	在线更新器使用的前端包，不用于首次安装
release.json	在线更新使用的发行清单
changelog.json	主题内显示的更新日志

GitHub 自动生成的 Source code 归档是源码，不是可直接安装的主题。

更新与联网

更新方式默认为「手动检查」，可在 设置 > 关于 中改为「仅提醒」或「自动下载并安装」。新版在重启 foobar2000 后生效；主题不会自行重启，也不会更新插件或 foobar2000 本体。

在线歌词和在线艺人简介默认关闭，分别开启。开启后会向相应第三方服务发送搜索所需的曲目或艺人信息，不发送本地文件路径，详见教程。

---

English

Default Theme is the default theme for foo_ui_webview2, bringing a WinUI 3 style interface to foobar2000. This is its first public release.

Highlights

• Cover colors: Colors follow the playing cover, with Windows accent and custom color options.
• Library: Browse by album, artist, genre, song or folder, with global search.
• Lyrics: Word-synced highlighting and translations, with local lyrics and online search.
• Immersive view: Album art, spectrum, stereo field, full-track waveform and lyrics in one view.
• Mini player: Compact and cover layouts, with an option to stay on top.
• Online updates: Check, download and install updates in the theme, with signature and hash checks and automatic rollback if a new version fails to start.

Installation

1. Install foo_ui_webview2 2.0.0 or later and select Webview2 UI as the standalone interface.
2. Download foo-webview-default-theme-0.1.0.zip.
3. Extract it to <profile>\webview-ui\<template>\, with index.html directly inside that folder, not an extra subfolder.
4. Select the template in foo_ui_webview2 preferences, apply the settings and restart foobar2000.

DUI and CUI panels are not supported. See the user guide for installation and usage.

Assets

File	Purpose
foo-webview-default-theme-0.1.0.zip	Complete installation package; download this for a first install
fe-0.1.0.zip	Frontend package for the updater, not for a first install
release.json	Release manifest used by the updater
changelog.json	Release notes displayed in the theme

GitHub's automatically generated Source code archives contain source files, not an installable theme.

Updates and online content

Updates default to Check manually. Choose Notify only or Install automatically under Settings > About to enable automatic checks. Updates take effect after restarting foobar2000. The theme does not restart foobar2000 automatically and does not update the plugin or foobar2000 itself.

Online lyrics and online biographies are off by default and are enabled separately. When enabled, they send track or artist information needed for searches to the relevant third-party services, not local file paths. See the guide for details.