Mga Dotfile¶

Pangunahing naka-configure ang OmarOS sa pamamagitan ng tinatawag na mga dotfile na nakatira sa ~/.config. Itinuturing ang mga iyon na iyong mga file para sa iyong mga pagbabago. Ang mga file na nakatira sa /usr/share/omaros ay pagmamay-ari ng OmarOS mismo, at hindi mo dapat pinakikialaman ang mga iyon. Kung kailangan mong baguhin ang anumang bagay sa /usr/share/omaros, dapat mong patungan ang value sa ~/.config sa halip.

Maaaring i-edit ang mga pangunahing config nang direkta mula sa OmarOS menu (Super + Space), tulad ng Setup > Monitors, Setup > Keybindings, Setup > Input, at Setup > Config > [file]. Kapag ginawa mo ito sa ganitong paraan, anumang prosesong kailangang i-restart pagkatapos ng mga pag-edit sa config ay awtomatikong magre-restart pagkatapos mong umalis sa editor (Neovim bilang default — :wq, tandaan! — pero maaari mong baguhin iyon sa pamamagitan ng Setup > Defaults > Editor).

Narito ang listahan ng mga pangunahing file sa ~/.config at kung ano ang kinokontrol nila:

File	Layunin
`~/.config/hypr/hyprland.lua`	Ang pangunahing Hyprland config. Nilo-load ang mga OmarOS default kasama ang iyong mga override file sa ibaba. Matuto pa tungkol sa mga Hyprland config.
`~/.config/hypr/bindings.lua`	Ang iyong sariling mga keybinding at mga override ng mga default.
`~/.config/hypr/monitors.lua`	Kinokontrol ang iyong mga monitor, resolution, at posisyon.
`~/.config/hypr/input.lua`	Kinokontrol ang iyong keyboard layout, mouse, at mga setting ng trackpad.
`~/.config/hypr/looknfeel.lua`	Kinokontrol ang mga gap, hangganan, animasyon, at ang natitira pang hitsura.
`~/.config/hypr/autostart.lua`	Kinokontrol ang mga karagdagang prosesong sinimulan kasama ng session.
`~/.config/omaros/shell.json`	Kinokontrol ang OmarOS shell: posisyon ng bar, layout, at mga widget, pati na rin ang screensaver, lock, at mga timing ng idle.
`~/.config/foot/foot.ini`	Kinokontrol ang iyong terminal (ang foot ang default).
`~/.XCompose`	Tinutukoy ang iyong quick-access emoji at name/email autocomplete. Tiyakin na patakbuhin ang `omaros-restart-xcompose` pagkatapos gumawa ng mga pagbabago.

Kung marami kang gagawing pagbabago para i-tweak ang sarili mong setup, magandang ideya na i-backup ang lahat ng mga dotfile na ito. Ang Stow ay isang mahusay na paraan para gawin iyon.

Pagsisimula ng sarili mong mga app kasama ng session¶

Kung gusto mo ng isang bagay na tumakbo sa tuwing magla-log in ka — isang sync daemon, isang chat app, ang sarili mong script — ilagay ito sa ~/.config/hypr/autostart.lua:

o.launch_on_start("my-service")

Sinisimulan niyon ang command bilang bahagi ng session, kaya maayos itong nililinis kapag nag-log out ka ulit.

Pagpapatakbo ng mga script sa mga kaganapan ng sistema¶

Nagpapaputok ang OmarOS ng mga hook sa iilang sandali, at maaari mong ikabit ang sarili mong mga script sa mga ito. Nakatira sila sa ~/.config/omaros/hooks/<event>.d/, isang direktoryo bawat kaganapan, at ang bawat executable file roon ay tumatakbo kapag nangyari ang kaganapan:

Kaganapan	Kailan ito tumatakbo
`post-boot`	Kaagad pagkatapos magsimula ang desktop
`post-update`	Malapit sa dulo ng `omaros update`, pagkatapos ng mga package, migration, at pag-restart ng serbisyo, bago i-update ang mga mise tool
`pre-refresh-pacman`	Pagkatapos muling i-sync ng `omaros refresh pacman` ang package config, bago ito mag-update ng mga package; pinapatakbo ito ng isang paglipat ng channel sa parehong hakbang ng refresh na iyon
`theme-set`	Pagkatapos ng pagbabago ng tema (pangalan ng tema sa `$1`)
`font-set`	Pagkatapos ng pagbabago ng font (pangalan ng font sa `$1`)
`battery-low`	Kapag mababa na ang baterya (porsyento sa `$1`)

Ang pre-refresh-pacman hook ay kung saan nabibilang ang mga custom na repository o mga linyang IgnorePkg, dahil tumatakbo ito bago ang transaksyon ng package. Ang parehong update-related hook ay tumatakbo bilang iyong user pagkatapos alisin ng OmarOS ang naka-cache nitong sudo authorization, kaya ang isang hook na gumagamit ng sudo ay nangangailangan ng sarili nitong awtorisasyon at maaaring humingi ng iyong password.

Ang bawat isa sa mga direktoryong iyon ay mayroon nang .sample file na nagpapakita ng hugis ng isang hook — alisin ang .sample sa pangalan para paganahin ito. Para mag-install ng script na isinulat mo sa ibang lugar, gamitin ang omaros hook install post-boot ~/my-hook, na kinokopya ito papasok at ginagawang executable.

Ang OmarOS menu (Super + Space) ay maaaring palawakin gamit ang sarili mong mga row sa pamamagitan ng pag-edit ng ~/.config/omaros/extensions/omaros-menu.jsonc. Naka-key ang mga entry sa isang dotted id, at ang id ang naglalagay sa kanila sa tree, kaya ang personal ay lumalabas sa root menu at ang personal.notes ay lumalabas sa loob nito:

"personal": {"icon":"","label":"Personal"},
"personal.notes": {"icon":"󰎞","label":"Notes","action":"omaros-launch-editor ~/notes"},

Muling gamitin ang isang umiiral na id at papatungan mo ang row na iyon sa halip na magdagdag ng bago. May kasama ang file na lahat ng available na field ay nadokumento bilang mga komento.

Pagdaragdag ng sarili mong mga shell export, function, at alias¶

May kasamang maraming ergonomic alias at kapaki-pakinabang na function ang OmarOS, pero napakakaraniwan na gustong magdagdag ng sarili mo. Dapat mong idagdag ang parehong mga alias, function, at export sa ~/.bashrc. Hindi mapapatungan ang file na ito sa mga update. Kung gusto mong baguhin ang anumang OmarOS default, maaari mo ring ligtas na idagdag ang mga ito rito.

Pagbabago ng mga internal na file ng OmarOS¶

Tingnan mo, computer mo ito. Maaari mong gawin ang anumang gusto mo dito, pero ipapayo ko laban sa paggawa ng mga pagbabago sa mga file sa /usr/share/omaros nang direkta. Pagmamay-ari sila ng OmarOS pacman package, kaya mapapatungan lang ang iyong mga pagbabago sa susunod na update. Mas mabuti kang patungan na lang ang anumang default value na hindi mo gusto sa folder na ~/.config/* sa halip.

Maaari mong baguhin ang halos lahat sa ganoong paraan, tulad ng mga default na keybinding. I-edit lang ang ~/.config/hypr/bindings.lua para, halimbawa, palitan ang Obsidian ng Joplin (i-install gamit ang omaros-pkg-add joplin-bin):

o.rebind("SUPER + SHIFT + O", "Joplin", "joplin-desktop")

Tinatanggal ng o.rebind ang umiiral na binding bago idagdag ang kapalit nito. Kinukuha nito ang parehong mga argumento tulad ng o.bind, kasama ang mga launch helper at binding option. Gamitin ang o.bind para magdagdag ng binding, o ang hl.unbind para alisin ang isa nang hindi ito pinapalitan.

Kung ipipilit mong i-hack ang mga internal na file ng OmarOS, lumipat sa dev channel sa pamamagitan ng Update > Channel > Dev. Nagli-link iyon sa OmarOS sa isang git checkout ng source code sa ~/omaros, na malaya mong baguhin ayon sa gusto ng puso mo. Walang sinuman dito na magsasabi sa iyo kung ano ang gagawin!

Pag-reset ng anumang pagbabago¶

Kung magulo ang mga configuration, maaari mo silang laging ibalik sa mga default sa pamamagitan ng Update > Config sa OmarOS menu. O sa pamamagitan ng pagpapatakbo ng omaros reinstall configs para i-reset ang lahat.