> 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 Arch-Linux-Hacker-Setup-Anleitung mit gh0stzk-BSPWM-Dotfiles, schneller Installation, Themes, Polybar, Rofi, ZSH, Neovim, Befehlen und Tastenkürzeln. [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.
gh0stzk BSPWM dotfiles desktop screenshot with terminal and Linux fetch output

Beispiel für eine BSPWM-Desktopumgebung aus der Projekt-README.

{% hint style="warning" %} Installiere dies nur auf einem persönlichen Laborrechner oder einem frischen Linux-Workstation-System. Dotfiles ersetzen viele Benutzerkonfigurationsdateien, daher solltest du den Installer prüfen und dein aktuelles Setup sichern, bevor du ihn ausführst. {% endhint %} ## Wo es hineinpasst Das 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, auf Arch basierende 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 | Tiling-Fenstermanager für einen schnellen, tastaturgesteuerten Desktop. | | 18 Themes | Vorgefertigte visuelle Stile, die sich im laufenden Betrieb wechseln lassen. | | Polybar | Desktop-Leiste mit Arbeitsflächen, Modulen, Systeminfos und Theme-Farben. | | Rofi-Applets | Menüs für Apps, Energie, 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 Vervollständigungen, 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 solltest du vor der Installation die Screenshots und die Demo ansehen.
gh0stzk dotfiles theme selector screenshot

Theme-Auswahl.

gh0stzk dotfiles wallpaper selector screenshot

Auswahl des Hintergrundbilds.

gh0stzk dotfiles RiceEditor screenshot

RiceEditor zur Theme-Anpassung.

### Projekt-Demo {% embed url="" %} ### Arch-Installationsdurchlauf Dieses Creator-Video 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 steht, dass nicht-systemd-basierte Distributionen wie Artix nicht unterstützt werden. Empfohlener Ausgangspunkt: | Voraussetzung | 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. | | Anmelde-Manager | LightDM wird vom Projekt empfohlen. | | NetworkManager | Wird für das Rofi-Netzwerk-Applet benötigt. | | Backup | Bewahre eine Kopie der vorhandenen `~/.config` und Shell-Dateien auf. | Nützlicher Backup-Befehl 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 auf einem sauberen Arch-Rechner oder einer VM startest und den kürzest möglichen praktikablen Weg suchst. ### 1. Arch-ISO booten Starte mit dem offiziellen Arch-ISO. Wenn du WLAN nutzt, verbinde dich zuerst: ```bash iwctl ``` Darin `iwctl`: ``` device list 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ähle | | ------------------ | ---------------------------------------------------------------------------- | | Festplattenlayout | Standard oder manuell, je nach VM/Festplatte. | | 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 neu starten ``` ### 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 erst aktiviert hast: ```bash sudo reboot ``` ## Dotfiles-Installation Öffne ein Terminal aus deinem Home-Verzeichnis: ```bash cd "$HOME" ``` Den offiziellen Installer herunterladen: ```bash curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller ``` Den Installer vor dem Ausführen prüfen: ```bash less RiceInstaller ``` Führe ihn mit Ausführungsrechten aus: ```bash chmod +x RiceInstaller ``` Führe ihn als normaler 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 Enter zu drücken. ### Ein-Block-Installation Für eine schnelle Labor-Installation, nachdem du bereits ein funktionierendes Arch hast: ```bash cd "$HOME" curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller less RiceInstaller chmod +x RiceInstaller ./RiceInstaller ``` ## Was der Installer macht Auf hoher Ebene macht der Installer Folgendes: 1. Prüft, dass er nicht als root ausgeführt wird. 2. Prüft, dass er ausgeführt wird von `$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 auch viele vorhandene Konfigurationsordner in ein Backup-Verzeichnis, bevor es sie ersetzt. Erstelle trotzdem zuerst dein eigenes Backup. ## Erster Login Nach der Installation: 1. Neu starten oder abmelden. 2. Wähle die BSPWM-Sitzung in deinem Login-Manager aus. 3. Melde dich normal an. 4. Warte, bis der erste Start die Autokonfiguration abgeschlossen hat. 5. Teste Terminal, Rofi, Polybar, Theme-Auswahl und Hintergrundbild-Auswahl. Wenn du dich in einer virtuellen Maschine befindest und sich der Desktop kaputt oder langsam anfühlt, versuche Picom von `glx` zu ändern `xrender` umzustellen, bevor du annimmst, dass die Installation fehlgeschlagen ist. ## Erste Dinge, die du prüfen solltest Ü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 Statusmodule. | | Akku und Netzteil | Laptop-Akku- und Helligkeitsmodule. | Wenn du einen Desktop-PC nutzt, ist die Netzwerkschnittstelle normalerweise die wichtigste, auf die du achten musst. ## Nützliche Befehle | Befehl | Verwenden Sie | | ----------------------------------- | ----------------------------------------------------------------------- | | `RiceSelector` | Den Theme-Auswahlbildschirm öffnen. | | `RiceEditor` | Das aktuelle Theme visuell bearbeiten. | | `WallSelect` | Hintergrundbild-Auswahl öffnen. | | `Term --selecterm` | Die Terminal-App auswählen. | | `OpenApps --menu` | App-Starter öffnen. | | `OpenApps --KeyHelp` | Das Spickblatt für Tastenkombinationen öffnen. | | `OpenApps --screenshot` | Screenshot-Tool öffnen. | | `OpenApps --netmanager` | Netzwerkmanager-Applet öffnen. | | `OpenApps --bluetooth` | Bluetooth-Applet öffnen. | | `OpenApps --clipboard` | Zwischenablage-Manager öffnen. | | `OpenApps --powermenu` | Energie-Menü öffnen. | | `OpenApps --keyboard` | Applet für das Tastaturlayout öffnen. | | `OpenApps --scratch` | Scratchpad öffnen. | | `HideBar -h` | Leisten ausblenden. | | `HideBar -u` | Leisten anzeigen. | | `SoftReload` | Die Umgebung sanft neu laden. | | `ScreenLocker` | Den Bildschirm sperren. | | `bspc wm -r` | BSPWM neu laden. | | `pkill -USR1 -x sxhkd` | Tastenkombinationen neu laden. | | `~/.config/bspwm/config/system.ini` | Hardware-/Modulvariablen, die nach der Installation zu überprüfen sind. | | `~/.config/bspwm/config/sxhkdrc` | Hauptdatei für Tastenkombinationen. | ## Vollständige Tastenkombinationen Das Projekt zeigt das visuelle Spickblatt mit `Alt + F1`. `Super` bedeutet auf den meisten Tastaturen die Windows-Taste. Die maßgebliche Quelle ist die installierte `~/.config/bspwm/config/sxhkdrc`; diese Tabelle folgt der aktuellen Upstream-Datei und gruppiert jede Tastenkombination, damit sie leichter zu überblicken ist. ### Hilfe | Tasten | Aktion | | ---------- | ------------------------------------------------ | | `Alt + F1` | Das Spickblatt für Tastenkombinationen anzeigen. | ### Haupt-Apps | Tasten | Aktion | | ---------------------- | ---------------------------- | | `Super + Return` | Normales Terminal öffnen. | | `Super + Alt + Return` | Schwebendes Terminal öffnen. | | `Super + Space` | App-Starter öffnen. | | `Alt + Space` | Theme-Auswahl öffnen. | | `Super + B` | Browser öffnen. | | `Super + E` | Editor öffnen. | | `Super + F` | Dateimanager öffnen. | | `Super + Y` | Yazi öffnen. | | `Super + V` | Neovim öffnen. | | `Super + M` | Musikplayer/Ncmpcpp öffnen. | | `Super + P` | Pavucontrol öffnen. | | `Super + T` | Telegram öffnen. | | `Super + W` | WhatsApp öffnen. | | `Super + R` | RiceEditor öffnen. | ### Rofi-Applets | Tasten | Aktion | | ----------------------------- | ----------------------------------- | | `Super + Alt + T` | Terminal-Auswahl. | | `Super + Alt + W` | Auswahl des Hintergrundbilds. | | `Super + Alt + A` | Android-Mount-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` | Rofi-Auswahl für den Launcher-Stil. | | `Super + Alt + K` | Applet für das Tastaturlayout. | | `Super + Alt + X` | RofiPass-/Passwort-Applet. | | `Rechtsklick auf den Desktop` | Jgmenu öffnen. | ### 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 anzeigen. | | `Ctrl + Alt + Plus` | Transparenz des fokussierten Fensters erhöhen. | | `Ctrl + Alt + Minus` | Transparenz des fokussierten Fensters verringern. | | `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 anhalten. | ### 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-Tastenbelegungen neu laden. | ### Knotenstatus und Flags | Tasten | Aktion | | -------------------- | ---------------------------------------------------------- | | `Alt + T` | Knoten auf gekachelt setzen. | | `Alt + Umschalt + T` | Knoten auf pseudo-gekachelt setzen. | | `Alt + A` | Knoten auf schwebend setzen. | | `Alt + F` | Knoten auf Vollbild setzen. | | `Alt + M` | Markierungs-Flag umschalten. | | `Alt + X` | Sperr-Flag umschalten. | | `Alt + S` | Sticky-Flag umschalten. | | `Alt + P` | Privat-Flag umschalten. | | `Alt + H` | Fokiertes Fenster ausblenden. | | `Strg + Alt + H` | Menü zum Wiederherstellen ausgeblendeter Fenster anzeigen. | ### Arbeitsbereiche und Fokus | Tasten | Aktion | | ----------------------------------------------- | --------------------------------------------------------------------- | | `Strg + Tab` | Desktop drehen. | | `Super + Links` | Zum vorherigen Arbeitsbereich wechseln. | | `Super + Rechts` | Zum nächsten Arbeitsbereich wechseln. | | `Super + 1` zu ändern `Super + 9` | Arbeitsbereich 1 bis 9 fokussieren. | | `Super + 0` | Arbeitsbereich 10 fokussieren. | | `Super + Strg + 1` zu ändern `Super + Strg + 9` | Fokiertes Fenster an Arbeitsbereich 1 bis 9 senden. | | `Super + Strg + 0` | Fokiertes Fenster an Arbeitsbereich 10 senden. | | `Super + Strg + Links` | Fokiertes Fenster an den vorherigen Arbeitsbereich senden und folgen. | | `Super + Strg + Rechts` | Fokiertes Fenster an den nächsten Arbeitsbereich senden und folgen. | | `Alt + Tab` | Fensterwechsler. | | `Super + Alt + Links` | Fenster nach Westen fokussieren, auf vorheriges zurückgreifen. | | `Super + Alt + Unten` | Fenster nach Süden fokussieren. | | `Super + Alt + Oben` | Fenster nach Norden fokussieren. | | `Super + Alt + Rechts` | Fenster nach Osten fokussieren, auf nächstes zurückgreifen. | | `Strg + Alt + Links` | Fokiertes Fenster nach Westen verschieben. | | `Strg + Alt + Unten` | Fokiertes Fenster nach Süden verschieben. | | `Strg + Alt + Oben` | Fokiertes Fenster nach Norden verschieben. | | `Strg + Alt + Rechts` | Fokiertes Fenster nach Osten verschieben. | | `Strg + Umschalt + Komma` | Letzten Knoten fokussieren. | | `Strg + Umschalt + Punkt` | Letzten Desktop fokussieren. | ### Vorauswahl | Tasten | Aktion | | ------------------ | ------------------------------------------ | | `Super + Strg + H` | Horizontale/östliche Teilung vorauswählen. | | `Super + Strg + V` | Vertikale/südliche Teilung vorauswählen. | | `Super + Strg + Q` | Vorauswahl abbrechen. | ### Verschieben und Größe ändern | Tasten | Aktion | | --------------------------- | -------------------------------------------- | | `Super + Strg + B` | Desktop-Knoten ausbalancieren. | | `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 im 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 ändern `9` | Jedes Fenster von diesem Desktop auf den aktuellen Desktop bringen. | ## Allgemeine Anpassung ### Theme ändern Verwenden Sie: ``` Alt + Space ``` Wählen Sie ein Theme aus dem Auswahlfeld. 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 Hintergründe, benutzerdefinierte Verzeichnisse, feste Hintergründe, animierte Hintergründe und Diashow-Verhalten. ### Aktuelles Theme bearbeiten Verwenden Sie RiceEditor, wenn Sie visuelle Einstellungen anpassen möchten, ohne jedes Modul manuell zu bearbeiten: ``` RiceEditor ``` Typische Anpassungen sind Ränder, Schatten, Animationen, Transparenz, Hintergrundbildverhalten und moduleigene Theme-Einstellungen. ## Fehlerbehebung | Problem | Worauf zu achten 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 `~/.config/bspwm/config/system.ini`. | | Netzwerk-Applet funktioniert nicht | Bestätigen Sie, dass NetworkManager installiert und ausgeführt wird. | | VM-Grafik sieht kaputt aus | Probieren Sie Picom `xrender` Backend statt `glx`. | | Tastenkombinationen funktionieren nicht | Prüfen `sxhkd` läuft und prüfen Sie `~/.config/bspwm/config/sxhkdrc`. | | Theme sieht nicht ausgerichtet aus | Das Projekt ist auf 1600x900 und 96 DPI ausgelegt; passen Sie es an Ihren Monitor an. | | Vorhandene Konfigurationen sind verschwunden | Prüfen Sie den vom Installer erstellten Backup-Ordner 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 Version erneut herunter `RiceInstaller`. 4. Überprüfen Sie das Skript erneut. 5. Führen Sie es von `$HOME` als normaler Benutzer aus. Führen Sie keine zufällig modifizierten Installer von Drittanbieter-Forks aus, sofern Sie den Diff nicht geprüft haben. ## 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-Datei mit Tastenkombinationen](https://github.com/gh0stzk/dotfiles/blob/master/config/bspwm/config/sxhkdrc) * [Wiki zur Hintergrundbild-Konfiguration](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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.