用途:创建和管理 Omarchy 桌面主题。核心方式是在主题目录的 colors.toml 中定义颜色,颜色会自动传播到各桌面应用。
主要能力:通过 22 个必需颜色变量控制 ANSI 常规色与亮色,并支持 accent、cursor、foreground、background 等模板变量;变量可按三种格式输出,供不同环境使用:{{ name }} 输出 #89b4fa(用于 CSS、TOML),{{ name_strip }} 输出 89b4fa(用于 Hyprland rgb()),{{ name_rgb }} 输出 137,180,250(用于 RGBA)。
结构与用法:主题放在 ~/.config/omarchy/themes/{theme-name}/,其中 colors.toml 与 backgrounds/ 为必需,preview.png、icons.theme、neovim.lua、vscode.json、btop.theme 为推荐,light.mode、chromium.theme、hyprland.conf 为可选。创建后执行 omarchy-theme-set my-theme 应用。还可用 omarchy-theme-current、omarchy-theme-list、omarchy-theme-install <git-url>、omarchy-theme-remove my-theme、omarchy-theme-update、omarchy-theme-bg-next。
限制与注意:必须定义全部 22 个颜色变量,缺失会报错;仅使用 HEX 格式(#RRGGBB),不支持 RGB、HSL 或颜色名;backgrounds/ 至少含一张壁纸;浅色主题需创建空的 light.mode 文件。应用未生效时可把静态配置放入主题目录覆盖模板,或检查变量名是否与 colors.toml 键一致;出现 yq 错误可用 sudo pacman -S yq 安装。
适用场景:为 Omarchy 桌面制作整套配色主题,并统一终端、窗口管理器与状态栏等组件的外观。