Cider for Flexbar v2.0.0

Customize Now Playing with automatic overlay hiding and independent connection and appearance settings.

New

• Auto-hide Play/Pause Overlay: optionally hide the cover icon after 1–30 whole seconds (default: 3 seconds). Auto-hide is off by default, preserving the existing persistent overlay.
• The icon reappears after a successful Play/Pause action or a playback state change in Cider, and the countdown restarts. Tap-to-play/pause keeps working while the icon is hidden.
• Independent save buttons: SAVE TOKEN saves the connection token; SAVE APPEARANCE saves the overlay, timeline color, font, font size, and auto-hide settings.

Fixes

• Saving appearance applies immediately without resetting the active Cider connection or requiring another layout upload.
• Both save buttons preserve the other section's saved values, and unchanged settings do not trigger unnecessary updates.
• Preserve existing playback controls, Volume synchronization, Listening Mode, and protection against stale layout updates.

Downloads

• Windows x64: com.sonw.cider.flexplugin
• macOS Apple Silicon: com.sonw.cider.macos-arm64.flexplugin
• macOS Intel: com.sonw.cider.macos-x64.flexplugin

On macOS, you may need to download the matching package manually from GitHub. Match FlexDesigner's architecture; Intel FlexDesigner under Rosetta requires the Intel package.

Each platform package is built and validated separately by GitHub Actions, including all 87 automated tests, native Canvas loading, and FlexCLI package validation. Auto-hide and appearance saving have also been tested on a physical Flexbar on Windows.

Full changes: v1.5.0...v2.0.0

Cider for Flexbar v1.5.0

Customize Now Playing directly from FlexDesigner → Settings → Application → Cider.

New

• Cover play/pause overlay: larger white icons without a circular backdrop. Playing shows Pause; paused shows Play. The overlay can be hidden while keeping tap-to-play/pause enabled.
• System font selection: choose from fonts available on your computer, with multilingual fallback when a font is unavailable.
• Adjustable font size: set the title to 12–30 px, or leave it empty to retain the key's font size. The artist line adapts to fit above the timeline.
• Timeline color: customize the played portion of the progress bar.
• Save from the appearance section: a SAVE SETTINGS button below the font controls applies changes immediately and shows the save result.

Behavior and fixes

• Appearance changes redraw current Now Playing keys immediately, reuse the existing playback state, and preserve connection settings.
• Saving appearance no longer resets Volume synchronization or unnecessarily resends an unchanged slider.
• Keep the existing cover and timeline layout, with 45 px timeline margins and standard 50 % volume formatting.
• Preserve playback controls, Listening Mode synchronization, and protection against stale layout updates.

Downloads

• Windows x64: com.sonw.cider.flexplugin
• macOS Apple Silicon: com.sonw.cider.macos-arm64.flexplugin
• macOS Intel: com.sonw.cider.macos-x64.flexplugin

On macOS, you may need to download the matching package manually. Match FlexDesigner's architecture; Intel FlexDesigner under Rosetta requires the Intel package. macOS support remains experimental; physical Flexbar testing was performed on Windows.

Each platform package is built and validated separately by GitHub Actions, including the automated test suite and native Canvas loading.

Full changes: v1.4.0...v1.5.0

v1.4.0

Added playtime timeline
添加了播放时间线

Cider for Flexbar v1.3.1

Updates the plugin's Description in FlexDesigner with this English note:

Control Cider via FlexBar. On macOS, you may need to download the matching Apple Silicon or Intel package manually from GitHub Releases.

This is a metadata-only update; plugin behavior is unchanged from v1.3.0.

Platform	Package
Windows 11 x64	com.sonw.cider.flexplugin
macOS 15+ Apple Silicon	com.sonw.cider.macos-arm64.flexplugin
macOS 15+ Intel	com.sonw.cider.macos-x64.flexplugin

Choose the package matching the architecture of FlexDesigner. An Intel build running through Rosetta needs the Intel package. macOS physical Flexbar testing is pending.

仅更新插件详情页的英文 Description，提示 macOS 用户可能需要前往 GitHub Releases 手动下载对应架构的安装包。功能与 v1.3.0 相同。

Cider for Flexbar v1.3.0

更新内容

• 新增 Listening Mode 循环按钮：Off → Gaming → Unwind → Off，以及三个独立模式按钮。图标、标题和蓝色激活背景共享状态，支持 Cider 内切换后同步。
• Now Playing 封面扩大到常规 58×58，保留约 1px 黑边，非正方形封面居中裁切；歌名与歌手沿用原文字布局。
• 保留布局重新上传时的按键隔离，以及原生 Volume 滑块和音量同步。
• 插件 Homepage 指向本仓库。
• 加入 macOS 平台声明和两种 Mac 架构的独立安装包。
• 项目采用 MIT License（© 2026 Sonw），安装包同时包含项目与第三方许可证说明。

下载

系统	安装包
Windows 11 x64	com.sonw.cider.flexplugin
macOS 15+ Apple Silicon	com.sonw.cider.macos-arm64.flexplugin
macOS 15+ Intel	com.sonw.cider.macos-x64.flexplugin

请选择与 FlexDesigner 进程架构匹配的包；Rosetta 下的 Intel 版 FlexDesigner 使用 Intel 包。macOS 为实验性支持，实体 Flexbar 测试待反馈。

Listening Mode 需要 Cider 4.0 的 v2 API，沿用应用设置中保存的 Cider token。播放、音量和 Now Playing 继续使用原 v1 API。安装包不包含用户 token 或本地配置。

如果更新后仍显示旧行为，请保存布局并重启 FlexDesigner，再重新上传布局，以清理同时运行的旧插件后端。

验证

• Windows x64、macOS arm64 和 macOS x64 分别通过 41 项自动测试、构建、原生 Canvas 加载、FlexCLI 校验与打包。
• Windows 的真实 Cider/SDK 检查与文字布局比较通过；用户已确认实体 Flexbar 上 Listening Mode 和封面尺寸正常。
• macOS 实体 Flexbar 测试尚未完成。

完整说明：中文 · English · MIT License

English

Adds synchronized Listening Mode cycle/direct controls, larger center-cropped artwork with the existing text layout, the repository Homepage link, and MIT licensing. Separate Windows x64, macOS Apple Silicon, and macOS Intel packages include their matching native Canvas libraries. macOS support is experimental pending physical Flexbar testing. Listening Mode requires Cider 4.0; existing playback and volume APIs remain unchanged.

Cider for Flexbar v1.2.1

修复重新排列并上传布局后，Now Playing 图片错误覆盖相邻按键的问题。

• 在 FlexDesigner 2.2.3 上确认：上传后按键数字编号会被复用，旧版仍向过期编号绘图。现在每次加载布局都会替换该设备的活动按键，丢弃过期图片。
• PNG 严格匹配有效按键宽度，保持 60 像素高度；缺失、冲突和非整数宽度不再使用猜测尺寸。极窄按键的封面和文字保持在画布内。
• 保持正常尺寸下的封面位置、Unicode 歌名/歌手、响应式文字、所有播放控制、原生音量滑块及 apptoken 鉴权。

验证：29 项定向回归（包括 6 种布局 × 4 档宽度）、31 项打包后端集成回归、16 张多语言排版图片和 400 个 Unicode 字符簇边界检查通过。旧版在新增的相邻按键回归中失败，修复版通过。实体设备的最终视觉与触控体验仍由用户验收。

安装附件 com.sonw.cider.flexplugin，应用布局修改后重新上传。

Cider for Flexbar v1.2.0

修复 Now Playing 的宽度利用率，并优化新增 Volume 按键的默认布局。

• Now Playing：封面固定在左侧 8 像素位置，文字使用封面之后的全部剩余空间。加宽按键可以显示更多歌名和歌手信息；保留封面比例、Unicode 字体回退、字符簇安全省略和点击播放/暂停。
• Volume：新增按键默认外框 300 像素、轨道 230 像素，显示 28 像素音量图标。已有按键保留保存的样式；音量读写、75 毫秒拖动队列、三秒同步和认证逻辑不变。

调整宽度

• 修改 Now Playing 宽度后，请应用修改并上传布局，使后端重新加载最新尺寸。普通按键没有文档化的实时尺寸变化事件。
• Volume 的原生轨道宽度仍需在 前景 → 滑块宽度 单独调整，不会自动跟随外框增长。使用本版图标默认值时，可设为 外框宽度 - 70，外框建议至少为 250 像素；220 像素无法同时保留宿主要求的最小轨道和同样的图标间距。

验证

Windows x64 / Node.js 20.20.2 构建、校验及打包通过；31 项既有功能回归、多宽度 Canvas 和中日韩文字验证通过。源码与插件包已检查，无实际 API token。上述软件验证不等同于本版的实体 Flexbar 触摸测试。

升级提示：本次测试遇到 FlexDesigner 2.2.3 安装器因原生文件占用而替换失败，并需要重新保存 Cider token。升级前请保留自己的 token，以便必要时在应用设置中重新填写；请勿公开分享 token 或本机配置。

Cider for Flexbar v1.1.0

添加了音量调节 slider

Cider for Flexbar v1.0.0

Highlights

• Cider playback controls for Previous, Play/Pause, and Next.
• Now Playing artwork, title, and artist display on Flexbar.
• Unicode-safe rendering for Chinese, Japanese, Korean, and accented text.
• Settings page for each user's own Cider API token.

Documentation

• English README
• 中文 README

Verification

The Windows x64 package was built and validated with FlexCLI. The package and public source were scanned for credential copies before publication. Users must enter their own token in FlexDesigner settings.