Руководство
Создание собственной темы
Вы можете добавить собственные темы в ~/.config/omarchy/themes. Просто скопируйте одну из существующих в качестве основы (ищите в /usr/share/omarchy/themes), а затем настройте по своему вкусу. Пока ваша тема находится внутри этой папки, она будет включена в меню выбора темы.
Главный файл, который вам нужно отредактировать, - это colors.toml. Он определяет набор цветов, который затем используется для генерации конфигураций для терминала (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian и всей оболочки Omarchy (верхняя панель, меню, уведомления, OSD и экран блокировки).
Вы также можете воспользоваться входящим в комплект приложением Aether, чтобы создать новую тему с помощью приятного GUI-интерфейса, где можно возиться с цветами и искать фоновые изображения. Просто запустите его из сетки приложений по Super + Alt + Space.
Что может содержать установленная тема
Тема, которую вы написали сами в ~/.config/omarchy/themes, может содержать что угодно - это ваша машина и ваш файл, и Omarchy применит всё это.
Тема, которую вы устанавливаете из чужого репозитория с помощью omarchy theme install, сохраняет всё, что относится к цвету, и теряет горстку файлов, которые запускали бы код на вашей машине: любой файл .lua, конфигурации терминала (alacritty.toml, foot.ini, ghostty.conf, kitty.conf) и vscode.json. hyprland.lua темы - это Lua, который ваш композитор запускает при входе в систему, конфигурация терминала указывает программу, которую запускает ваш терминал, а vscode.json указывает расширение VSCode для установки. Установка чужой темы должна менять то, как выглядит ваш рабочий стол, а не то, что он запускает.
Всё остальное по-прежнему работает точно так, как написал автор темы - btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, фоновые изображения и предварительные просмотры сохраняются. Только то, что было отброшено, заново генерируется из colors.toml на вашей машине.
Omarchy различает их по тому, есть ли у темы внутри собственный git-репозиторий, который и оставляет после себя omarchy theme install при клонировании. Так тема, которую вы написали, остаётся вашей, а та, которую вы скачали из интернета, остаётся цветами.
Светлый режим
Если вы делаете тему со светлым режимом, установите mode = "light" в верхней части вашего colors.toml. Тогда она будет автоматически сочетаться со светлым режимом для всех приложений. (Старый способ - бросить пустой файл под названием 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.png и preview-unlock.png, будут перечислены в разделе Внешний вид > Разблокировка. Ваш 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, используя этот URL. Рекомендуется следовать соглашению об именах omarchy-[themename]-theme, так как после установки тема будет корректно отображаться в меню выбора темы просто как [themename].
Этот остающийся [themename] становится именем каталога темы, поэтому оно должно быть таким, которое Omarchy может безопасно передавать из рук в руки: оно должно начинаться с буквы, цифры или подчёркивания, а остальная часть может содержать буквы, цифры, ., _, + и -. Заглавные буквы будут приведены к строчным за вас, но всё остальное - пробел, кавычка, символ не из английского алфавита - будет отклонено при установке, а не превращено в имя каталога. Так что omarchy-tokyo-night-theme, omarchy-flexoki_light-theme и omarchy-c++-theme устанавливаются без проблем.
Помните, что как только тема установлена из репозитория, любой файл .lua, конфигурация терминала или vscode.json в её составе отбрасывается, так что не стройте тему на них.
Вы можете добавить свою тему на страницу дополнительных тем, отправив pull request в репозиторий omarchy-site.