跳转至

制作你自己的主题

本文译自 The Omarchy Manual — Making your own theme,同步自 basecamp/omarchy@ed7bae4。术语以 TERMS.md 为准。

你可以把自己的主题放进 ~/.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 打开应用菜单启动它。

浅色模式

做浅色主题的话,在 colors.toml 顶部设 mode = "light",所有应用就会自动配套浅色模式。(老办法——在主题根目录放一个名为 light.mode 的空文件——也依然有效。)

图标配色

想让文件管理器的图标与主题同色系,加一个名为 icons.theme 的文件,写上想用的图标集名称。默认可选:Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow

解锁图

unlock.pngpreview-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 可供参考——它列出全部可用变量,以及 _strip_rgb 修饰符,供那些不要 # 或要十进制 RGB 的应用使用。你的模板优先于 Omarchy 自带的,所以也能借此覆盖内置应用的上主题方式。

分发你的主题

想让别人用上你的主题,需要放到公开 git 服务器(比如 GitHub)。之后大家就能在 Omarchy 菜单经 Install > Style > Theme 用 URL 安装。建议遵循 omarchy-[themename]-theme 命名惯例——这样安装后主题在选择菜单里会正确显示为 [themename]

omarchy-site 仓库发 pull request,即可让你的主题登上额外主题页