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

Die obere Leiste

Der Streifen am oberen Rand deines Bildschirms ist die Omarchy-Leiste. Sie ist keine aufgeschraubte Statusleiste, sondern Teil der Omarchy-Shell, des einen, lang laufenden Quickshell-Prozesses, der auch das Menü, die Benachrichtigungen, die OSD-Popups und den Sperrbildschirm zeichnet. Deshalb passt sie thematisch perfekt zu allem anderen und deshalb öffnet sich ein Panel sofort, statt eine neue App zu starten.

Sie ist auch das einzige Stück des Desktops, das immer auf dem Bildschirm ist, also lohnt es sich zu wissen, was all diese kleinen Glyphen tun.

Was standardmäßig darauf ist

Die Leiste hat drei Abschnitte. Links sitzen das Omarchy-Logo (der Menü-Launcher) und die Arbeitsbereich-Anzeigen. In der Mitte bekommst du die Statusanzeigen, die Uhr, Elsewhen (eine Weltuhr), das Wetter und ein Omarchy-Update-Abzeichen. Rechts: die Systemablage, das Tastaturlayout (wenn mehr als eines konfiguriert ist), Agents, Bluetooth, Netzwerk, Audio, Display und Power.

Einige davon tauchen nur auf, wenn sie etwas zu sagen haben. Das Tastaturlayout erscheint nur, wenn du mehr als ein Layout konfiguriert hast. Das Update-Abzeichen erscheint nur, wenn ein Omarchy-Update wartet. Und das Agents-Icon erscheint, sobald Omarchy zum ersten Mal AI-Coding-Nutzung auf der Maschine findet (siehe KI).

Herumklicken

Fast jedes Widget tut etwas bei Links-, Rechts- und Mittelklick, und mehrere reagieren auf Scrollen. Das ist der Teil, den Leute übersehen - hinter der rechten und mittleren Taste versteckt sich viel von dem guten Zeug.

Widget Links Rechts Mitte / Scrollen
Menu Omarchy-Menü Neues Terminal -
Workspaces Diesen Arbeitsbereich auf diesem Monitor fokussieren - Scrollen: nächster/vorheriger Arbeitsbereich
Clock Kalender-Popup Das Label-Format durchschalten Mitte: Zeitzonen-Auswahl
Weather Vorhersage-Popup Vollständiges Wetter als Benachrichtigung Mitte: aktualisieren
Audio Audio-Panel Stummschalten Mitte: Panel · Scrollen: Lautstärke
Microphone Das Mikrofon stummschalten - Mitte: Audio-Panel · Scrollen: Eingabelautstärke
Network Netzwerk-Panel - -
Bluetooth Bluetooth-Panel Den Funk ein-/ausschalten -
Display Display-Panel - Scrollen: Helligkeit
Power Power-Panel Den Batterieprozentsatz ein-/ausschalten -
Media Wiedergabe/Pause Cover-Art-Popup Mitte: weiter · Scrollen: zurück/weiter
Agents Agents-Panel Deinen Agent starten Mitte: nächstes Abonnement
Tray Darüberfahren, um die Schublade zu zeigen Rechtsklick auf den Chevron, um zu verwalten -
Omarchy update Das Update ausführen - -

Nicht alles in dieser Tabelle ist von Haus aus auf deiner Leiste. Das Media-Widget (MPRIS Now-Playing, mit scrollendem Track und Künstler) und das Mikrofon-Widget sind beide eingebaut, aber standardmäßig aus - füge sie hinzu, wenn du sie willst, wie unten beschrieben.

Die Panels

Ein Klick auf ein Leisten-Icon öffnet ein Panel, also ein richtiges Popup mit Reglern, Listen und Tastaturnavigation statt eines Tooltips. Jedes hat auch eine Tastenkombination, sodass du nie auf eine 16-Pixel-Glyphe zielen musst:

Hotkey Panel
Super + Ctrl + A Audio
Super + Ctrl + N Network
Super + Ctrl + B Bluetooth
Super + Ctrl + D Display
Super + Ctrl + P Power
Super + Ctrl + Alt + D Calendar
Super + Ctrl + Alt + E World clock
Super + Ctrl + 1-9 Das n-te Panel im rechten Abschnitt ein-/ausschalten

Die Panels sind keine reinen Anzeigen. In ihnen erledigst du die Sache tatsächlich:

  • Audio hat einen Master-Lautstärkeregler, eine Auswahl für das Ausgabegerät und einen Mixer pro App, sodass du diesen einen Browser-Tab leiser machen kannst, ohne alles andere anzufassen.
  • Network sucht nach Wi-Fi, zeigt die Signalstärke, verbindet und lässt dich einen DNS-Anbieter auswählen.
  • Bluetooth listet deine Geräte mit Verbinden/Trennen und Akkuständen.
  • Power zeigt Akku-Statistiken, schaltet Energieprofile um (es merkt sich eine separate Wahl für Akku und AC) und gibt einige Systeminformationen aus.
  • Display bringt einen Helligkeitsregler, Textgröße, Presets für die Monitor-Skalierung und - wenn du mehr als einen Bildschirm hast - Steuerungen pro Monitor mit. Siehe Monitore für die ausführlichere Geschichte.
  • Clock öffnet ein Monatsraster mit ISO-Wochennummern und Monatsschritten.
  • World clock hält eine Zeile pro Stadt, mit ihrem Wetter und wie ihr Tag gerade läuft. Die Suche findet Orte ebenso wie Zeitzonen, also ist Fort Lauderdale Fort Lauderdale und nicht New York. Wenn die Zeile oben die falsche Stadt nennt, klicke sie an und sage, wo du bist; wähle einen Ort in einer anderen Zeitzone und die Systemuhr zieht auch dorthin um, was praktisch ist, wenn du reist. Fahre über eine Stadt und klicke auf den Personen-Button, um zu sagen, wer dort lebt - einfache Namen, oder @ GitHub-Handles, um ihre Gesichter mitzubringen.

Jedes Panel nimmt ebenso die Tastatur wie die Maus: Pfeile bewegen, Return aktiviert, Tab springt zum benachbarten Panel und Escape schließt.

Super + Ctrl + 1-9 zählt die Panels von links nach rechts im rechten Abschnitt und überspringt dabei die Systemablage, da sie kein eigenes Panel hat. Also entspricht die Zahl dem Icon, auf das du zeigen würdest.

Tailscale und Dropbox

Zwei weitere Widgets erscheinen erst auf der Leiste, wenn du den passenden Dienst unter Install → Service installierst, und beide sollte man kennen, weil sie mehr tun, als nur den Status zu melden.

Das Tailscale-Panel verbindet und trennt das Tailnet, wechselt zwischen Konten und wählt einen Exit Node (deine eigenen Maschinen und Mullvad-Regionen tauchen beide in dieser Liste auf). Es durchstöbert auch deine Maschinen - und wenn eine ausgewählt ist, sendet s Dateien per Taildrop an sie, was der schnellste Weg ist, eine Datei auf dein Telefon oder einen anderen Laptop zu bewegen. c kopiert die IP der Maschine, n ihren Namen und d ihren vollständigen DNS-Namen. Auf jeder Maschinenzeile gibt es auch einen Senden-Button, wenn du lieber klickst. Dasselbe vom Terminal aus ist omarchy tailscale send <machine> [file...].

Das Dropbox-Panel übernimmt den Login, zeigt, wie viel Speicher du verbraucht hast, und listet kürzlich synchronisierte Dateien.

Entfernst du einen der beiden Dienste, verschwindet sein Widget wieder von der Leiste.

Indikatoren

Der kleine Cluster in der Mitte ist das Indikatoren-Widget. Das sind Status-Glyphen für Modi, die du eingeschaltet hast: Nicht stören, Nachtlicht, eine eingereihte Erinnerung, eine aktive Bildschirmaufnahme, wach bleiben und Diktieren. Sie leuchten auf, wenn der Modus aktiv ist, und halten sich sonst zurück - fahre irgendwo über die Leiste, um einen Blick auf die inaktiven zu werfen. Ein Klick auf einen Indikator schaltet diesen Modus um. Einer mehr ist nur Status: Eine Remote-Sitzung leuchtet rot, solange jemand über gliff mit dieser Maschine verbunden ist.

Wenn sie lieber immer sichtbar sein sollen, setze alwaysShow auf dem Widget auf true. Und wenn dich nur einige davon interessieren, liste die gewünschten in items auf: ["Dnd", "Reminder", "NightLight"]. Du kannst mehr als ein Indikatoren-Widget haben, sodass verschiedene Abschnitte verschiedene Teilmengen zeigen können.

Die Leiste neu anordnen

Die Leiste konfiguriert sich selbst. Du musst keine Konfigurationsdatei öffnen, um Dinge zu verschieben.

Greife eine leere Stelle der Leiste um die Mitte herum und ziehe sie zu einer anderen Bildschirmkante, und die Leiste bewegt sich dorthin - links, rechts, oben oder unten funktionieren alle, und jedes Widget passt sich an (vertikale Leisten fallen auf kompakte, reine Icon-Formen zurück). Ein Klicken-und-Halten startet denselben Zug. Doppel-Linksklicke dieselbe leere Stelle, um den Leistenhintergrund von klar zu glasig zu undurchsichtig durchzuschalten. Und ziehe irgendein Widget, um es neu anzuordnen oder in einen anderen Abschnitt zu werfen; die anderen Widgets rücken auseinander, um Platz zu machen, wo es landen wird.

Die Mitte der Leiste ist eine Box: Was darin ist, bleibt als eine Gruppe zentriert, und die Widgets auf beiden Seiten davon hängen an ihren Kanten. Während du ein Widget ziehst, zeigt sich die Box als Umriss, oder als Linie quer über die Leiste, wenn sie leer ist, und du kannst hinein oder daneben fallen lassen. Wenn ein Fallenlassen in der Box landen würde, wächst die Box, um das Widget aufzunehmen.

Ein Widget, das du in der Nähe haben, aber nicht immer sehen willst, kann in der Schublade der Systemablage landen: Ziehe es auf die Systemablage, und die Schublade öffnet sich, um es aufzunehmen. Es sitzt dort hinter den App-Icons, taucht auf, wann immer die Schublade es tut, und hält seine Schublade offen, solange sein Panel oben ist. Ziehe es zurück auf die Leiste, um es zurückzulegen.

Wenn du lieber aus einem Menü wählst, hat Appearance → Menu Bar die Position, und Bar Background wählt, wie die Leiste gezeichnet wird: Opaque Bar, Glassy Bar (durchsichtig, mit dem, was dahinter ist, verschwommen) oder Clear Bar.

Dieselben Dinge haben Befehle, was du für ein Dotfiles-Setup willst:

omarchy bar position bottom
omarchy bar background glassy  # opaque, glassy, none, or cycle
omarchy bar move omarchy.weather --section centerBegin --index 0
omarchy bar move omarchy.bluetooth --section tray  # into the tray's drawer
omarchy bar set omarchy.clock format "HH:mm"
omarchy bar defaults          # back to the shipped layout

Um ein Widget ganz hinzuzufügen oder zu entfernen, benutze die Plugin-Befehle. omarchy plugin list gibt jedes Widget aus, das die Shell kennt, mit seiner id, und dann:

omarchy plugin enable omarchy.media --section centerEnd
omarchy plugin disable omarchy.weather

Die Leiste ausblenden

Super + Shift + Space schaltet die Leiste aus und wieder an, ohne die Shell zu töten - Panels und Tastenkombinationen funktionieren weiter, du bekommst nur die Pixel zurück. Es steht auch im Menü unter Appearance → Menu Bar → Hide Bar.

Die Konfigurationsdatei

All das wird in ~/.config/omarchy/shell.json gespeichert, unter dem Schlüssel bar. Hier ist eine gekürzte Version:

{
  "version": 1,
  "bar": {
    "position": "top",
    "background": "opaque",
    "layout": {
      "left": [{ "id": "omarchy.menu" }, { "id": "omarchy.workspaces" }],
      "centerBegin": [{ "id": "omarchy.indicators" }],
      "center": [{ "id": "omarchy.clock", "format": "HH:mm" }],
      "centerEnd": [{ "id": "omarchy.weather" }],
      "right": [{ "id": "omarchy.audio" }, { "id": "omarchy.power" }]
    }
  }
}

Jedes Widget ist ein Eintrag in einem der fünf Layout-Arrays, und seine Einstellungen sitzen inline auf diesem Eintrag - es gibt keine separate Einstellungsdatei und kein config-Unterobjekt. Das format, formatAlt (wohin der Rechtsklick weiterschaltet) und verticalFormat der Uhr leben alle genau dort auf { "id": "omarchy.clock" }.

center ist die Box in der Mitte der Leiste: Alles darin wird als eine Gruppe auf dem Bildschirm zentriert. centerBegin und centerEnd hängen auf beiden Seiten der Box, und so bleibt die Uhr exakt in der Mitte, selbst wenn Wetter und Update-Abzeichen kommen und gehen. Lege mehr als ein Widget in center und sie werden zusammen zentriert; lasse es leer und centerBegin und centerEnd treffen sich in der Mitte der Leiste.

Eine Regel, die es wert ist, verinnerlicht zu werden: Sobald du deine eigene shell.json hast, ist sie kanonisch. Bis du irgendetwas anpasst, liest die Shell Omarchys Standarddatei. In dem Moment, in dem du ein Widget ziehst, omarchy bar ausführst oder die Datei selbst bearbeitest, gehört sie dir - es gibt kein Deep Merge, also werden neue Standard-Widgets in zukünftigen Omarchy-Versionen nicht automatisch auf deiner Leiste erscheinen. omarchy bar defaults legt das mitgelieferte Layout zurück, wann immer du eine saubere Ausgangslage willst.

Dieselbe Datei hält auch deine Idle-Zeiten auf der obersten Ebene, außerhalb des Schlüssels bar: idle.screensaver und idle.lock, beide in Sekunden seit du idle gegangen bist. Also setzt der Standard-Bildschirmschoner bei 150 Sekunden ein und die Sperre bei 300.