制作专属主题

你可以在 ~/.config/omarchy/themes 中添加自定义主题。只需复制现有主题作为模板基础（可参考 /usr/share/omarchy/themes 中的内置主题），然后按你的喜好进行调优。只要主题存放在该文件夹中，它就会自动出现在主题选择菜单中。

你需要调整的核心文件是 colors.toml。它定义了全局色彩基调，随后会自动派生并生成针对终端（Foot/Alacritty/Ghostty/Kitty）、btop、Chromium、Hyprland、Neovim、Helix、VSCode、Obsidian 以及整个 Omarchy Shell（顶部状态栏、菜单、通知、OSD 浮层与锁屏）的协调配置。

你还可以使用内置的 Aether 应用程序，在优雅的图形界面中调试色彩并搜索壁纸来创建新主题。按下 Super + Alt + Space 从应用菜单中启动它即可。

浅色模式 (Light mode)

如果你正在制作一套浅色主题，在 colors.toml 顶部声明 mode = "light" 即可。系统会自动将其与所有应用的浅色模式进行适配配对。（在主题根目录下放置名为 light.mode 的空文件的旧方式依然兼容支持）。

图标配色联动 (Icon colors)

如果你希望文件管理器的文件夹图标颜色与你的主题保持契合，可在主题目录下添加名为 icons.theme 的文件，写入你想使用的图标包名称。默认可选项包括：Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow。

解锁界面图像 (Unlock image)

提供了 unlock.png 和 preview-unlock.png 的主题会列在 Style > Unlock 下。你的 unlock.png 最好是透明背景的 PNG 图片，你可以使用 omarchy plymouth preview 生成预览图。

为 Omarchy 未内置的应用适配主题

如果你使用的某款应用不在官方支持列表中，可以通过模板机制教会 Omarchy 如何为其生成主题配色。在 ~/.config/omarchy/themed/ 下创建一个以目标配置文件命名并附加 .tpl 后缀的模板文件，并在其中使用 {{ background }}、{{ foreground }}、{{ accent }}、{{ red }}、{{ color0 }} 至 {{ color15 }} 等调色板占位符编写配置。每次你切换主题时，该文件都会自动注入当前主题色彩并重新生成。

该文件夹中包含一份注释详尽的 alacritty.toml.tpl.sample 示例可供参考 —— 其中列出了所有可用变量，以及针对需要去除 # 前缀或使用十进制 RGB 格式应用的 _strip 和 _rgb 修饰符。自定义模板的优先级高于 Omarchy 内置模板，因此你也可以用它来覆盖内置应用的主题生成规则。

分发与分享你的主题

如果你希望将主题分享给其他用户，只需将其推送到 GitHub 等公开 Git 平台上。其他用户即可在 Omarchy 菜单中的 Install > Style > Theme 下通过该仓库 URL 直接安装。建议遵循 omarchy-[themename]-theme 的命名规范，这样安装后在主题菜单中会自动以清晰的 [themename] 名称显示。

你还可以向 omarchy-site 代码仓库 提交 Pull Request，将你的主题收录到官方额外主题页面中。