Създаване на собствена тема

Можеш да добавяш свои теми в ~/.config/omaros/themes. Просто копирай някоя от съществуващите като основа (виж в /usr/share/omaros/themes), след което я настройвай до насита. Докато темата ти е в тази папка, тя ще бъде включена в менюто за избор на тема.

Основният файл, който трябва да настройваш, е colors.toml. Той дефинира набора от цветове, който след това се използва за генериране на конфигурации за терминала (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian и цялата обвивка на OmarOS (горна лента, меню, известия, OSD и заключен екран).

Можеш да използваш и включеното приложение Aether, за да създадеш нова тема чрез прекрасен GUI интерфейс, с който да си играеш с цветовете и да търсиш фонове. Просто го стартирай от мрежата с приложения с Super + Alt + Space.

Какво може да съдържа инсталирана тема

Тема, която сам напишеш в ~/.config/omaros/themes, може да съдържа каквото искаш — това е твоята машина и твоят файл и OmarOS прилага всичко.

Тема, която инсталираш от чуждо хранилище с omaros 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 на твоята машина.

OmarOS различава двете по това дали темата има собствено git хранилище в себе си, което е това, което omaros 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. А изображението за предварителен преглед можеш да създадеш с omaros plymouth preview.

Темизиране на приложения, които OmarOS не покрива

Ако използваш приложение, което не е в този списък, можеш сам да научиш OmarOS да го темизира с шаблон. Пусни файл в ~/.config/omaros/themed/, кръстен на конфигурацията, която генерира, плюс разширение .tpl, и напиши конфигурацията с {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} до {{ color15 }} и останалата част от палитрата като заместители. Всеки път, когато превключваш теми, файлът се регенерира с цветовете на тази тема.

В тази папка има напълно коментиран alacritty.toml.tpl.sample, от който да копираш — той изброява всяка променлива, която можеш да използваш, плюс модификаторите _strip и _rgb за приложения, които искат цветовете си без # или като десетичен RGB. Твоите шаблони имат предимство пред тези на OmarOS, така че можеш да използваш това и за да пренапишеш начина, по който вградено приложение се темизира.

Разпространение на твоята тема

Ако искаш да разпространяваш темата си, така че други да могат да я използват, трябва да я сложиш на публичен git сървър, като GitHub. Тогава хората могат да я инсталират от Инсталирай > Стил > Тема в менюто на OmarOS, като използват този URL. Препоръчително е да следваш конвенцията за именуване omaros-[themename]-theme, тъй като темата ще се показва правилно просто като [themename] в менюто за избор на тема след инсталиране.

Това останало [themename] става името на директорията на темата, така че трябва да бъде такова, което OmarOS може безопасно да предава наоколо: трябва да започва с буква, цифра или долна черта, а останалата част може да съдържа букви, цифри, ., _, + и -. Главните букви се преобразуват в малки вместо теб, но всичко останало — интервал, кавичка, неанглийски знак — се отхвърля при инсталиране, вместо да се превърне в име на директория. Така omaros-tokyo-night-theme, omaros-flexoki_light-theme и omaros-c++-theme се инсталират без проблем.

Не забравяй, че щом бъде инсталирана от хранилище, всеки .lua, конфигурация на терминал или vscode.json, който доставя, се изпуска, така че не гради темата около тях.