Dotfiler

Omarchy konfigureres primært via de såkaldte dotfiler, som ligger i ~/.config. De betragtes som dine filer, hvor du foretager dine ændringer. Filerne i /usr/share/omarchy tilhører selve Omarchy, og dem bør du ikke rode med. Hvis du har brug for at ændre noget i /usr/share/omarchy, bør du i stedet tilsidesætte værdien i ~/.config.

De vigtigste konfigurationer kan redigeres direkte fra Omarchy-menuen (Super + Space), f.eks. via Opsætning > Skærme, Opsætning > Tastaturgenveje, Opsætning > Input og Opsætning > Konfiguration > [fil]. Når du gør det på denne måde, bliver alle processer, der skal genstartes efter ændringer i konfigurationen, automatisk genstartet, når du afslutter editoren (Neovim som standard — husk :wq! — men du kan ændre det via Opsætning > Standarder > Editor).

Her er en liste over de vigtigste filer i ~/.config, og hvad de styrer:

Fil	Formål
~/.config/hypr/hyprland.lua	Hyprlands primære konfiguration. Indlæser Omarchys standardindstillinger samt dine tilsidesættelsesfiler nedenfor. Læs mere om Hyprland-konfigurationer.
~/.config/hypr/bindings.lua	Dine egne tastaturgenveje og tilsidesættelser af standardindstillingerne.
~/.config/hypr/monitors.lua	Styrer dine skærme, deres opløsning og placering.
~/.config/hypr/input.lua	Styrer dit tastaturlayout samt indstillingerne for mus og pegefelt.
~/.config/hypr/looknfeel.lua	Styrer mellemrum, kanter, animationer og resten af udseendet.
~/.config/hypr/autostart.lua	Styrer ekstra processer, der startes sammen med sessionen.
~/.config/omarchy/shell.json	Styrer Omarchy-shell'en: bjælkens placering, layout og widgets samt pauseskærm, låsning og tidsgrænser for inaktivitet.
~/.config/foot/foot.ini	Styrer din terminal (foot er standarden).
~/.XCompose	Definerer dine genveje til emoji og autofuldførelse af navn/e-mail. Sørg for at køre omarchy-restart-xcompose, når du har foretaget ændringer.

Hvis du foretager mange ændringer for at finjustere din egen opsætning, er det en god idé at sikkerhedskopiere alle disse dotfiler. Stow er en fremragende måde at gøre det på.

Start dine egne apps sammen med sessionen #

Hvis du vil have noget til at køre, hver gang du logger ind — en synkroniseringsdæmon, en chatapp eller dit eget script — skal du føje det til ~/.config/hypr/autostart.lua:

o.launch_on_start("my-service")

Det starter kommandoen som en del af sessionen, så den bliver lukket korrekt ned, når du logger ud igen.

Kør scripts ved systemhændelser #

Omarchy aktiverer hooks på en række tidspunkter, og du kan knytte dine egne scripts til dem. De ligger i ~/.config/omarchy/hooks/<event>.d/, én mappe pr. hændelse, og alle eksekverbare filer deri køres, når hændelsen indtræffer:

Hændelse	Hvornår den køres
post-boot	Lige efter skrivebordsmiljøet er startet
post-update	Under omarchy update, efter pakker og migreringer
pre-refresh-pacman	Før omarchy refresh pacman synkroniserer pakkekonfigurationen igen
theme-set	Efter et temaskift (temaets navn i $1)
font-set	Efter et skrifttypeskift (skrifttypens navn i $1)
battery-low	Når batteriniveauet bliver lavt (procent i $1)

Hver af disse mapper indeholder allerede en .sample-fil, der viser, hvordan et hook skal se ud — fjern .sample fra navnet for at tage det i brug. Hvis du vil installere et script, som du har skrevet et andet sted, skal du bruge omarchy hook install post-boot ~/my-hook, som kopierer det ind og gør det eksekverbart.

Tilføj dine egne menupunkter #

Omarchy-menuen (Super + Space) kan udvides med dine egne rækker ved at redigere ~/.config/omarchy/extensions/omarchy-menu.jsonc. Hvert punkt identificeres med et punktsepareret id, og id'et bestemmer dets placering i træet. Derfor vises personal i rodmenuen, mens personal.notes vises inde i den:

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

Hvis du genbruger et eksisterende id, tilsidesætter du den pågældende række i stedet for at tilføje en ny. Filen leveres med kommentarer, der dokumenterer alle tilgængelige felter.

Tilføj dine egne shell-eksporter, funktioner og aliasser #

Omarchy leveres med en række praktiske aliasser og nyttige funktioner, men det er meget almindeligt at ville tilføje sine egne. Du bør tilføje aliasser, funktioner og eksporter i ~/.bashrc. Denne fil bliver ikke overskrevet ved opdateringer. Hvis du vil ændre nogle af Omarchys standardindstillinger, kan du også roligt tilføje dem her.

Rediger interne Omarchy-filer #

Hør, det er din computer. Du kan gøre med den, hvad du vil, men jeg vil fraråde at ændre filerne i /usr/share/omarchy direkte. De tilhører Omarchys pacman-pakke, så dine ændringer bliver ganske enkelt overskrevet ved næste opdatering. Det er bedre i stedet at tilsidesætte de standardværdier, du ikke kan lide, i mappen ~/.config/*.

På den måde kan du ændre stort set alt, f.eks. standardtastaturgenvejene. Du skal blot redigere ~/.config/hypr/bindings.lua for eksempelvis at erstatte Obsidian med Joplin (installer med omarchy-pkg-add joplin-bin):

hl.unbind("SUPER + SHIFT + O")
o.bind("SUPER + SHIFT + O", "Joplin", "joplin-desktop")

Hvis du insisterer på at rode med de interne Omarchy-filer, skal du skifte til udviklingskanalen via Opdatering > Kanal > Udvikling. Det forbinder Omarchy med en git-checkout af kildekoden i ~/omarchy, som du frit kan ændre efter hjertets lyst. Der er ingen her, der skal fortælle dig, hvad du skal gøre!

Nulstil ændringer #

Hvis du ender med at lave rod i konfigurationerne, kan du altid gendanne standardindstillingerne via Opdatering > Konfiguration i Omarchy-menuen. Du kan også køre omarchy reinstall configs for at nulstille det hele.