Hoppa till innehållet
Chapters
  1. Välkommen till Omarchy!
  2. Kom igång
  3. Kommer du från Mac eller Windows
  4. Navigering
  5. Den översta raden
  6. Teman
  7. Snabbtangenter
  8. Enhetligt urklipp & historik
  9. Påminnelser
  10. Aviseringar
  11. Textextrahering & diktering
  12. Skärmbilder och inspelning
  13. Växlar, inaktivitet och skärmsläckaren
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Utvecklingsverktyg
  19. Shellverktyg
  20. Shellfunktioner
  21. TUIs
  22. Grafiska program
  23. Webbläsare
  24. Kommersiella appar/tjänster
  25. Webbappar
  26. Gaming
  27. Fylla i PDF:er
  28. Windows VM
  29. Andra paket
  30. Uppdateringar
  31. Dotfiles
  32. Shell-plugins
  33. Bildskärmar
  34. Tangentbord, Mus, Styrplatta
  35. Nätverk
  36. Systemvila
  37. Hårdvaruautentisering
  38. Typsnitt
  39. Bakgrunder
  40. Prompt
  41. Branding
  42. Vanliga justeringar
  43. Skapa ditt eget tema
  44. Mac-stöd
  45. Felsökning
  46. FAQ
  47. Systemögonblicksbilder
  48. Säkerhet
  49. Omarchy på...
  50. Installation med dual boot
  51. Obevakade installationer

Handbok

Dotfiles

Omarchy 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/omarchy tillhör Omarchy självt, och du bör inte hålla på och pilla med dem. Om du behöver ändra något i /usr/share/omarchy bör du skriva över värdet i ~/.config istället.

Nyckelkonfigurationerna kan redigeras direkt från Omarchy-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 Omarchy-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/omarchy/shell.json Styr Omarchy-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 omarchy-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:

o.launch_on_start("my-service")

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

Omarchy avfyrar hooks vid en handfull tillfällen, och du kan hänga dina egna skript på dem. De bor i ~/.config/omarchy/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 omarchy update, efter paket, migrationer och tjänsteomstarter, innan mise-verktyg uppdateras
pre-refresh-pacman Efter att omarchy 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 Omarchy 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 omarchy hook install post-boot ~/my-hook, vilket kopierar in det och gör det körbart.

Lägga till dina egna menyposter

Omarchy-menyn (Super + Space) kan utökas med dina egna rader genom att redigera ~/.config/omarchy/extensions/omarchy-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":"omarchy-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

Omarchy 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 Omarchy-standarderna kan du också säkert lägga till dem här.

Ändra interna Omarchy-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/omarchy direkt. De tillhör Omarchys 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 omarchy-pkg-add joplin-bin):

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

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 Omarchy-filerna, växla till dev-kanalen via Uppdatera > Channel > Dev. Det länkar Omarchy till en git-checkout av källkoden i ~/omarchy, 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 Omarchy-menyn. Eller genom att köra omarchy reinstall configs för att återställa allt.