Dotfiles

OmarOS se konfiguruje především prostřednictvím takzvaných dotfiles, které žijí v adresáři ~/.config. Ty jsou považovány za vaše soubory pro vaše změny. Soubory, které žijí v adresáři /usr/share/omaros, patří samotné OmarOS a neměli byste se v nich šťourat. Pokud potřebujete cokoli v adresáři /usr/share/omaros změnit, měli byste místo toho přepsat hodnotu v adresáři ~/.config.

Klíčové konfigurace lze upravovat přímo z nabídky OmarOS (Super + Space), například Nastavení > Monitory, Nastavení > Klávesové zkratky, Nastavení > Vstup a Nastavení > Config > [file]. Když to uděláte tímto způsobem, každý proces, který po úpravách konfigurace potřebuje restartovat automaticky, se restartuje poté, co zavřete editor (ve výchozím nastavení Neovim — :wq, pamatujte! — ale to můžete změnit v části Nastavení > Výchozí > Editor).

Tady je seznam klíčových souborů v adresáři ~/.config a toho, co ovládají:

File	Účel
~/.config/hypr/hyprland.lua	Hlavní konfigurace Hyprlandu. Načítá výchozí nastavení OmarOS plus vaše soubory pro přepsání níže. Další informace o konfiguracích Hyprlandu.
~/.config/hypr/bindings.lua	Vaše vlastní klávesové zkratky a přepsání výchozích nastavení.
~/.config/hypr/monitors.lua	Ovládá vaše monitory, rozlišení a polohu.
~/.config/hypr/input.lua	Ovládá rozložení vaší klávesnice, nastavení myši a trackpadu.
~/.config/hypr/looknfeel.lua	Ovládá mezery, rámečky, animace a zbytek vzhledu.
~/.config/hypr/autostart.lua	Ovládá další procesy spuštěné se relací.
~/.config/omaros/shell.json	Ovládá shell OmarOS: polohu panelu, rozložení a widgety, plus časy spořiče obrazovky, zamykání a nečinnosti.
~/.config/foot/foot.ini	Ovládá váš terminál (foot je výchozí).
~/.XCompose	Definuje vaše emoji s rychlým přístupem a automatické doplňování jména/e-mailu. Po provedení změn nezapomeňte spustit příkaz omaros-restart-xcompose.

Pokud nakonec uděláte spoustu změn při ladění vlastního nastavení, je dobré si všechny tyto dotfiles zazálohovat. Stow je skvělý způsob, jak to udělat.

Spouštění vlastních aplikací se relací

Pokud chcete, aby se při každém přihlášení něco spustilo — démon pro synchronizaci, chatovací aplikace, vlastní skript — vložte to do souboru ~/.config/hypr/autostart.lua:

o.launch_on_start("my-service")

Tím se příkaz spustí jako součást relace, takže při odhlášení se zase řádně uklidí.

Spouštění skriptů při systémových událostech

OmarOS spouští háčky v několika okamžicích a můžete na ně zavěsit vlastní skripty. Žijí v adresáři ~/.config/omaros/hooks/<event>.d/, jeden adresář pro každou událost, a každý spustitelný soubor v něm se spustí, když událost nastane:

Event	Kdy běží
post-boot	Hned po spuštění pracovního prostředí
post-update	Ke konci příkazu omaros update, po balíčcích, migracích a restartech služeb, před aktualizací nástrojů mise
pre-refresh-pacman	Poté, co příkaz omaros refresh pacman znovu synchronizuje konfiguraci balíčků, předtím, než balíčky aktualizuje; přepnutí kanálu ho spustí během stejného kroku obnovení
theme-set	Po změně motivu (název motivu v proměnné $1)
font-set	Po změně písma (název písma v proměnné $1)
battery-low	Když je baterie vybitá (procenta v proměnné $1)

Háček pre-refresh-pacman je místo, kam patří vlastní repozitáře nebo řádky IgnorePkg, protože běží před transakcí balíčků. Oba háčky související s aktualizací běží pod vaším uživatelem poté, co OmarOS vymaže oprávnění sudo z mezipaměti, takže háček používající sudo potřebuje vlastní oprávnění a může si vyžádat vaše heslo.

Každý z těchto adresářů již obsahuje soubor .sample ukazující tvar háčku — odeberte příponu .sample z názvu, abyste ho uvedli do provozu. Chcete-li nainstalovat skript, který jste napsali jinde, použijte příkaz omaros hook install post-boot ~/my-hook, který ho zkopíruje a udělá z něho spustitelný soubor.

Přidávání vlastních položek nabídky

Nabídku OmarOS (Super + Space) lze rozšířit vlastními řádky úpravou souboru ~/.config/omaros/extensions/omaros-menu.jsonc. Položky jsou klíčovány tečkovaným id a toto id je umisťuje do stromu, takže personal se objeví v kořenové nabídce a personal.notes se objeví uvnitř ní:

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

Znovu použijte existující id a tento řádek přepíšete, místo abyste přidali nový. Soubor je dodáván se všemi dostupnými poli zdokumentovanými jako komentáře.

Přidávání vlastních exportů, funkcí a aliasů shellu

OmarOS je dodávána s řadou ergonomických aliasů a užitečných funkcí, ale je velmi běžné, že chcete přidat své vlastní. Aliasy, funkce i exporty byste měli přidat do souboru ~/.bashrc. Tento soubor nebude při aktualizacích přepsán. Pokud chcete změnit některá z výchozích nastavení OmarOS, můžete je zde také bezpečně přidat.

Změna vnitřních souborů OmarOS

Podívejte, toto je váš počítač. Můžete si s ním dělat, co chcete, ale doporučoval bych neprovádět změny přímo v souborech v adresáři /usr/share/omaros. Patří do balíčku pacman pro OmarOS, takže vaše změny budou při příští aktualizaci jednoduše přepsány. Místo toho je lepší jednoduše přepsat všechny výchozí hodnoty, které se vám nelíbí, ve složce ~/.config/*.

Tímto způsobem můžete změnit téměř vše, například výchozí klávesové zkratky. Stačí upravit soubor ~/.config/hypr/bindings.lua tak, že například nahradíte Obsidian programem Joplin (nainstalujte pomocí příkazu omaros-pkg-add joplin-bin):

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

Příkaz o.rebind odstraní existující vazbu před přidáním její náhrady. Přijímá stejné argumenty jako o.bind, včetně pomocných funkcí pro spouštění a možností vazeb. K přidání vazby použijte příkaz o.bind, nebo k jejímu odebrání bez nahrazení příkaz hl.unbind.

Pokud trváte na hackování vnitřních souborů OmarOS, přepněte na kanál dev v části Aktualizovat > Kanál > Dev. Tím se OmarOS propojí s gitovým checkoutem zdrojového kódu v adresáři ~/omaros, který můžete libovolně měnit dle libosti. Nikdo vám tu nebude říkat, co máte dělat!

Resetování jakýchkoli změn

Pokud nakonec uděláte v konfiguracích nepořádek, můžete je vždy vrátit do výchozích nastavení v části Aktualizovat > Config v nabídce OmarOS. Nebo spuštěním příkazu omaros reinstall configs, který vše resetuje.