termbg for Mac 版
用于终端背景颜色检测的 Rust 库
termbg 是什么
termbg 是一个用 Rust 编写的终端背景色检测库,输出结果可以是 RGB 值,也可以直接给出 dark 或 light 主题判断。它要解决的问题很具体:程序往往需要知道用户终端是深色还是浅色背景,才能选对配色,而这件事在不同终端里并没有统一做法。termbg 把检测逻辑封装起来,让调用方不必自己处理终端差异。
检测机制分三层:Win32 控制台走 WIN32API,xterm 兼容终端使用 Xterm Control Sequences,前两者失败时回退到 COLORFGBG 环境变量。拿到 RGB 后转换为 YCbCr,以 Y 是否大于 0.5 判定 light 或 dark。
已验证支持的终端包括 Alacritty、GNOME Terminal、kitty、iTerm2、tmux、VS Code、xterm 等二十余种;Cmder、ConEmu、PuTTY、Windows Terminal 等暂不支持,其中 Windows Terminal 可能在未来版本加入。库还附带一个简单的检查程序,方便直接验证效果。适合需要根据终端主题调整输出颜色的 CLI 工具、TUI 应用和终端相关库的开发者。
检测机制分三层:Win32 控制台走 WIN32API,xterm 兼容终端使用 Xterm Control Sequences,前两者失败时回退到 COLORFGBG 环境变量。拿到 RGB 后转换为 YCbCr,以 Y 是否大于 0.5 判定 light 或 dark。
已验证支持的终端包括 Alacritty、GNOME Terminal、kitty、iTerm2、tmux、VS Code、xterm 等二十余种;Cmder、ConEmu、PuTTY、Windows Terminal 等暂不支持,其中 Windows Terminal 可能在未来版本加入。库还附带一个简单的检查程序,方便直接验证效果。适合需要根据终端主题调整输出颜色的 CLI 工具、TUI 应用和终端相关库的开发者。
如何安装 termbg
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
该项目暂未在 GitHub 发布 Release。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- Apple 芯片 · 最新 macOS
- Apple 芯片 · macOS 26 Tahoe
- Apple 芯片 · macOS 15 Sequoia
- Apple 芯片 · macOS 14 Sonoma
- Apple 芯片 · macOS 13 Ventura
- Intel · macOS 14 Sonoma
- Intel · macOS 13 Ventura
- Linux · ARM64
- Linux · x86_64
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| termbg | 0.6.2 | Apache-2.0 OR MIT | 命令行 | 10 |
| typioca | 3.1.0 | MIT | 命令行 | 8 |
| yetris | v2.1.0 | GPL-3.0-or-later | 命令行 | 14 |
| distribution | 1.3 | GPL-2.0-only | 命令行 | 8 |