Приручник
Dotfiles
Omarchy се првенствено конфигурише кроз такозване dotfiles који живе у ~/.config. То се сматрају вашим датотекама за ваше промене. Датотеке које живе у /usr/share/omarchy припадају самом Omarchy-ју и не бисте требали да се петљате са њима. Ако треба да промените било шта у /usr/share/omarchy, требало би да вредност уместо тога препишете у ~/.config.
Кључне конфигурације могу се уређивати директно из Omarchy менија (Super + Space), попут Подешавање > Монитори, Подешавање > Пречице, Подешавање > Унос и Подешавање > Config > [file]. Када то радите на овај начин, сваки процес који треба поново покренути након уређивања конфигурације аутоматски ће бити поново покренут када изађете из уређивача (Neovim подразумевано - :wq, запамтите! - али то можее променити преко Подешавање > Defaults > Editor).
Ево списка кључних датотека у ~/.config и шта контролишу:
| File | Purpose |
|---|---|
~/.config/hypr/hyprland.lua |
Главна Hyprland конфигурација. Учитава Omarchy подразумеване вредности плус ваше датотеке за преписивање испод. Сазнајте више о Hyprland конфигурацијама. |
~/.config/hypr/bindings.lua |
Ваше сопствене пречице и преписивања подразумеваних. |
~/.config/hypr/monitors.lua |
Контролише ваше мониторе, резолуцију и положај. |
~/.config/hypr/input.lua |
Контролише распоред тастатуре, миш и подешавања тачпеда. |
~/.config/hypr/looknfeel.lua |
Контролише размаке, ивице, анимације и остатак изгледа. |
~/.config/hypr/autostart.lua |
Контролише додатне процесе покренуте са сесијом. |
~/.config/omarchy/shell.json |
Контролише Omarchy љуску: положај траке, распоред и виџете, плус времена чувара екрана, закључавања и мировања. |
~/.config/foot/foot.ini |
Контролише ваш терминал (foot је подразумевани). |
~/.XCompose |
Дефинише ваш брзи приступ емоџијима и аутокомплетирање имена/е-поште. Обавезно покрените omarchy-restart-xcompose након промена. |
Ако на крају направите много промена да бисте подесили сопствену поставку, добро је да направите резервну копију свих ових dotfiles-а. Stow је одличан начин за то.
Покретање сопствених апликација са сесијом
Ако желите да се нешто покреће сваки пут када се пријавите - демон за синхронизацију, апликација за ћаскање, ваш сопствени скрипт - ставите то у ~/.config/hypr/autostart.lua:
o.launch_on_start("my-service")
То покреће команду као део сесије, па се правилно чисти када се одјавите.
Покретање скрипти на системске догађаје
Omarchy окида куке у неколико тренутака и на њих можее окачити сопствене скрипте. Живе у ~/.config/omarchy/hooks/<event>.d/, по један директоријум по догађају, а свака извршна датотека тамо се покреће када се догађај деси:
| Event | When it runs |
|---|---|
post-boot |
Одмах након покретања радне површине |
post-update |
При крају omarchy update, након пакета, миграција и поновних покретања сервиса, пре ажурирања mise алата |
pre-refresh-pacman |
Након што omarchy refresh pacman поново синхронизује конфигурацију пакета, пре ажурирања пакета; промена канала га покреће током истог корака освежавања |
theme-set |
Након промене теме (име теме у $1) |
font-set |
Након промене фонта (име фонта у $1) |
battery-low |
Када се батерија испразни (проценат у $1) |
Кука pre-refresh-pacman је место где припадају прилагођени репозиторијуми или линије IgnorePkg, јер се покреће пре трансакције пакета. Обе куке у вези са ажурирањем извршавају се као ваш корисник након што Omarchy обрише кеширану sudo ауторизацију, па кука која користи sudo треба сопствену ауторизацију и може тражити лозинку.
Сваки од тих директоријума већ садржи .sample датотеку која показује облик куке - уклоните .sample из имена да је ставите у рад. За инсталирање скрипта који сте написали негде другде користите omarchy hook install post-boot ~/my-hook, што га копира и чини извршним.
Додавање сопствених уноса у мени
Omarchy мени (Super + Space) може се проширити сопственим редовима уређивањем ~/.config/omarchy/extensions/omarchy-menu.jsonc. Уноси су кључани тачкастим id-јем, а id је оно што их смешта у стабло, па се personal појављује у коренском менију, а personal.notes унутар њега:
"personal": {"icon":"","label":"Personal"},
"personal.notes": {"icon":"","label":"Notes","action":"omarchy-launch-editor ~/notes"},
Поново користите постојећи id и уместо додавања новог преписујете тај ред. Датотека долази са свим доступним пољима документованим као коментари.
Додавање сопствених shell извоза, функција и алијаса
Omarchy долази са гомилом ергономских алијаса и корисних функција, али је веома често желети додати сопствене. И алијасе, функције и извозе треба додати у ~/.bashrc. Ова датотека неће бити преписана при ажурирањима. Ако желите да промените било коју Omarchy подразумевану вредност, можее их безбедно додати и овде.
Мењање унутрашњих Omarchy датотека
Гледајте, ово је ваш рачунар. Можете радити шта год желите са њим, али саветовао бих да не мењате датотеке у /usr/share/omarchy директно. Оне припадају Omarchy pacman пакету, па ће ваше промене једноставно бити преписане при следећем ажурирању. Боље вам је да само препишете све подразумеване вредности које вам се не свиђају у фасцикли ~/.config/*.
На тај начин можее променити готово све, попут подразумеваних пречица. Једноставно уредите ~/.config/hypr/bindings.lua да, рецимо, замените Obsidian са Joplin (инсталирајте помоћу omarchy-pkg-add joplin-bin):
o.rebind("SUPER + SHIFT + O", "Joplin", "joplin-desktop")
o.rebind уклања постојећу везу пре додавања њене замене. Прима исте аргументе као o.bind, укључујући помоћнике за покретање и опције везивања. Користите o.bind да додате везу или hl.unbind да је уклоните без замене.
Ако инсистирате на хакирању унутрашњих Omarchy датотека, пребаците се на dev канал преко Ажурирај > Channel > Dev. То повезује Omarchy са git чекаутом изворног кода у ~/omarchy, који слободно можее мењати до миле воље. Овде нема никога да вам каже шта да радите!
Ресетовање свих промена
Ако на крају направите збрку са конфигурацијама, увек их можее вратити на подразумеване преко Ажурирај > Config у Omarchy менију. Или покретањем omarchy reinstall configs да ресетујете све.