Releases: helson-lin/FanBar
Releases · helson-lin/FanBar
Release list
FanBar 0.4.14
修复 / Fixes
- 停转的风扇不再显示转动 — 风扇转速为 0 时,主界面的风扇图形保持静止,周围的气流线条也会隐藏;桌面小组件同样不再显示气流 (#34)
Stopped fans no longer look like they're spinning — at 0 RPM the panel's fan graphic stays still and its airflow streaks are hidden; the desktop widget no longer shows airflow either (#34)
安装 / Install
- Apple Silicon →
FanBar-v0.4.14-arm64.dmg - Intel →
FanBar-v0.4.14-x86_64.dmg - Universal →
FanBar-0.4.14.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.13...v0.4.14
FanBar 0.4.13
新增 / New
- 自动恢复默认时长 — 设置 → 通用 → 风扇控制 新增"自动恢复系统控制",可设为 15 分钟、30 分钟、1 小时或不自动恢复,每次切换到手动模式时按此计时。主界面中的修改只对当次生效,恢复系统控制后回到默认值 (#32)
Default automatic-restore duration — Settings → General → Fan Control adds "Restore automatic control" (15 minutes, 30 minutes, 1 hour or never), used each time you switch to a manual mode. Changes in the menu apply to that session only and reset once control returns to macOS (#32) - 可关闭主界面动画 — 设置 → 菜单栏 → 动画 新增"主界面动画"开关,关闭后风扇图形静止、模式切换无过渡,转速仍实时更新,可进一步降低 CPU 占用 (#32)
Panel animation can be turned off — Settings → Menu Bar → Animation adds a "Panel animation" switch. When off, the fans stop spinning and mode changes don't animate while readings still update live, further lowering CPU use (#32)
改进 / Improvements
- 控制模式切换更顺滑 — 选中背景在模式之间平滑滑动;从"系统"切换到其他模式时控制条不再抖动;各模式按钮文字大小保持一致 (#32)
Smoother control mode switching — the selection glides between modes, the strip no longer jolts when leaving Automatic, and all mode labels share one size (#32) - 固定转速选中态 — "固定"选择器中当前转速(含自定义转速)以与控制条相同的背景高亮显示 (#32)
Fixed RPM selection — the current RPM in the Fixed picker, including a custom value, is highlighted with the same background as the control strip (#32) - 重新整理设置窗口 — 通用页合并为"风扇控制"、"通知"、"FanBar"三组;控制服务正常时收起为一行状态;统一行高、控件对齐与标题层级;"检查更新…"移至版本号旁 (#32)
Reorganized settings — General is regrouped into Fan Control, Notifications and FanBar; a healthy control service collapses to a single status row; rows, controls and headers share one rhythm; "Check for Updates…" moves beside the version (#32) - "硬件安全限制"更名为"自动恢复系统控制",更准确地描述其作用
"Hardware safety limits" is renamed "Restore automatic control" to better describe what it does
安装 / Install
- Apple Silicon →
FanBar-v0.4.13-arm64.dmg - Intel →
FanBar-v0.4.13-x86_64.dmg - Universal →
FanBar-0.4.13.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.12...v0.4.13
FanBar 0.4.12
新增 / New
- 自定义固定转速 — "固定"菜单新增"自定义转速…",可以用滑块快速调整,或直接输入精确值(例如 3000 RPM)。可输入范围按本机风扇的硬件上下限计算并始终显示,超出范围时无法应用。最近一次使用的自定义转速会出现在菜单中,超出本机硬件范围的预设档位不再显示 (#26)
Custom fixed RPM — the Fixed menu adds "Custom RPM…", with a slider for quick changes and a field for an exact value (e.g. 3000 RPM). The allowed range comes from this Mac's fan hardware limits and is always shown; values outside it can't be applied. The last custom value is listed in the menu, and presets outside the hardware range are hidden (#26) - 可调整的高温提醒温度 — 设置 → 通知 新增"提醒温度",可在 60–105°C 之间设置,默认 90°C。设置项默认收起,点击展开滑块;松开滑块后才生效,拖动过程中不会误发通知
Adjustable high-temperature alert — Settings → Notifications adds "Alert temperature", configurable from 60–105°C (default 90°C). The row is collapsed by default and expands to a slider when clicked; the value applies when you release the slider, so dragging never triggers a stray notification
改进 / Improvements
- 大幅降低后台资源占用 — 菜单栏面板关闭时风扇动画完全暂停;菜单栏转动图标只在画面真正变化时重绘;系统服务状态不再每 2 秒查询;SSD 温度传感器在首次发现后复用。本地实测面板关闭时 CPU 占用从约 20% 降至约 3%(关闭菜单栏转动图标时)(#26)
Much lower background resource use — fan animations fully pause while the menu bar panel is closed; the spinning menu bar icon only redraws when its image actually changes; system service status is no longer queried every 2 seconds; and the SSD temperature sensors are reused after the first discovery. In local measurement, CPU use with the panel closed dropped from about 20% to about 3% (with the spinning icon turned off) (#26) - 菜单栏项目更紧凑 — 显示温度或转速时,菜单栏项目的宽度按实际读数计算,不再在图标和文字两侧留出多余空白
A tighter menu bar item — when showing temperature or fan speed, the item's width is sized to the actual reading, removing the extra space around the icon and text
安装 / Install
- Apple Silicon →
FanBar-v0.4.12-arm64.dmg - Intel →
FanBar-v0.4.12-x86_64.dmg - Universal →
FanBar-0.4.12.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.11...v0.4.12
FanBar 0.4.11
新增 / New
- 设置窗口重新设计 — 原生偏好设置样式工具栏(散热 · 菜单栏 · 通用),散热预设改为卡片式选择,曲线卡片带温度来源、当前温度标记与目标转速、控制点检查器;高级选项(降温缓冲、每步最大变化)默认折叠
Redesigned the settings window — a native preference-style toolbar (Cooling · Menu Bar · General), card-based preset selection, and one curve card with its temperature source, a live marker showing the target RPM, and a control-point inspector; advanced options (cooling buffer, max step) stay collapsed by default - 首次启动引导新增控制服务授权提示 — 未授权时会提示"按需调整散热需要一次性授权",并直接提供启用入口,不再让新用户第一次尝试调节转速时静默失败
The first-run onboarding now surfaces the control-service permission — when it hasn't been granted yet, a notice explains that adjusting cooling needs one-time permission and offers to enable it directly, instead of silently no-oping the first time a new user tries
修复 / Fixes
- 修复温度曲线横轴跨整点丢失小时 — 时间格式从
mm:ss改为HH:mm:ss
Fix the temperature chart's x-axis losing the hour across an hour boundary — the time format changed frommm:sstoHH:mm:ss - 修复锁屏、休眠或重启造成的采样空洞被连成一条直线,且平滑窗口会把断档两侧的读数混在一起;现在断档处正确断线,平滑也不会跨越断档。同时把最近十分钟的温度历史写入本地,重新打开 App 后曲线不再从空白开始
Fix a straight line being drawn across sampling gaps left by sleep, a locked screen, or a relaunch, and the smoothing window blending readings from either side of the gap; the trace now breaks at the gap and smoothing stops at the boundary too. The last ten minutes of history are also persisted locally, so the chart no longer starts blank after relaunching - 修复设置窗口切换 Tab 时的界面抖动 — 内容滚动条强制使用悬浮样式,不再因为"是否需要滚动"而改变内容区宽度
Fix the settings window's content visibly shifting when switching tabs — its scroller is now forced to overlay style, so the content lane's width no longer depends on whether that tab happens to need scrolling
致谢 / Thanks
- 感谢 Hisn0w 提交温度曲线修复
Thanks to Hisn0w for contributing the temperature chart fix
安装 / Install
- Apple Silicon →
FanBar-v0.4.11-arm64.dmg - Intel →
FanBar-v0.4.11-x86_64.dmg - Universal →
FanBar-0.4.11.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.10...v0.4.11
FanBar 0.4.10
修复 / Fixes
- 修复启动后点击菜单栏图标会弹出空白的“FanBar 设置”窗口 — 在较新的 macOS 上,系统会在启动时打开一个空的设置占位窗口,点击菜单栏图标时它会随面板一起出现。现在占位窗口不会再显示;在 FanBar 运行时再次打开 App 或按 ⌘, 会直接打开真正的设置窗口
Fix a blank "FanBar Settings" window appearing after clicking the menu bar icon — On recent macOS releases, an empty placeholder settings window opened at launch and came forward with the menu panel. The placeholder no longer appears, and reopening FanBar while it runs or pressing ⌘, opens the real settings window
致谢 / Thanks
- 感谢 倾藏 反馈问题
Thanks to 倾藏 for reporting the issue
安装 / Install
- Apple Silicon →
FanBar-v0.4.10-arm64.dmg - Intel →
FanBar-v0.4.10-x86_64.dmg - Universal →
FanBar-0.4.10.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.9...v0.4.10
FanBar 0.4.9
修复 / Fixes
- 修复开启温控或固定转速时提示“控制服务未响应”、风扇冲高后又归零 — 部分 Mac 需要先解锁风扇手动模式,耗时可能超过 3 秒;此前 App 等待 3 秒即判定失败并断开连接,控制服务随之把风扇恢复为系统自动控制,导致每次切换都失败。现在等待时间按风扇数量和解锁所需的最长时间计算,退出 FanBar 也不再被缓慢的回复拖住
Fix "control service did not respond" and fans spinning up then dropping back to 0 — Some Macs must unlock manual fan mode first, which can take longer than 3 seconds. FanBar gave up after 3 seconds and dropped the connection, which made the control service restore automatic fan control, so every switch failed. The wait now scales with the fan count and the longest unlock time, and quitting FanBar no longer waits on a slow reply - 控制服务新增诊断日志 — 记录每次风扇操作的耗时、真实错误和解锁时间,排查问题时可运行
log show --predicate 'subsystem == "local.fanbar.helper"' --last 30m查看
Diagnostic logging for the control service — Each fan operation's duration, underlying error, and unlock time are logged; view them withlog show --predicate 'subsystem == "local.fanbar.helper"' --last 30m - 修复控制模式错误提示与按钮文字重叠 — 错误提示显示时隐藏下方按钮,较长的提示不再溢出到相邻区域,完整内容可通过悬停或 VoiceOver 查看
Fix the control-mode error overlapping its buttons — The buttons are hidden while the error is shown, long messages no longer overflow into neighboring sections, and the full text is available on hover and to VoiceOver - 修复 macOS 26 及更新版本上设置窗口顶部标签图标拥挤 — 标签宽度改为跟随系统的原生尺寸
Fix crowded settings tab icons on macOS 26 and later — Tab segments now use the system's native sizing
安装 / Install
- Apple Silicon →
FanBar-v0.4.9-arm64.dmg - Intel →
FanBar-v0.4.9-x86_64.dmg - Universal →
FanBar-0.4.9.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.8...v0.4.9
FanBar 0.4.8
修复 / Fixes
- 修复开机登录启动时菜单栏图标偶发崩溃 — 当 FanBar 作为登录项被 launchd 在系统刚启动、WindowServer 连接尚未就绪时直接拉起,SwiftUI
App.init()阶段过早创建NSStatusItem会撞上 AppKit/SkyLight 的连接断言并直接 abort,表现为“一开机就崩溃、图标不出现”;现已将状态栏图标的创建延迟到applicationDidFinishLaunching,此时 AppKit 已保证完成自身启动流程
Fix intermittent crash on launch-at-login — When launchd started FanBar as a login item before the WindowServer connection was ready, creating anNSStatusItemtoo early inside SwiftUI'sApp.init()hit an AppKit/SkyLight connection assertion and aborted, showing up as "crashes on launch, icon never appears"; status-item creation now waits forapplicationDidFinishLaunching, which AppKit only calls once its own startup sequence has finished
安装 / Install
手动覆盖安装,需要手动在‘通用’-‘登录项与扩展’-‘后台App活动’,关闭再开启一次fanbar.
建议在线升级
To perform a manual override installation, you need to manually close and then re-enable Fanbar under "General" - "Login Items & Extensions" - "Background App Activity."
Recommended for online upgrades
- Apple Silicon →
FanBar-0.4.8-arm64.dmg - Intel →
FanBar-0.4.8-x86_64.dmg - Universal →
FanBar-0.4.8.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.7...v0.4.8
FanBar 0.4.7
What's Changed
- [codex] Add macOS desktop widget by @helson-lin in #9
Full Changelog: v0.4.5...v0.4.7
FanBar 0.4.4
修复 / Fixes
- 修复 Helper 退出时崩溃 — Helper 在收到 SIGTERM/SIGINT(关机、休眠、重装、App 退出)时因 Swift 并发隔离断言触发 SIGTRAP,导致无法恢复风扇自动控制;现已显式标记信号处理闭包为
@Sendable,退出路径稳定执行恢复逻辑
Fix helper crash on exit — The helper trapped with SIGTRAP on SIGTERM/SIGINT (shutdown, sleep, reinstall, app quit) due to a Swift concurrency isolation assertion, skipping fan restore; the signal handler closures are now explicitly@Sendableso the shutdown path reliably restores automatic control
安装 / Install
- Apple Silicon →
FanBar-0.4.4-arm64.dmg - Intel →
FanBar-0.4.4-x86_64.dmg - Universal →
FanBar-0.4.4.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.3...v0.4.4
FanBar 0.4.3
新增 / New
- 可编辑智能温控曲线 — 设置页以散热曲线为第一路径:平滑曲线、可拖锚点、可选 CPU / GPU / SSD 温度来源,温度低于第一拐点时可 0% 停转
Editable smart cooling curves — Settings opens on Cooling first: a smooth curve, draggable anchors, CPU / GPU / SSD sources, and 0% idle below the first knee - 曲线与面板预设一一对应 — 静音 / 均衡 / 性能 / 极速各自保存一条曲线;菜单栏选择预设即套用对应曲线
One curve per panel preset — Silent, Balanced, Performance, and Extreme each store their own curve; choosing a preset in the menu applies that slot
改进 / Improvements
- 高级项默认折叠 — 锚点表、降温磁滞、每步限速放在「高级」里,主路径只保留曲线、预设和温度来源
Advanced controls stay folded — Anchor table, hysteresis, and per-step limits live under Advanced so the curve stays primary - 设置窗口适配屏幕 — 高度限制在可见屏幕内,内容可滚动,避免矮屏被裁切
Settings window fits the display — Height is clamped to the visible screen and tall content scrolls instead of clipping - 架构安装包 — 同时提供 Apple Silicon、Intel 与 Universal DMG;Sparkle 在线更新仍使用 Universal
Architecture-specific installers — Apple Silicon, Intel, and Universal DMGs; Sparkle updates still use the Universal image
修复 / Fixes
- 硬件写入失败不切换预设 — 只有 Helper 真正应用成功后才提交可见预设和曲线,避免界面声称已进入未生效的模式
Failed hardware apply does not switch presets — The visible preset and curve commit only after the helper write succeeds - 降温磁滞按输出保持 — 相同较低温度的连续采样会继续稳住转速,降温过程中不会把风扇往上调
Falling hysteresis holds across equal samples — Repeated cooler readings keep RPM; output never rises while cooling - 忽略过期 Helper 连接回调 — 旧 XPC 连接的 invalidation 不会清掉已经建好的新连接
Stale helper invalidations are ignored — An older connection cannot clear its replacement
安装 / Install
- Apple Silicon →
FanBar-0.4.3-arm64.dmg - Intel →
FanBar-0.4.3-x86_64.dmg - Universal →
FanBar-0.4.3.dmg - 校验和见对应的
.sha256文件 / SHA256 checksums in corresponding.sha256files
Full Changelog: v0.4.2...v0.4.3