Zum Inhalt springen
Chapters
  1. Willkommen bei Omarchy!
  2. Erste Schritte
  3. Von Mac oder Windows kommen
  4. Navigation
  5. Die obere Leiste
  6. Themes
  7. Tastenkombinationen
  8. Einheitliche Zwischenablage & Verlauf
  9. Erinnerungen
  10. Hinweise
  11. Textextraktion & Diktat
  12. Screenshots & Aufnahme
  13. Toggles, Leerlauf und der Bildschirmschoner
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Entwicklungs-Tools
  19. Shell-Werkzeuge
  20. Shell-Funktionen
  21. TUIs
  22. GUIs
  23. Browser
  24. Kommerzielle Apps/Dienste
  25. Web-Apps
  26. Gaming
  27. PDFs ausfüllen
  28. Windows-VM
  29. Andere Pakete
  30. Updates
  31. Dotfiles
  32. Shell-Plugins
  33. Monitore
  34. Tastatur, Maus, Trackpad
  35. Netzwerk
  36. Ruhezustand des Systems
  37. Hardware-Authentifizierung
  38. Schriftarten
  39. Hintergründe
  40. Prompt
  41. Branding
  42. Häufige Anpassungen
  43. Dein eigenes Theme erstellen
  44. Mac-Unterstützung
  45. Fehlerbehebung
  46. Häufige Fragen
  47. Systemsnapshots
  48. Sicherheit
  49. Omarchy auf...
  50. Dual-Boot-Installation
  51. Unbeaufsichtigte Installationen

Handbuch

Dein eigenes Theme erstellen

Du kannst deine eigenen Themes zu ~/.config/omarchy/themes hinzufügen. Kopiere einfach eines der vorhandenen Themes als Grundlage (sieh in /usr/share/omarchy/themes nach) und passe es dann nach Herzenslust an. Solange dein Theme in diesem Ordner liegt, wird es im Menü zur Theme-Auswahl aufgenommen.

Die wichtigste Datei, die du anpassen musst, ist colors.toml. Sie definiert das Farbschema, aus dem dann Konfigurationen für das Terminal (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian und die gesamte Omarchy-Shell (obere Leiste, Menü, Benachrichtigungen, OSD und Sperrbildschirm) generiert werden.

Du kannst auch die mitgelieferte Anwendung Aether verwenden, um ein neues Theme über eine hübsche GUI-Oberfläche zu erstellen, mit Farben zu spielen und nach Hintergründen zu suchen. Starte sie einfach aus der App-Übersicht mit Super + Alt + Space.

Was ein installiertes Theme enthalten darf

Ein Theme, das du selbst in ~/.config/omarchy/themes schreibst, kann enthalten, was immer du willst - es ist dein Rechner und deine Datei, und Omarchy wendet alles davon an.

Ein Theme, das du mit omarchy theme install aus dem Repo einer anderen Person installierst, behält alles, was Farbe ist, und verliert die Handvoll Dateien, die Code auf deinem Rechner ausführen würden: jede .lua-Datei, die Terminal-Konfigurationen (alacritty.toml, foot.ini, ghostty.conf, kitty.conf) und vscode.json. Die hyprland.lua eines Themes ist Lua, das dein Compositor bei der Anmeldung ausführt, eine Terminal-Konfiguration benennt das Programm, das dein Terminal startet, und vscode.json benennt eine zu installierende VSCode-Erweiterung. Das Theme einer anderen Person zu installieren sollte ändern, wie dein Desktop aussieht, niemals, was er ausführt.

Alles andere funktioniert weiterhin genau so, wie der Autor des Themes es geschrieben hat - btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, die Hintergründe und die Vorschauen bleiben alle erhalten. Nur das, was entfernt wurde, wird auf deinem Rechner aus colors.toml neu generiert.

Omarchy unterscheidet die beiden danach, ob das Theme ein eigenes git-Repo in sich trägt, was omarchy theme install beim Klonen zurücklässt. So bleibt ein Theme, das du geschrieben hast, deins, und eines, das du aus dem Internet gezogen hast, bleibt Farben.

Heller Modus

Wenn du ein Theme für den hellen Modus erstellst, setze mode = "light" an den Anfang deiner colors.toml. Dann wird es für alle Apps automatisch mit dem hellen Modus gekoppelt. (Der alte Weg, eine leere Datei namens light.mode im Stammverzeichnis deines Themes abzulegen, funktioniert auch noch.)

Symbolfarben

Wenn du die Symbole des Dateimanagers farblich an dein Theme anpassen möchtest, füge eine Datei namens icons.theme mit dem Namen des Symbolsatzes hinzu, den du verwenden möchtest. Standardmäßig sind die Optionen: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow.

Bild zum Entsperren

Themes, die mit den Bildern unlock.png und preview-unlock.png ausgeliefert werden, werden unter Darstellung > Entsperren aufgeführt. Deine unlock.png sollte vorzugsweise ein transparentes png sein. Und du kannst das Vorschaubild mit omarchy plymouth preview erstellen.

Themes für Apps, die Omarchy nicht abdeckt

Wenn du eine App verwendest, die nicht in dieser Liste steht, kannst du Omarchy mit einem Template selbst beibringen, ein Theme für sie anzuwenden. Lege eine Datei in ~/.config/omarchy/themed/ ab, benannt nach der Konfiguration, die sie generiert, plus einer .tpl-Erweiterung, und schreibe die Konfiguration mit {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} bis {{ color15 }} und dem Rest der Palette als Platzhalter. Jedes Mal, wenn du Themes wechselst, wird die Datei mit den Farben dieses Themes neu generiert.

In diesem Ordner liegt eine vollständig kommentierte alacritty.toml.tpl.sample, von der du kopieren kannst - sie listet jede Variable auf, die du verwenden kannst, plus die Modifikatoren _strip und _rgb für Apps, die ihre Farben ohne das # oder als dezimales RGB wollen. Deine Templates haben Vorrang vor Omarchys eigenen, sodass du damit auch überschreiben kannst, wie für eine eingebaute App ein Theme angewendet wird.

Dein Theme verteilen

Wenn du dein Theme verteilen möchtest, damit andere es verwenden können, musst du es auf einen öffentlichen git-Server legen, wie GitHub. Dann können Leute es über Installieren > Stil > Theme im Omarchy-Menü mit dieser URL installieren. Es wird empfohlen, dass du der Namenskonvention omarchy-[themename]-theme folgst, da das Theme nach der Installation korrekt als nur [themename] im Menü zur Theme-Auswahl angezeigt wird.

Dieser übrig bleibende [themename] wird zum Verzeichnisnamen des Themes, also muss er einer sein, den Omarchy sicher herumreichen kann: Er muss mit einem Buchstaben, einer Ziffer oder einem Unterstrich beginnen, und der Rest darf Buchstaben, Ziffern, ., _, + und - enthalten. Großbuchstaben werden für dich in Kleinbuchstaben umgewandelt, aber alles andere - ein Leerzeichen, ein Anführungszeichen, ein nicht-englisches Zeichen - wird bei der Installation abgelehnt, statt in einen Verzeichnisnamen verwandelt zu werden. So lassen sich omarchy-tokyo-night-theme, omarchy-flexoki_light-theme und omarchy-c++-theme alle problemlos installieren.

Denke daran, dass, sobald es aus einem Repo installiert wird, jede mitgelieferte .lua-Datei, Terminal-Konfiguration oder vscode.json entfernt wird, also baue das Theme nicht um diese herum auf.

Du kannst dein Theme zur Seite mit den zusätzlichen Themes hinzufügen lassen, indem du einen Pull Request an das omarchy-site-Repo sendest.