---
title: Hyprland Post-Install-Einrichtung & Tastenkombinationen
description: Einrichtung nach der Installation und Übersicht der Tastenkombinationen
---

import { Kbd } from 'starlight-kbd/components'
import ImageComponent from '~/components/image-component.astro';
import { Aside } from '@astrojs/starlight/components';

:::note
Hyprland ist ein Wayland-Compositor, der verschiedene Layouts wie dwindle (Tiling), Scrolling, Master, Monocle und benutzerdefinierte Layouts unterstützt. Es ist **keine** vollständige Desktop-Umgebung (DE).
:::

### Warum Hyprland?

Hyprland ist ein optisch ansprechender dynamischer Tiling-Manager, der eine Vielzahl von Layouts und erweiterte Compositor-Funktionen wie VRR, Tearing und HDR unterstützt. Die CachyOS-Dots für Hyprland sind mit Standardeinstellungen eingerichtet, die sofort vollständig nutzbar sein sollten, mit Anwendungen, die dem allgemeinen Systemdesign folgen.

**Dotfiles verwaltet von [Jinra](https://github.com/Jinra)**

Bei Problemen im Zusammenhang mit Noctalia schau bitte in die [Noctalia-Dokumentation](https://docs.noctalia.dev/).

## Post-Install-Einrichtung
Du solltest nach der Einrichtung einige benutzerspezifische Dinge konfigurieren. Weitere Einstellungen findest du im Hyprland-Wiki unter https://wiki.hypr.land/Configuring/Start/

### Verzeichnis `~/.config/hypr/config`
* `monitors.lua` richtet deine Monitore ein. (weitere Informationen unter https://wiki.hypr.land/Configuring/Basics/Monitors/) Ein standardmäßiger Block ist bereits erstellt, für zusätzliche Monitore kannst du weitere hinzufügen.
  * `output` passe den Wert deines Monitors lieber in `variables.lua` an; du kannst `hyprctl monitors` ausführen, um diese ID zu erhalten (z. B. `DP-1`). Wenn du weitere Monitore hinzufügst, nenne sie MONITOR2, MONITOR3, usw. und füge sie ebenfalls `variables.lua` hinzu.
  * `mode` sollte in einem Format wie `1920x1080@60` angegeben werden (horizontal x vertikal @ Bildwiederholrate).
  * `scale` Standardmäßig solltest du `1` verwenden, aber bei Monitoren mit höherer Auflösung kann ein höherer Wert sinnvoll sein.
  * Nach der ersten Anpassung musst du eventuell einen Neustart durchführen, zukünftige Anpassungen sollten aber sofort in Effekt treten.
* `variables.lua`
  * Füge hier deine Monitor-Zuweisungen hinzu. Dein `PRIMARY_MONITOR` und `MONITOR1` sollten generell derselbe Monitor sein. Du kannst `MONITOR#`-Variablen nach Bedarf entfernen/hinzufügen.
  * Definiere die Anzahl der Arbeitsflächen pro Monitor. Überschreite nicht 10.
* `input.lua` Hier kannst du deine verschiedenen Hypr-Eingabeeinstellungen definieren. Sehr wahrscheinlich wirst du die `sensitivity` anpassen müssen.
* `binds.lua` Überprüfe diese Datei, um alle Tastenkombinationen der jeweiligen Dots zu sehen. Du kannst dir auch die allgemeine Übersicht unten ansehen.
* `windowrules.lua` Wenn du dich fragst, warum bestimmte Fenster bestimmte Verhaltensweisen haben, überprüfe diese Datei; du kannst auch Regeln nach Belieben hinzufügen/entfernen.
* `workspaces.lua` Füge hier verschiedene Arbeitsflächeneinstellungen hinzu. Es ist empfehlenswert, 3 Arbeitsflächen pro Monitor hinzuzufügen (wie in den Beispielen abgebildet) plus die Gaming-Arbeitsfläche zum primären Monitor.
* `environment.lua` wird zum Festlegen von Hypr- oder benutzerspezifischen Umgebungsvariablen verwendet. Wenn du UWSM verwendest muss die Datei nicht angepasst werden und es wird empfohlen, die Umgebungsvariablen stattdessen zur UWSM-Env-Datei hinzuzufügen (siehe unten).
### Verzeichnis `~/.config/uwsm`
* `env` ist eine Datei zum Definieren globaler Variablen. Du kannst diese für allgemeine Variablen verwenden, die für dein spezifisches Benutzerkonto zugewiesen werden müssen (Beispiele: `HYPRCURSOR_THEME`, `XCURSOR_THEME`, `QT_QPA_PLATFORM`, usw.)
### Verzeichnis `~/.config/noctalia` (nur V5; es sind auch V4 Dateien enthalten, du musst diese aber nicht manuell anpassen, da sie über die Noctalia-Einstellungen konfiguriert werden können.)
* `config.toml` enthält die Standardkonfiguration für cachyos-hypr-noctalia. Diese Datei ist der Grund, warum sich die Standards von einer Vanilla-Noctalia-v5-Installation unterscheiden. Du solltest in dieser Datei nichts ändern müssen.
### Noctalia-Einstellungen (Super + Z)
* Hier kannst du die Noctalia-Einstellungen bearbeiten. Es wird empfohlen, zum Abschnitt Vorlagen zu gehen und alle Farbvorlagen für alle Apps zu aktivieren, die du möglicherweise verwendest.
* Schau dir auch den Plugin-Store für nützliche offizielle und Community-Plugins an.

## Tastenkombinationen

Die meisten Tastenkombinationen erfordern die Verwendung der Mod-Taste, die in unserem Fall die Windows/Command-Taste ist (im Folgenden als SUPER bezeichnet). Du kannst dies in `binds.lua` ändern.

### Fensterverwaltung

| Beschreibung | Taste |
|-------------|------|
| App/Fenster Schließen erzwingen (Kombination halten und klicken) | <Kbd linux="Super+Escape" /> |
| Fokussiertes Fenster/App schließen | <Kbd linux="Super+Q" /> |
| Floating/Tiled umschalten | <Kbd linux="Super+Alt+Space" /> |
| Fokussiertes Fenster maximieren | <Kbd linux="Super+D" /> |
| Fokussiertes Fenster in Vollbild | <Kbd linux="Super+F" /> |
| Split-Richtung umschalten | <Kbd linux="Super+J" /> |
| Fokus nach links | <Kbd linux="Super+Left" /> |
| Fokus nach rechts | <Kbd linux="Super+Right" /> |
| Fokus nach oben | <Kbd linux="Super+Up" /> |
| Fokus nach unten | <Kbd linux="Super+Down" /> |
| Fensterfokus auf Arbeitsfläche wechseln | <Kbd linux="Alt+Tab" /> |
| Fenster-Umschalter öffnen | <Kbd linux="Super+Tab" /> |
| Fokussiertes Fenster zum Monitor verschieben | <Kbd linux="Super+Shift+#" /> |
| Fokussiertes Fenster zu Arbeitsfläche verschieben | <Kbd linux="Super+Shift+Control+#" /> |
| Fokussiertes Fenster zu spezieller Arbeitsfläche verschieben | <Kbd linux="Super+Shift+S" /> |
| Fokussiertes Fenster nach rechts verschieben | <Kbd linux="Super+Shift+Right" /> |
| Fokussiertes Fenster nach links verschieben | <Kbd linux="Super+Shift+Left" /> |
| Fokussiertes Fenster nach oben verschieben | <Kbd linux="Super+Shift+Up" /> |
| Fokussiertes Fenster nach unten verschieben | <Kbd linux="Super+Shift+Down" /> |
| Fokussiertes Fenster zur nächsten Arbeitsfläche verschieben | <Kbd linux="Super+Control+Shift+Right" /> |
| Fokussiertes Fenster zur vorherigen Arbeitsfläche verschieben | <Kbd linux="Super+Control+Shift+Left" /> |
| Fokussiertes Fenster zur vorherigen Arbeitsfläche verschieben (Maus) | <Kbd linux="Super+Control+Shift+Scroll&nbsp;up" /> |
| Fokussiertes Fenster zur nächsten Arbeitsfläche verschieben (Maus) | <Kbd linux="Super+Control+Shift+Scroll&nbsp;down" /> |
| Fokussiertes Fenster zum nächsten Monitor verschieben | <Kbd linux="Super+Shift+Scroll&nbsp;down" /> |
| Fokussiertes Fenster zum vorherigen Monitor verschieben | <Kbd linux="Super+Shift+Scroll&nbsp;up" /> |
| Fenster verschieben (Maus) | <Kbd linux="Super+Left&nbsp;Click" /> |
| Fenstergröße ändern (Maus) | <Kbd linux="Super+Right&nbsp;Click" /> |

### Launcher

| Beschreibung | Taste |
|-------------|------|
| Terminal öffnen | <Kbd linux="Super+Return" /> |
| Dateimanager öffnen | <Kbd linux="Super+E" /> |
| Editor öffnen | <Kbd linux="Super+T" /> |
| Taschenrechner öffnen | <Kbd linux="Super+C" /> |
| Browser öffnen | <Kbd linux="Super+W" /> |
| Systemmonitor öffnen (btop) | <Kbd linux="Control+Shift+Escape" /> |
| Noctalia-Einstellungen umschalten | <Kbd linux="Super+Z" /> |
| Kontrollzentrum umschalten | <Kbd linux="Super+X" /> |
| App-Starter umschalten | <Kbd linux="Super+Space" /> |
| Emoji-Starter öffnen | <Kbd linux="Super+period" /> |
| Bildschirm sperren | <Kbd linux="Super+L" /> |
| Sitzungsmenü umschalten | <Kbd linux="Super+Alt+C" /> |

### Hardware-Steuerung

| Beschreibung | Taste |
|-------------|------|
| Lautstärke erhöhen | <Kbd linux="Volume Up" /> |
| Lautstärke verringern | <Kbd linux="Volume Down" /> |
| Audio-Ausgabe stumm schalten | <Kbd linux="Mute" /> |
| Mikrofoneingang stumm schalten | <Kbd linux="MicMute" /> |
| Medien wiedergeben/pausieren | <Kbd linux="Play" /> / <Kbd linux="Pause" /> |
| Nächster Medien-Track | <Kbd linux="Next" /> |
| Vorheriger Medien-Track | <Kbd linux="Previous" /> |
| Bildschirmhelligkeit erhöhen | <Kbd linux="Brightness Up" /> |
| Bildschirmhelligkeit verringern | <Kbd linux="Brightness Down" /> |

### Werkzeuge

| Beschreibung | Taste |
|-------------|------|
| Farbwähler | <Kbd linux="Super+P" /> |
| Bildschirmaufnahme & Anmerkungen | <Kbd linux="Print" /> |
| Bildschirmaufnahme Fenster & Anmerkungen (v4) | <Kbd linux="Super+Print" /> |
| Bildschirmaufnahme Monitor & Anmerkungen (v5) | <Kbd linux="Super+Print" /> |
| Bildschirmrekorder umschalten (nur v4) | <Kbd linux="Super+R" /> |
| Hintergrundbild-Menü umschalten | <Kbd linux="Super+Shift+W" /> |
| Zwischenablage-Verlauf öffnen | <Kbd linux="Super+V" /> |
| Benachrichtigungsverlauf umschalten | <Kbd linux="Super+A" /> |
| Reinzoomen | <Kbd linux="Super+Plus" /> |
| Rauszoomen | <Kbd linux="Super+Minus" /> |

### Arbeitsflächen & Monitore

| Beschreibung | Taste |
|-------------|------|
| Zur Arbeitsfläche [1-10] wechseln | <Kbd linux="Super+[0-9]" /> |
| Fenster zu Arbeitsfläche [1-10] verschieben (folgen) | <Kbd linux="Super+Shift+[0-9]" /> |
| Fenster zu Arbeitsfläche [1-10] verschieben (nicht folgen) | <Kbd linux="Super+Alt+[0-9]" /> |
| Arbeitsfläche fokussieren (Relative) | <Kbd linux="Super+Control+#" /> |
| Arbeitsfläche fokussieren (Absolute) | <Kbd linux="Super+Alt+#" /> |
| Nächste Arbeitsfläche fokussieren | <Kbd linux="Super+Control+Right" /> |
| Vorherige Arbeitsfläche fokussieren | <Kbd linux="Super+Control+Left" /> |
| Erste leere Arbeitsfläche fokussieren | <Kbd linux="Super+Control+Down" /> |
| Nächste Arbeitsfläche fokussieren (Maus) | <Kbd linux="Super+Control+Scroll&nbsp;down" /> |
| Vorherige Arbeitsfläche fokussieren (Maus) | <Kbd linux="Super+Control+Scroll&nbsp;up" /> |
| Nächsten Monitor fokussieren (Maus) | <Kbd linux="Super+Scroll&nbsp;down" /> |
| Vorherigen Monitor fokussieren (Maus) | <Kbd linux="Super+Scroll&nbsp;up" /> |
| Spezielle Arbeitsfläche umschalten (Scratchpad) | <Kbd linux="Super+S" /> |

## Migration von einer anderen DE/WM

Wenn du bereits eine andere DE/WM installiert hast, kannst du mit der folgenden Anleitung zu diesen Dots migrieren.

:::note
Es ist zwar möglich, dasselbe Benutzerkonto mit Hyprland zu verwenden, es wird jedoch dringend empfohlen, ein neues Benutzerkonto zu erstellen (Anleitung enthalten). Selbst mit einem neuen Benutzerkonto kann es zu Daemon-Konflikten mit deiner vorherigen DE/WM kommen, weswegen empfohlen wird, eine einzelne Umgebung zu verwenden.
:::

Stelle sicher, dass du die Variablen in den spitzen Klammern (\<\>) unten einschließlich der spitzen Klammern selbst ersetzt.

1. Führe `sudo pacman -S cachyos-hypr-noctalia` aus. Wenn du einen Paketkonflikt mit einem anderen `-settings`-Paket hast (wie z. B. `cachyos-kde-settings`), kannst du das konfliktierende Paket löschen, da diese Pakete keine Auswirkung auf die aktuellen Benutzer haben.
1. Um einen neuen Benutzer zu erstellen, führe `sudo useradd -m <new_user> -s /bin/fish` aus. Du kannst auch eine andere Shell deiner Wahl, z.B. /bin/zsh verwenden.
1. Führe `sudo passwd <new_user>` aus, um ein Passwort für das Konto festzulegen.
    * Wenn du _wirklich_ dasselbe Konto verwenden möchtest (wovon dringend abgeraten wird), kopiere stattdessen die Dots in den Benutzerordner `cp -r /etc/skel/. ~` (erstelle zuerst ein Backup/Snapshot!)
1. Installiere optional `noctalia-greeter` oder `sddm` als Display-Manager. `noctalia-greeter` integriert sich besser in Noctalia, ist jedoch etwas aufwendiger einzurichten. 
    * Um sddm als Display-Manager zu verwenden, installiere es mit `sudo pacman -Syu sddm` und führe anschließend `systemctl disable display-manager` sowie `systemctl enable sddm` aus. 
    * Um [Noctalia Greeter](https://github.com/noctalia-dev/noctalia-greeter) zu installieren, führe `sudo pacman -Syu noctalia-greeter` aus und befolge den Abschnitt „Setting up greetd“ in der verlinkten Dokumentation. Führe danach `systemctl disable display-manager` und `systemctl enable greetd` aus.
1. Führe einen Neustart durch und wähle die Hyprland (UWSM)-Sitzung in deinem Display-Manager.
    * Wenn die Shell nicht lädt, versuche, erneut neu zu starten.
1. Melde dich an und folge dem Abschnitt [Post-Install-Einrichtung](#post-install-einrichtung).

## Migration von v4-Dots zu V5 / Aktualisierung deiner Dots

Wenn du derzeit cachyos-hypr-noctalia mit Noctalia v4 verwendest und von Paketversion 1.0 auf eine neuere Version aktualisiert hast oder deine Dots aktualisieren möchtest, folge der Anleitung unten.
Das vollständige Änderungsprotokoll findest du im Release, um zu entscheiden, ob du deine Dots aktualisieren solltest.
https://github.com/CachyOS/cachyos-hypr-noctalia/releases

### Hypr-Aktualisierungen

:::note
Sobald du deine Tastenkombinationen von v4 zu v5 migriert hast, funktionieren diese nicht mehr für Noctalia-IPC-Aufrufe.
:::

1. Installiere `meld`, falls du es noch nicht hast (`pacman -Q meld` zum Überprüfen).
1. Führe `meld /etc/skel/.config/hypr ~/.config/hypr` aus.
1. In meld siehst du eine Übersicht aller Dateien mit Änderungen. Blaue Dateien haben Änderungen, grüne Dateien sind neu hinzugekommen.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/meld_overview.png')} />
1. Klicke in eine blaue Datei, um die anzuwendenden Änderungen zu sehen. Du kannst nach eigenem Ermessen entscheiden, was angewendet werden soll, aber wenn du keine Änderungen vorgenommen hast, ist es sicher, die gesamte Datei zu überschreiben. Klicke auf den Pfeil, um Änderungen zu übernehmen und auf das x, um alte Zeilen zu entfernen.
    <Aside type="note">Stelle sicher, dass du nichts überschreibst, was du möglicherweise geändert hast, wie z. B. deine Monitoreinstellungen.</Aside>
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge.png')} />
1. Du kannst auch alles zusammenführen.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge_all_1.png')} />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge_all_2.png')} />
1. Wenn du mit deinen Änderungen an der Datei fertig bist, speichere und schließe.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/save_exit.png')} />
1. Bei den neu hinzugekommenen grünen Dateien wirst du gefragt, wo du sie speichern möchtest. Du kannst sie in `~/.config/hypr/config/` unter demselben Namen speichern. Es gibt 4 neue Dateien.
    * defaults.lua ist jetzt variables.lua. Du musst alle benutzerdefinierten Ergänzungen/Änderungen manuell in die neue Datei verschieben.
    * keybinds.lua ist jetzt binds.lua. Du musst alle benutzerdefinierten Ergänzungen/Änderungen manuell in die neue Datei verschieben.
    * input.lua ist jetzt inputs.lua. Du musst alle benutzerdefinierten Ergänzungen/Änderungen manuell in die neue Datei verschieben.
    * workspaces.lua ist neu und kann ohne Änderungen sauber verschoben werden.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/workspaces.png')} />

### Noctalia-Aktualisierungen

1. Führe `rm -rf ~/.config/noctalia` aus, um die aktuellen Konfigurationen zu entfernen. Alternativ kannst du diese woanders hin verschieben, falls du glaubst, etwas dort zu benötigen.
1. `cp -r /etc/skel/.config/noctalia ~/.config` kopiert die neue Konfiguration in deinen persönlichen Ordner.

:::note
Die einzige wichtige Datei ist config.toml. Du kannst diese stattdessen auch einzeln kopieren, anstatt den gesamten Ordner beim Paketupdate zu löschen und zu ersetzen, wenn du möchtest.
:::

### Weitere Aktualisierungen

Andere Dateien müssen möglicherweise aktualisiert werden. Du kannst meld verwenden, um diese zu integrieren. Im vollständigen Release-Änderungsprotokoll siehst du, was sich sonst noch geändert haben könnte.

### Verwaiste Pakete entfernen (v4->v5 Migration)

Nach dem Aktualisieren des Pakets werden alte Abhängigkeiten verwaist sein. Du kannst diese entfernen, indem du `shelly purify -o` ausführst.

### Neustart

Ein Neustart sollte die Änderungen wirksam machen. Wenn die Shell nicht lädt, versuche, erneut neu zu starten.

## FAQ

> _"Warum bleibt meine Zwischenablage nicht über einen Neustart erhalten?"_

Um diese Funktion zu unterstützen, musst du einen Passwortspeicher einrichten. Standardmäßig ist Kwallet installiert, du kannst aber auch gnome-keyring oder andere Passwortspeicher nutzen. Wenn du kwallet nutzen möschtest, installiere `kwalletmanager` vom Repo, öffne es und erstelle ein neues Wallet. Am einfachsten ist es, das Passwort leer zu lassen, du kannst aber auch eine automatische Entsperrung mit deinem Display-Manager einrichten. Mehr Informationen darüber findest du im [Arch Wiki](https://wiki.archlinux.org/title/KDE_Wallet#Configuration). Nachdem du einen Passwortspeicher eingerichtet hast, initialisiere ihn in deiner `autostart.lua` Datei mit `hl.exec_cmd("kwalletd6")`.

> _"Wie kann ich verhindern, dass Satty nach dem Erstellen eines Screenshots erscheint?"_

Du kannst Satty ganz einfach schließen, indem du Strg + S drückst, um deinen Screenshot zu speichern, oder Strg + C, um ihn zu kopieren. Wenn Satty gar nicht erscheinen soll, kannst du in den Noctalia-Einstellungen unter „Shell“ > „Screenshot“ festlegen, ob der Screenshot in die Zwischenablage kopiert oder in einer Datei gespeichert werden soll.

> _"Wie kann ich meine Tastatureingabe ändern?"_

Bearbeite `inputs.lua` und füge `kb_layout` hinzu. Siehe [hier](https://wiki.hypr.land/Configuring/Basics/Variables/#input)

> _"Warum funktionieren einige Designoptionen (Dolphin-Icons, einige Qt-Elemente usw.) nicht?"_

Cachys Standard-Repository stellt nur `qt6ct` (Qt6-Konfigurationstool) bereit. Es gibt jedoch ein anderes Tool, das für besser Plasma-QT-Anwendungen wie Dolphin, Gwenview usw. geeignet ist. Lade stattdessen `qt6ct-kde` aus dem AUR herunter und wende das Noctalia-Theme damit an. Dadurch sollte das Theme deiner Plasma-Anwendungen in Hyprland besser aussehen.

Cachy's default repo only provides `qt6ct` (QT6 Configuration Tool). However, there is another tool that works better for Plasma QT applications like dolphin, gwenview, etc. Download `qt6ct-kde` from the AUR instead and apply the Noctalia theme with it. This should have your plasma apps theme better in Hyprland.

> _"Wie wechsle ich meinen Standard-Browser?"_

Führe `xdg-settings set default-web-browser dein_browser.desktop` aus. Du kannst den .deskop Namen deines Browsers durch `ls /usr/share/applications/` herausfinden.