> For the complete documentation index, see [llms.txt](https://hacking-notes.jord4n.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hacking-notes.jord4n.pro/de/useful-resources/gh0stzk-bspwm-dotfiles.md).
# Arch-Linux-Hacker-Setup mit BSPWM
[gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) ist eine vollständige BSPWM-Desktopumgebung für Arch Linux und Arch-basierte Distributionen. Sie enthält Themes, Leisten, Starter, Terminaleinstellungen, ZSH, Neovim, Rofi-Applets, Hintergrundbilder und Hilfsskripte zum schnellen Wechseln von Stilen.
Beispiel einer BSPWM-Desktopumgebung aus der Projekt-README.
{% hint style="warning" %}
Installiere dies nur auf einem persönlichen Laborrechner oder einem frischen Linux-Arbeitsplatz. Dotfiles ersetzen viele Benutzerkonfigurationsdateien, daher solltest du den Installer prüfen und dein aktuelles Setup sichern, bevor du ihn ausführst.
{% endhint %}
## Wo es einzuordnen ist
Dies gehört in `Nützliche Ressourcen` weil es eine Ressource für die Einrichtung einer Workstation ist, kein Pentesting-Tool. Verwende es, wenn du eine saubere, Arch-basierte BSPWM-Umgebung für tägliche Notizen, Labs, CTF-Arbeit, Entwicklung und terminallastige Workflows möchtest.
## Was es dir bietet
| Komponente | Was es bedeutet |
| -------------------- | --------------------------------------------------------------------------------------------------------------- |
| BSPWM | Kachelfenster-Manager für einen schnellen, tastaturgesteuerten Desktop. |
| 18 Themes | Fertige visuelle Stile, die sich im laufenden Betrieb wechseln lassen. |
| Polybar | Desktop-Leiste mit Arbeitsbereichen, Modulen, Systeminformationen und Themenfarben. |
| Rofi-Applets | Menüs für Apps, Energieoptionen, Screenshots, Zwischenablage, Netzwerk, Bluetooth, Hintergrundbilder und mehr. |
| Terminals | Theme-Unterstützung für Alacritty, Kitty, Ghostty, ST und Xfce Terminal. |
| ZSH-Konfiguration | Schnelles Shell-Setup mit Autovervollständigung, Verlaufssuche und fzf-tab-Vorschauen. |
| Neovim-Konfiguration | Vorgefertigtes Editor-Setup mit LSP, Autovervollständigung, Formatierung, Explorer, Statusleiste und Dashboard. |
| RiceEditor | Hilfs-App zum Anpassen visueller Einstellungen, ohne jede Konfiguration manuell zu bearbeiten. |
## Visuelle Vorschau
Das Projekt ist sehr visuell, daher sieh dir vor der Installation die Screenshots und die Demo an.
Theme-Auswahl.
Hintergrundbild-Auswahl.
RiceEditor zur Theme-Anpassung.
### Projekt-Demo
{% embed url="" %}
### Arch-Installationsdurchgang
Dieses Video des Erstellers ist nützlich, wenn du vor dem Anwenden der Dotfiles eine saubere Arch-Installation möchtest.
{% embed url="" %}
### Projektkanal
Der Kanal des Autors enthält weitere Demos zu BSPWM, Polybar, Eww, Rofi und Themes.
{% embed url="" %}
## Vor der Installation
Der offizielle Installer ist für Arch Linux und Arch-basierte Distributionen gedacht. In der README wird darauf hingewiesen, dass nicht-systemd-basierte Distributionen wie Artix nicht unterstützt werden.
Empfohlener Ausgangspunkt:
| Anforderung | Notizen |
| ------------------------------------- | --------------------------------------------------------------------- |
| Arch- oder Arch-basierte Distribution | Eine Neuinstallation ist am sichersten. |
| Normales Benutzerkonto | Führe den Installer nicht als root aus. |
| Funktionierendes Internet | Der Installer lädt Pakete und Repositories herunter. |
| Anmeldemanager | LightDM wird vom Projekt empfohlen. |
| NetworkManager | Benötigt für das Rofi-Netzwerk-Applet. |
| Sicherung | Bewahre eine Kopie der vorhandenen `~/.config` und Shell-Dateien auf. |
Nützlicher Sicherungsbefehl vor dem Testen:
```bash
mkdir -p "$HOME/dotfiles-backup"
cp -a "$HOME/.config" "$HOME/dotfiles-backup/config-$(date +%F)" 2>/dev/null
cp -a "$HOME/.zshrc" "$HOME/.gtkrc-2.0" "$HOME/.icons" "$HOME/dotfiles-backup/" 2>/dev/null
```
## Schnelle Arch-Einrichtung
Verwende dies, wenn du mit einem sauberen Arch-Rechner oder einer VM startest und den kürzesten praktikablen Weg willst.
### 1. Arch-ISO starten
Starte mit dem offiziellen Arch-ISO. Wenn du WLAN nutzt, verbinde dich zuerst:
```bash
iwctl
```
Innerhalb `iwctl`:
```
Geräteliste
station wlan0 scan
station wlan0 get-networks
station wlan0 connect "SSID"
exit
```
Internet prüfen:
```bash
ping -c 3 archlinux.org
```
Zeit synchronisieren:
```bash
timedatectl set-ntp true
```
### 2. Arch schnell installieren
Der schnelle Weg ist `archinstall`:
```bash
archinstall
```
Empfohlene Auswahl:
| Option | Wählen |
| --------------------- | ---------------------------------------------------------------------------- |
| Datenträgeraufteilung | Standard oder manuell, je nach deiner VM/deinem Datenträger. |
| Bootloader | `systemd-boot` für UEFI, GRUB, wenn du ihn bevorzugst. |
| Profil | Minimal reicht; Desktop ist optional. |
| Netzwerk | NetworkManager. |
| Audio | PipeWire. |
| Benutzer | Erstelle einen normalen Benutzer mit sudo-Zugriff. |
| Zusätzliche Pakete | `git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager` |
Nach der Installation:
```bash
reboot
```
### 3. Die Grundlagen aktivieren
Melde dich als normaler Benutzer an und stelle dann sicher, dass die Basisdienste bereit sind:
```bash
sudo pacman -Syu
sudo pacman -S --needed git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager
sudo systemctl enable --now NetworkManager
sudo systemctl enable lightdm
```
Starte noch einmal neu, wenn du LightDM gerade aktiviert hast:
```bash
sudo reboot
```
## Dotfiles-Installation
Öffne ein Terminal aus deinem Home-Verzeichnis:
```bash
cd "$HOME"
```
Lade den offiziellen Installer herunter:
```bash
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
```
Prüfe den Installer, bevor du ihn ausführst:
```bash
less RiceInstaller
```
Gib ihm Ausführungsrechte:
```bash
chmod +x RiceInstaller
```
Führe ihn als normalen Benutzer aus:
```bash
./RiceInstaller
```
Der Installer ist interaktiv. Er fragt möglicherweise, ob du die enthaltenen Neovim- und Firefox-Konfigurationen möchtest. Lies jede Eingabeaufforderung, statt einfach überall die Eingabetaste zu drücken.
### Installation in einem Block
Für eine schnelle Laborinstallation, nachdem Arch bereits funktioniert:
```bash
cd "$HOME"
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
less RiceInstaller
chmod +x RiceInstaller
./RiceInstaller
```
## Was der Installer macht
Grob gesagt macht der Installer Folgendes:
1. Prüft, dass er nicht als root ausgeführt wird.
2. Prüft, dass er ausgeführt wird aus `$HOME`.
3. Fügt das `gh0stzk-dotfiles` Paket-Repository hinzu.
4. Fügt Chaotic-AUR hinzu.
5. Lädt die Dotfiles herunter.
6. Sichert vorhandene Benutzerkonfigurationen, wo nötig.
7. Installiert die BSPWM-Umgebung.
8. Aktiviert MPD für Musikfunktionen.
9. Ändert die Shell zu ZSH.
Das Skript verschiebt außerdem viele vorhandene Konfigurationsordner in ein Sicherungsverzeichnis, bevor es sie ersetzt. Mach trotzdem vorher deine eigene Sicherung.
## Erster Login
Nach der Installation:
1. Starte neu oder melde dich ab.
2. Wähle die BSPWM-Sitzung in deinem Anmeldemanager aus.
3. Melde dich ganz normal an.
4. Warte, bis der erste Start die automatische Konfiguration abgeschlossen hat.
5. Teste Terminal, Rofi, Polybar, Theme-Auswahl und Hintergrundbild-Auswahl.
Wenn du in einer virtuellen Maschine bist und sich der Desktop kaputt oder langsam anfühlt, versuche, Picom von `glx` zu `xrender` zu ändern, bevor du annimmst, dass die Installation fehlgeschlagen ist.
## Zuerst zu prüfende Dinge
Überprüfe nach dem ersten Start die hardwarebezogenen Variablen. Öffne:
```bash
~/.config/bspwm/config/system.ini
```
Prüfe Werte für:
| Wert | Warum es wichtig ist |
| --------------------- | ---------------------------------------- |
| Netzwerkschnittstelle | Netzwerkmodule in der Leiste. |
| Grafikkarte | Einige visuelle und Status-Module. |
| Akku und Netzteil | Akku- und Helligkeitsmodule für Laptops. |
Wenn du einen Desktop-PC nutzt, ist die Netzwerkschnittstelle normalerweise die wichtigste Einstellung.
## Nützliche Befehle
| Befehl | Verwenden Sie |
| ----------------------------------- | --------------------------------------------------------------- |
| `RiceSelector` | Öffne die Theme-Auswahl. |
| `RiceEditor` | Bearbeite das aktuelle Theme visuell. |
| `WallSelect` | Öffne die Hintergrundbild-Auswahl. |
| `Term --selecterm` | Wähle die Terminal-App aus. |
| `OpenApps --menu` | Öffne den App-Launcher. |
| `OpenApps --KeyHelp` | Öffne den Tastaturbelegungs-Spickzettel. |
| `OpenApps --screenshot` | Öffne das Screenshot-Tool. |
| `OpenApps --netmanager` | Öffne das Netzwerkmanager-Applet. |
| `OpenApps --bluetooth` | Öffne das Bluetooth-Applet. |
| `OpenApps --clipboard` | Öffne den Zwischenablage-Manager. |
| `OpenApps --powermenu` | Öffne das Energie-Menü. |
| `OpenApps --keyboard` | Öffne das Applet für Tastaturlayout. |
| `OpenApps --scratch` | Öffne Scratchpad. |
| `HideBar -h` | Leisten ausblenden. |
| `HideBar -u` | Leisten einblenden. |
| `SoftReload` | Lade die Umgebung sanft neu. |
| `ScreenLocker` | Sperre den Bildschirm. |
| `bspc wm -r` | BSPWM neu laden. |
| `pkill -USR1 -x sxhkd` | Tastaturbelegungen neu laden. |
| `~/.config/bspwm/config/system.ini` | Nach der Installation zu überprüfende Hardware-/Modulvariablen. |
| `~/.config/bspwm/config/sxhkdrc` | Hauptdatei für Tastaturbelegungen. |
## Vollständige Tastaturbelegungen
Das Projekt zeigt den visuellen Spickzettel mit `Alt + F1`. `Super` steht auf den meisten Tastaturen für die Windows-Taste. Die maßgebliche Quelle ist die installierte `~/.config/bspwm/config/sxhkdrc`; diese Tabelle folgt der aktuellen Upstream-Datei und gruppiert alle Tastenkürzel, damit sie leichter zu überblicken sind.
### Hilfe
| Tasten | Aktion |
| ---------- | ---------------------------------------- |
| `Alt + F1` | Zeige den Tastaturbelegungs-Spickzettel. |
### Hauptanwendungen
| Tasten | Aktion |
| ---------------------- | ------------------------------- |
| `Super + Return` | Öffne ein normales Terminal. |
| `Super + Alt + Return` | Öffne ein schwebendes Terminal. |
| `Super + Space` | Öffne den App-Launcher. |
| `Alt + Space` | Öffne die Theme-Auswahl. |
| `Super + B` | Öffne den Browser. |
| `Super + E` | Öffne den Editor. |
| `Super + F` | Öffne den Dateimanager. |
| `Super + Y` | Öffne Yazi. |
| `Super + V` | Öffne Neovim. |
| `Super + M` | Öffne den Musikplayer/Ncmpcpp. |
| `Super + P` | Öffne Pavucontrol. |
| `Super + T` | Öffne Telegram. |
| `Super + W` | Öffne WhatsApp. |
| `Super + R` | Öffne RiceEditor. |
### Rofi-Applets
| Tasten | Aktion |
| ----------------------------- | -------------------------------- |
| `Super + Alt + T` | Terminal-Auswahl. |
| `Super + Alt + W` | Hintergrundbild-Auswahl. |
| `Super + Alt + A` | Android-Einhänge-Applet. |
| `Super + Alt + N` | Netzwerkmanager. |
| `Super + Alt + B` | Bluetooth-Manager. |
| `Super + Alt + C` | Zwischenablage-Manager. |
| `Super + Alt + S` | Screenshot-Tool. |
| `Super + Alt + P` | Energie-Menü. |
| `Super + Alt + L` | Auswahl des Rofi-Launcher-Stils. |
| `Super + Alt + K` | Applet für Tastaturlayout. |
| `Super + Alt + X` | RofiPass-/Passwort-Applet. |
| `Rechtsklick auf dem Desktop` | Öffne Jgmenu. |
### System und Umgebung
| Tasten | Aktion |
| ------------------------ | ----------------------------------------------------- |
| `Super + Alt + O` | Scratchpad. |
| `Ctrl + Super + Alt + P` | Computer ausschalten. |
| `Ctrl + Super + Alt + R` | Computer neu starten. |
| `Ctrl + Super + Alt + Q` | Abmelden. |
| `Ctrl + Super + Alt + L` | Bildschirm sperren. |
| `Ctrl + Super + Alt + K` | Anwendung beenden mit `xkill`. |
| `Ctrl + Super + Alt + S` | Sanft neu laden. |
| `Super + Alt + H` | Leiste ausblenden. |
| `Super + Alt + U` | Leiste einblenden. |
| `Ctrl + Alt + Plus` | Erhöhe die Transparenz des fokussierten Fensters. |
| `Ctrl + Alt + Minus` | Verringere die Transparenz des fokussierten Fensters. |
| `Ctrl + Alt + T` | Transparenz des fokussierten Fensters zurücksetzen. |
| `XF86MonBrightnessUp` | Helligkeit erhöhen. |
| `XF86MonBrightnessDown` | Helligkeit verringern. |
| `XF86AudioRaiseVolume` | Lautstärke erhöhen. |
| `XF86AudioLowerVolume` | Lautstärke verringern. |
| `XF86AudioMute` | Stummschaltung umschalten. |
| `XF86AudioNext` | Nächster Medientitel. |
| `XF86AudioPrev` | Vorheriger Medientitel. |
| `XF86AudioPlay` | Medien abspielen/pausieren. |
| `XF86AudioStop` | Medien stoppen. |
### BSPWM-Kern
| Tasten | Aktion |
| ---------------------- | ------------------------------------ |
| `Super + Alt + R` | BSPWM neu laden. |
| `Super + X` | Fokussierten Knoten schließen. |
| `Super + Umschalt + X` | Fokussierten Knoten beenden. |
| `Super + Escape` | sxhkd-Tastenkombinationen neu laden. |
### Knotenstatus und Flags
| Tasten | Aktion |
| -------------------- | ---------------------------------------------------------- |
| `Alt + T` | Knoten als gekachelt setzen. |
| `Alt + Umschalt + T` | Knoten als Pseudo-Gekachelt setzen. |
| `Alt + A` | Knoten als schwebend setzen. |
| `Alt + F` | Knoten im Vollbildmodus setzen. |
| `Alt + M` | Markierungsflag umschalten. |
| `Alt + X` | Sperrflag umschalten. |
| `Alt + S` | Sticky-Flag umschalten. |
| `Alt + P` | Privat-Flag umschalten. |
| `Alt + H` | Fokussiertes Fenster ausblenden. |
| `Strg + Alt + H` | Menü zum Wiederherstellen ausgeblendeter Fenster anzeigen. |
### Arbeitsflächen und Fokus
| Tasten | Aktion |
| ---------------------------------------- | ---------------------------------------------------------------------- |
| `Strg + Tab` | Desktop drehen. |
| `Super + Links` | Zur vorherigen Arbeitsfläche wechseln. |
| `Super + Rechts` | Zur nächsten Arbeitsfläche wechseln. |
| `Super + 1` zu `Super + 9` | Arbeitsfläche 1 bis 9 fokussieren. |
| `Super + 0` | Arbeitsfläche 10 fokussieren. |
| `Super + Strg + 1` zu `Super + Strg + 9` | Fokussiertes Fenster an Arbeitsfläche 1 bis 9 senden. |
| `Super + Strg + 0` | Fokussiertes Fenster an Arbeitsfläche 10 senden. |
| `Super + Strg + Links` | Fokussiertes Fenster an die vorherige Arbeitsfläche senden und folgen. |
| `Super + Strg + Rechts` | Fokussiertes Fenster an die nächste Arbeitsfläche senden und folgen. |
| `Alt + Tab` | Fensterumschalter. |
| `Super + Alt + Links` | Fenster im Westen fokussieren, vorheriges als Ersatz. |
| `Super + Alt + Unten` | Fenster im Süden fokussieren. |
| `Super + Alt + Oben` | Fenster im Norden fokussieren. |
| `Super + Alt + Rechts` | Fenster im Osten fokussieren, nächstes als Ersatz. |
| `Strg + Alt + Links` | Fokussiertes Fenster nach Westen verschieben. |
| `Strg + Alt + Unten` | Fokussiertes Fenster nach Süden verschieben. |
| `Strg + Alt + Oben` | Fokussiertes Fenster nach Norden verschieben. |
| `Strg + Alt + Rechts` | Fokussiertes Fenster nach Osten verschieben. |
| `Strg + Umschalt + Komma` | Letzten Knoten fokussieren. |
| `Strg + Umschalt + Punkt` | Letzten Desktop fokussieren. |
### Vorabwahl
| Tasten | Aktion |
| ------------------ | --------------------------------------- |
| `Super + Strg + H` | Horizontale/östliche Teilung vorwählen. |
| `Super + Strg + V` | Vertikale/südliche Teilung vorwählen. |
| `Super + Strg + Q` | Vorabwahl abbrechen. |
### Verschieben und Größe ändern
| Tasten | Aktion |
| --------------------------- | -------------------------------------------- |
| `Super + Strg + B` | Desktop-Knoten ausgleichen. |
| `Super + Alt + Plus` | Größe des gekachelten Knotens vergrößern. |
| `Super + Alt + Minus` | Größe des gekachelten Knotens verkleinern. |
| `Super + Strg + Plus` | Größe des schwebenden Knotens vergrößern. |
| `Super + Strg + Minus` | Größe des schwebenden Knotens verkleinern. |
| `Super + Umschalt + Links` | Schwebendes Fenster nach links verschieben. |
| `Super + Umschalt + Unten` | Schwebendes Fenster nach unten verschieben. |
| `Super + Umschalt + Oben` | Schwebendes Fenster nach oben verschieben. |
| `Super + Umschalt + Rechts` | Schwebendes Fenster nach rechts verschieben. |
### Mehrfachoperation
| Tasten | Aktion |
| ---------------------------- | ------------------------------------------------------------------ |
| `Super + Strg + X` | Alle Knoten auf dem aktuellen Desktop schließen. |
| `Super + N`, dann `X` | Alle nicht fokussierten lokalen Fenster schließen. |
| `Super + N`, dann `K` | Alle nicht fokussierten lokalen Fenster beenden. |
| `Super + N`, dann `M` | Alle markierten Fenster auf den fokussierten Desktop bringen. |
| `Super + N`, dann `1` zu `9` | Alle Fenster von diesem Desktop auf den aktuellen Desktop bringen. |
## Allgemeine Anpassung
### Design ändern
Verwenden Sie:
```
Alt + Space
```
Wählen Sie ein Design aus dem Selektor. Die Umgebung wird aktualisiert, ohne dass die gesamte Sitzung neu gestartet werden muss.
### Hintergrundbild ändern
Verwenden Sie:
```
Super + Alt + W
```
Das Projekt unterstützt zufällige Hintergrundbilder, benutzerdefinierte Verzeichnisse, feste Hintergrundbilder, animierte Hintergrundbilder und Diashow-Verhalten.
### Aktuelles Design bearbeiten
Verwenden Sie RiceEditor, wenn Sie visuelle Einstellungen anpassen möchten, ohne jedes Modul manuell zu bearbeiten:
```
RiceEditor
```
Typische Änderungen umfassen Rahmen, Schatten, Animationen, Transparenz, Hintergrundbildverhalten und modulspezifische Designeinstellungen.
## Fehlerbehebung
| Problem | Was zu prüfen ist |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Anmeldung kehrt zum Display-Manager zurück | Bestätigen Sie, dass die BSPWM-Sitzung installiert ist, und prüfen Sie `~/.xsession-errors`. |
| Leistenmodule sind falsch | Prüfen Sie `~/.config/bspwm/config/system.ini`. |
| Netzwerk-Applet funktioniert nicht | Bestätigen Sie, dass NetworkManager installiert ist und läuft. |
| VM-Grafik sieht fehlerhaft aus | Versuchen Sie Picom `xrender` Backend statt `glx`. |
| Tastenkombinationen funktionieren nicht | Prüfen Sie `sxhkd` läuft und prüfen Sie `~/.config/bspwm/config/sxhkdrc`. |
| Design wirkt nicht ausgerichtet | Das Projekt ist auf 1600x900 und 96 DPI ausgelegt; passen Sie es an Ihren Monitor an. |
| Vorhandene Konfigurationen sind verschwunden | Prüfen Sie den Sicherungsordner, den der Installer erstellt hat, und Ihre eigenen `dotfiles-backup`. |
## Hinweise zur sauberen Neuinstallation
Für den sichersten erneuten Versuch:
1. Sichern Sie Ihre aktuellen Dateien.
2. Entfernen oder verschieben Sie alte Dotfiles-Verzeichnisse.
3. Laden Sie die neueste `RiceInstaller`.
4. Prüfen Sie das Skript erneut.
5. Führen Sie es von `$HOME` als normaler Benutzer aus.
Führen Sie keine zufällig modifizierten Installer aus Drittanbieter-Forks aus, es sei denn, Sie haben den Diff überprüft.
## Referenzen
* [Offizielles Repository von gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles)
* [RiceInstaller](https://github.com/gh0stzk/dotfiles/blob/master/RiceInstaller)
* [Erste Schritte nach der Installation](https://github.com/gh0stzk/dotfiles/wiki/First-steps-after-installation)
* [Wiki zu Tastenkombinationen](https://github.com/gh0stzk/dotfiles/wiki/Keyboard-Shortcuts)
* [Aktuelle sxhkdrc-Tastenkombinationsdatei](https://github.com/gh0stzk/dotfiles/blob/master/config/bspwm/config/sxhkdrc)
* [Wiki zur Hintergrundbildkonfiguration](https://github.com/gh0stzk/dotfiles/wiki/Wallpapers-Configuration)
* [ArchWiki: bspwm](https://wiki.archlinux.org/title/Bspwm)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://hacking-notes.jord4n.pro/de/useful-resources/gh0stzk-bspwm-dotfiles.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
