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.