Dotfiles¶
OmarOS konfigureras främst via de så kallade dotfiles som bor i ~/.config. De betraktas som dina filer för dina ändringar. Filerna som bor i /usr/share/omaros tillhör OmarOS självt, och du bör inte hålla på och pilla med dem. Om du behöver ändra något i /usr/share/omaros bör du skriva över värdet i ~/.config istället.
Nyckelkonfigurationerna kan redigeras direkt från OmarOS-menyn (Super + Space), som Installation > Skärmar, Installation > Tangentgenvägar, Installation > Input och Installation > Config > [file]. När du gör det på det här sättet startas varje process som behöver startas om efter configredigeringar automatiskt om efter att du har avslutat editorn (Neovim som standard — :wq, kom ihåg! — men du kan ändra det via Installation > Standarder > Editor).
Här är en lista över nyckelfilerna i ~/.config och vad de styr:
| File | Purpose |
|---|---|
~/.config/hypr/hyprland.lua |
Huvudkonfigen för Hyprland. Laddar OmarOS-standarderna plus dina åsidosättande filer nedan. Läs mer om Hyprland-konfigar. |
~/.config/hypr/bindings.lua |
Dina egna tangentbindningar och åsidosättningar av standarderna. |
~/.config/hypr/monitors.lua |
Styr dina skärmar, upplösning och position. |
~/.config/hypr/input.lua |
Styr din tangentbordslayout, mus och styrplatta. |
~/.config/hypr/looknfeel.lua |
Styr mellanrum, kantlinjer, animationer och resten av utseendet. |
~/.config/hypr/autostart.lua |
Styr extra processer som startas med sessionen. |
~/.config/omaros/shell.json |
Styr OmarOS-skalet: fältposition, layout och widgetar, plus skärmsläckare, lås och viloperiodstider. |
~/.config/foot/foot.ini |
Styr din terminal (foot är standard). |
~/.XCompose |
Definierar din snabbåtkomst-emoji och namn/e-post-autokomplettering. Se till att köra omaros-restart-xcompose efter att du gjort ändringar. |
Om du till slut gör många ändringar för att finslipa din egen uppsättning är det en god idé att säkerhetskopiera alla dessa dotfiles. Stow är ett utmärkt sätt att göra det.
Starta dina egna appar med sessionen¶
Om du vill att något ska köras varje gång du loggar in — en synk-daemon, en chattapp, ditt eget skript — lägg det i ~/.config/hypr/autostart.lua:
Det startar kommandot som en del av sessionen, så det städas upp ordentligt när du loggar ut igen.
Köra skript vid systemhändelser¶
OmarOS avfyrar hooks vid en handfull tillfällen, och du kan hänga dina egna skript på dem. De bor i ~/.config/omaros/hooks/<event>.d/, en katalog per händelse, och varje körbar fil där inne körs när händelsen inträffar:
| Event | When it runs |
|---|---|
post-boot |
Direkt efter att skrivbordet har startat |
post-update |
Nära slutet av omaros update, efter paket, migrationer och tjänsteomstarter, innan mise-verktyg uppdateras |
pre-refresh-pacman |
Efter att omaros refresh pacman synkar om paketkonfigurationen, innan den uppdaterar paket; en kanalväxlare kör den under samma uppdateringssteg |
theme-set |
Efter ett temabyte (temanamn i $1) |
font-set |
Efter ett typsnittsbyte (typsnittsnamn i $1) |
battery-low |
När batteriet börjar bli lågt (procent i $1) |
Den pre-refresh-pacman-hooken är där anpassade repositories eller IgnorePkg-rader hör hemma, eftersom den körs före pakettransaktionen. Båda uppdateringsrelaterade hookar körs som din användare efter att OmarOS rensat sin cachade sudo-behörighet, så en hook som använder sudo behöver sin egen behörighet och kan be om ditt lösenord.
Var och en av dessa kataloger innehåller redan en .sample-fil som visar hur en hook ser ut — ta bort .sample från namnet för att sätta den i arbete. För att installera ett skript du har skrivit någon annanstans, använd omaros hook install post-boot ~/my-hook, vilket kopierar in det och gör det körbart.
Lägga till dina egna menyposter¶
OmarOS-menyn (Super + Space) kan utökas med dina egna rader genom att redigera ~/.config/omaros/extensions/omaros-menu.jsonc. Poster nycklas av ett punktid, och id:t är det som placerar dem i trädet, så personal dyker upp på rotmenyn och personal.notes dyker upp inuti den:
"personal": {"icon":"","label":"Personal"},
"personal.notes": {"icon":"","label":"Notes","action":"omaros-launch-editor ~/notes"},
Återanvänd ett befintligt id så åsidosätter du den raden istället för att lägga till en ny. Filen levereras med alla tillgängliga fält dokumenterade som kommentarer.
Lägga till dina egna shell-exporter, funktioner och alias¶
OmarOS levereras med en massa ergonomiska alias och hjälpsamma funktioner, men det är väldigt vanligt att vilja lägga till egna. Du bör lägga till både alias, funktioner och exporter i ~/.bashrc. Den här filen skrivs inte över vid uppdateringar. Om du vill ändra någon av OmarOS-standarderna kan du också säkert lägga till dem här.
Ändra interna OmarOS-filer¶
Okej, det här är din dator. Du kan göra vad du vill med den, men jag avråder från att göra ändringar i filerna i /usr/share/omaros direkt. De tillhör OmarOSs pacman-paket, så dina ändringar skrivs helt enkelt över vid nästa uppdatering. Det är bättre att bara skriva över de standardvärden du inte gillar i mappen ~/.config/* istället.
Du kan ändra ungefär allt på det sättet, som standard-tangentbindningarna. Redigera bara ~/.config/hypr/bindings.lua för att till exempel ersätta Obsidian med Joplin (installera med omaros-pkg-add joplin-bin):
o.rebind tar bort den befintliga bindningen innan den lägger till ersättningen. Den tar samma argument som o.bind, inklusive starhjälpare och bindningsalternativ. Använd o.bind för att lägga till en bindning, eller hl.unbind för att ta bort en utan att ersätta den.
Om du insisterar på att hacka på de interna OmarOS-filerna, växla till dev-kanalen via Uppdatera > Channel > Dev. Det länkar OmarOS till en git-checkout av källkoden i ~/omaros, som du fritt kan ändra i hjärtans lust. Det finns ingen här som kan säga åt dig vad du ska göra!
Återställa ändringar¶
Om du till slut rör till konfigurationerna kan du alltid återställa dem till standarderna via Uppdatera > Config i OmarOS-menyn. Eller genom att köra omaros reinstall configs för att återställa allt.