> 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/fr/useful-resources/gh0stzk-bspwm-dotfiles.md).
# Configuration de hacker Arch Linux avec BSPWM
Guide de configuration de hacker Arch Linux avec les dotfiles gh0stzk BSPWM, installation rapide, thèmes, Polybar, Rofi, ZSH, Neovim, commandes et raccourcis clavier.
[gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) est un environnement de bureau BSPWM complet pour Arch Linux et les distributions basées sur Arch. Il inclut des thèmes, des barres, des lanceurs, des paramètres de terminal, ZSH, Neovim, des applets Rofi, des fonds d'écran et des scripts d'aide pour changer rapidement de style.
Exemple d'environnement de bureau BSPWM tiré du README du projet.
{% hint style="warning" %}
Installez ceci uniquement sur une machine de laboratoire personnelle ou sur une station Linux fraîchement installée. Les dotfiles remplacent de nombreux fichiers de configuration utilisateur, alors examinez l'installateur et sauvegardez votre configuration actuelle avant de l'exécuter.
{% endhint %}
## Où cela s'inscrit
Cela appartient à `Ressources utiles` car il s'agit d'une ressource de configuration de poste de travail, pas d'un outil de pentest. Utilisez-la lorsque vous voulez un environnement BSPWM propre basé sur Arch pour les notes quotidiennes, les labos, le travail CTF, le développement et les flux de travail axés sur le terminal.
## Ce qu'elle vous apporte
| Composant | Ce que cela signifie |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| BSPWM | Gestionnaire de fenêtres en tuilage pour un bureau rapide piloté au clavier. |
| 18 thèmes | Styles visuels prêts à l'emploi, pouvant être changés à la volée. |
| Polybar | Barre de bureau avec espaces de travail, modules, infos système et couleurs du thème. |
| Applets Rofi | Menus pour les applications, l'alimentation, les captures d'écran, le presse-papiers, le réseau, le Bluetooth, les fonds d'écran, et plus encore. |
| Terminaux | Prise en charge des thèmes pour Alacritty, Kitty, Ghostty, ST et Xfce Terminal. |
| Configuration ZSH | Configuration de shell rapide avec complétions, recherche dans l'historique et aperçus fzf-tab. |
| Configuration Neovim | Configuration d'éditeur préconfigurée avec LSP, autocomplétion, formatage, explorateur, barre d'état et tableau de bord. |
| RiceEditor | Application d'aide pour ajuster les paramètres visuels sans modifier manuellement chaque configuration. |
## Aperçu visuel
Le projet est très visuel, alors consultez les captures d'écran et la démo avant l'installation.
Sélecteur de thème.
Sélecteur de fond d'écran.
RiceEditor pour la personnalisation du thème.
### Démo du projet
{% embed url="" %}
### Guide d'installation Arch
Cette vidéo du créateur est utile si vous voulez une installation Arch propre avant d'appliquer les dotfiles.
{% embed url="" %}
### Chaîne du projet
La chaîne de l'auteur contient davantage de démonstrations BSPWM, Polybar, Eww, Rofi et de thèmes.
{% embed url="" %}
## Avant l'installation
L'installateur officiel est destiné à Arch Linux et aux distributions basées sur Arch. Le README précise que les distributions sans systemd comme Artix ne sont pas prises en charge.
Point de départ recommandé :
| Exigence | Notes |
| ----------------------------------- | ------------------------------------------------------------- |
| Distribution Arch ou basée sur Arch | Une installation fraîche est la plus sûre. |
| Compte utilisateur normal | N'exécutez pas l'installateur en tant que root. |
| Connexion internet fonctionnelle | L'installateur télécharge des paquets et des dépôts. |
| Gestionnaire de connexion | LightDM est recommandé par le projet. |
| NetworkManager | Nécessaire pour l'applet réseau Rofi. |
| Sauvegarde | Conservez une copie des `~/.config` et des fichiers du shell. |
Commande de sauvegarde utile avant de tester :
```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
```
## Configuration rapide d'Arch
Utilisez ceci lorsque vous partez d'une machine Arch propre ou d'une VM et que vous voulez le chemin le plus court possible.
### 1. Démarrez l'ISO Arch
Commencez avec l'ISO officiel d'Arch. Si vous utilisez le Wi-Fi, connectez-vous d'abord :
```bash
iwctl
```
Dans `iwctl`:
```
liste des appareils
station wlan0 scan
station wlan0 get-networks
station wlan0 connect "SSID"
exit
```
Vérifiez la connexion internet :
```bash
ping -c 3 archlinux.org
```
Synchronisez l'heure :
```bash
timedatectl set-ntp true
```
### 2. Installez Arch rapidement
La voie rapide est `archinstall`:
```bash
archinstall
```
Choix recommandés :
| Option | Choisissez |
| ----------------------- | ---------------------------------------------------------------------------- |
| Disposition du disque | Par défaut ou manuel, selon votre VM/disque. |
| Chargeur de démarrage | `systemd-boot` pour l'UEFI, GRUB si vous le préférez. |
| Profil | Minimal suffit ; le bureau est facultatif. |
| Réseau | NetworkManager. |
| Audio | PipeWire. |
| Utilisateur | Créez un utilisateur normal avec accès sudo. |
| Paquets supplémentaires | `git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager` |
Après l'installation :
```bash
reboot
```
### 3. Activez les éléments de base
Connectez-vous en tant qu'utilisateur normal, puis assurez-vous que les services de base sont prêts :
```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
```
Redémarrez une fois de plus si vous venez d'activer LightDM :
```bash
sudo reboot
```
## Installation des dotfiles
Ouvrez un terminal depuis votre répertoire personnel :
```bash
cd "$HOME"
```
Téléchargez l'installateur officiel :
```bash
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
```
Examinez l'installateur avant de l'exécuter :
```bash
less RiceInstaller
```
Accordez-lui l'autorisation d'exécution :
```bash
chmod +x RiceInstaller
```
Exécutez-le en tant qu'utilisateur normal :
```bash
./RiceInstaller
```
L'installateur est interactif. Il peut demander si vous souhaitez les configurations Neovim et Firefox incluses. Lisez chaque invite au lieu d'appuyer sur Entrée pour tout.
### Installation en un seul bloc
Pour une installation rapide en labo, une fois qu'Arch fonctionne déjà :
```bash
cd "$HOME"
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
less RiceInstaller
chmod +x RiceInstaller
./RiceInstaller
```
## Ce que fait l'installateur
À grands traits, l'installateur :
1. Vérifie qu'il n'est pas exécuté en tant que root.
2. Vérifie qu'il est exécuté depuis `$HOME`.
3. Ajoute le `gh0stzk-dotfiles` dépôt de paquets.
4. Ajoute Chaotic-AUR.
5. Télécharge les dotfiles.
6. Sauvegarde les configurations utilisateur existantes là où c'est nécessaire.
7. Installe l'environnement BSPWM.
8. Active MPD pour les fonctionnalités musicales.
9. Change le shell en ZSH.
Le script déplace aussi de nombreux dossiers de configuration existants dans un répertoire de sauvegarde avant de les remplacer. Malgré cela, conservez d'abord votre propre sauvegarde.
## Première connexion
Après l'installation :
1. Redémarrez ou déconnectez-vous.
2. Sélectionnez la session BSPWM dans votre gestionnaire de connexion.
3. Connectez-vous normalement.
4. Attendez que le premier lancement termine l'auto-configuration.
5. Testez le terminal, Rofi, Polybar, le sélecteur de thème et le sélecteur de fond d'écran.
Si vous êtes dans une machine virtuelle et que le bureau semble cassé ou lent, essayez de changer Picom de `glx` en `xrender` avant de supposer que l'installation a échoué.
## Premières vérifications
Après le premier lancement, vérifiez les variables liées au matériel. Ouvrez :
```bash
~/.config/bspwm/config/system.ini
```
Vérifiez les valeurs pour :
| Valeur | Pourquoi c'est important |
| ---------------------- | -------------------------------------------------------------- |
| Interface réseau | Modules réseau dans la barre. |
| Carte graphique | Certains modules visuels et d'état. |
| Batterie et adaptateur | Modules de batterie et de luminosité pour ordinateur portable. |
Si vous êtes sur un PC de bureau, l'interface réseau est généralement la principale à prendre en compte.
## Commandes utiles
| Commande | Utilisez |
| ----------------------------------- | ------------------------------------------------------------------ |
| `RiceSelector` | Ouvrez le sélecteur de thème. |
| `RiceEditor` | Modifiez visuellement le thème actuel. |
| `WallSelect` | Ouvrez le sélecteur de fond d'écran. |
| `Term --selecterm` | Choisissez l'application de terminal. |
| `OpenApps --menu` | Ouvrez le lanceur d'applications. |
| `OpenApps --KeyHelp` | Ouvrez le mémo des raccourcis clavier. |
| `OpenApps --screenshot` | Ouvrez l'outil de capture d'écran. |
| `OpenApps --netmanager` | Ouvrez l'applet du gestionnaire réseau. |
| `OpenApps --bluetooth` | Ouvrez l'applet Bluetooth. |
| `OpenApps --clipboard` | Ouvrez le gestionnaire de presse-papiers. |
| `OpenApps --powermenu` | Ouvrez le menu d'alimentation. |
| `OpenApps --keyboard` | Ouvrez l'applet de disposition du clavier. |
| `OpenApps --scratch` | Ouvrez le scratchpad. |
| `HideBar -h` | Masquez les barres. |
| `HideBar -u` | Affichez les barres. |
| `SoftReload` | Rechargez l'environnement en douceur. |
| `ScreenLocker` | Verrouillez l'écran. |
| `bspc wm -r` | Rechargez BSPWM. |
| `pkill -USR1 -x sxhkd` | Rechargez les raccourcis clavier. |
| `~/.config/bspwm/config/system.ini` | Variables matérielles/des modules à vérifier après l'installation. |
| `~/.config/bspwm/config/sxhkdrc` | Fichier principal des raccourcis clavier. |
## Raccourcis clavier complets
Le projet affiche le mémo visuel avec `Alt + F1`. `Super` désigne la touche Windows sur la plupart des claviers. La source de vérité est le fichier installé `~/.config/bspwm/config/sxhkdrc` ; ce tableau suit le fichier amont actuel et regroupe chaque raccourci pour faciliter la lecture.
### Aide
| Touches | Action |
| ---------- | ---------------------------------------- |
| `Alt + F1` | Affichez le mémo des raccourcis clavier. |
### Applications principales
| Touches | Action |
| ---------------------- | ------------------------------------- |
| `Super + Return` | Ouvrir le terminal normal. |
| `Super + Alt + Return` | Ouvrir le terminal flottant. |
| `Super + Space` | Ouvrez le lanceur d'applications. |
| `Alt + Space` | Ouvrir le sélecteur de thème. |
| `Super + B` | Ouvrir le navigateur. |
| `Super + E` | Ouvrir l'éditeur. |
| `Super + F` | Ouvrir le gestionnaire de fichiers. |
| `Super + Y` | Ouvrir Yazi. |
| `Super + V` | Ouvrir Neovim. |
| `Super + M` | Ouvrir le lecteur de musique/Ncmpcpp. |
| `Super + P` | Ouvrir Pavucontrol. |
| `Super + T` | Ouvrir Telegram. |
| `Super + W` | Ouvrir WhatsApp. |
| `Super + R` | Ouvrir RiceEditor. |
### Applets Rofi
| Touches | Action |
| -------------------------- | ----------------------------------- |
| `Super + Alt + T` | Sélecteur de terminal. |
| `Super + Alt + W` | Sélecteur de fond d'écran. |
| `Super + Alt + A` | Applet de montage Android. |
| `Super + Alt + N` | Gestionnaire réseau. |
| `Super + Alt + B` | Gestionnaire Bluetooth. |
| `Super + Alt + C` | Gestionnaire de presse-papiers. |
| `Super + Alt + S` | Outil de capture d'écran. |
| `Super + Alt + P` | Menu d'alimentation. |
| `Super + Alt + L` | Sélecteur de style du lanceur Rofi. |
| `Super + Alt + K` | Applet de disposition du clavier. |
| `Super + Alt + X` | Applet RofiPass/mot de passe. |
| `Clic droit sur le bureau` | Ouvrir Jgmenu. |
### Système et environnement
| Touches | Action |
| ------------------------ | --------------------------------------------------- |
| `Super + Alt + O` | Scratchpad. |
| `Ctrl + Super + Alt + P` | Éteindre l'ordinateur. |
| `Ctrl + Super + Alt + R` | Redémarrer l'ordinateur. |
| `Ctrl + Super + Alt + Q` | Se déconnecter. |
| `Ctrl + Super + Alt + L` | Verrouiller l'écran. |
| `Ctrl + Super + Alt + K` | Fermer l'application avec `xkill`. |
| `Ctrl + Super + Alt + S` | Rechargement en douceur. |
| `Super + Alt + H` | Masquer la barre. |
| `Super + Alt + U` | Afficher la barre. |
| `Ctrl + Alt + Plus` | Augmenter la transparence de la fenêtre active. |
| `Ctrl + Alt + Minus` | Diminuer la transparence de la fenêtre active. |
| `Ctrl + Alt + T` | Réinitialiser la transparence de la fenêtre active. |
| `XF86MonBrightnessUp` | Augmenter la luminosité. |
| `XF86MonBrightnessDown` | Diminuer la luminosité. |
| `XF86AudioRaiseVolume` | Augmenter le volume. |
| `XF86AudioLowerVolume` | Diminuer le volume. |
| `XF86AudioMute` | Basculer le mode muet. |
| `XF86AudioNext` | Piste média suivante. |
| `XF86AudioPrev` | Piste média précédente. |
| `XF86AudioPlay` | Lire/mettre en pause le média. |
| `XF86AudioStop` | Arrêter les médias. |
### Noyau BSPWM
| Touches | Action |
| ----------------- | --------------------------------------- |
| `Super + Alt + R` | Rechargez BSPWM. |
| `Super + X` | Fermer le nœud focalisé. |
| `Super + Maj + X` | Tuer le nœud focalisé. |
| `Super + Échap` | Recharger les raccourcis clavier sxhkd. |
### États et indicateurs des nœuds
| Touches | Action |
| ---------------- | ------------------------------------------------------ |
| `Alt + T` | Définir le nœud en mode carrelé. |
| `Alt + Maj + T` | Définir le nœud en mode pseudo-carrelé. |
| `Alt + A` | Définir le nœud flottant. |
| `Alt + F` | Définir le nœud en plein écran. |
| `Alt + M` | Basculer l'indicateur marqué. |
| `Alt + X` | Basculer l'indicateur verrouillé. |
| `Alt + S` | Basculer l'indicateur collant. |
| `Alt + P` | Basculer l'indicateur privé. |
| `Alt + H` | Masquer la fenêtre focalisée. |
| `Ctrl + Alt + H` | Afficher le menu pour restaurer les fenêtres masquées. |
### Espaces de travail et focus
| Touches | Action |
| ---------------------------------------- | -------------------------------------------------------------------------- |
| `Ctrl + Tab` | Faire pivoter le bureau. |
| `Super + Gauche` | Passer à l'espace de travail précédent. |
| `Super + Droite` | Passer à l'espace de travail suivant. |
| `Super + 1` en `Super + 9` | Focaliser les espaces de travail 1 à 9. |
| `Super + 0` | Focaliser l'espace de travail 10. |
| `Super + Ctrl + 1` en `Super + Ctrl + 9` | Envoyer la fenêtre focalisée vers les espaces de travail 1 à 9. |
| `Super + Ctrl + 0` | Envoyer la fenêtre focalisée vers l'espace de travail 10. |
| `Super + Ctrl + Gauche` | Envoyer la fenêtre focalisée vers l'espace de travail précédent et suivre. |
| `Super + Ctrl + Droite` | Envoyer la fenêtre focalisée vers l'espace de travail suivant et suivre. |
| `Alt + Tab` | Sélecteur de fenêtres. |
| `Super + Alt + Gauche` | Focaliser la fenêtre à l'ouest, retour au précédent. |
| `Super + Alt + Bas` | Focaliser la fenêtre au sud. |
| `Super + Alt + Haut` | Focaliser la fenêtre au nord. |
| `Super + Alt + Droite` | Focaliser la fenêtre à l'est, retour au suivant. |
| `Ctrl + Alt + Gauche` | Échanger la fenêtre focalisée vers l'ouest. |
| `Ctrl + Alt + Bas` | Échanger la fenêtre focalisée vers le sud. |
| `Ctrl + Alt + Haut` | Échanger la fenêtre focalisée vers le nord. |
| `Ctrl + Alt + Droite` | Échanger la fenêtre focalisée vers l'est. |
| `Ctrl + Maj + Virgule` | Focaliser le dernier nœud. |
| `Ctrl + Maj + Point` | Focaliser le dernier bureau. |
### Pré-sélection
| Touches | Action |
| ------------------ | ------------------------------------------------ |
| `Super + Ctrl + H` | Pré-sélectionner une séparation horizontale/est. |
| `Super + Ctrl + V` | Pré-sélectionner une séparation verticale/sud. |
| `Super + Ctrl + Q` | Annuler la pré-sélection. |
### Déplacement et redimensionnement
| Touches | Action |
| ---------------------- | --------------------------------------------- |
| `Super + Ctrl + B` | Équilibrer les nœuds du bureau. |
| `Super + Alt + Plus` | Augmenter la taille du nœud carrelé. |
| `Super + Alt + Moins` | Réduire la taille du nœud carrelé. |
| `Super + Ctrl + Plus` | Augmenter la taille du nœud flottant. |
| `Super + Ctrl + Moins` | Réduire la taille du nœud flottant. |
| `Super + Maj + Gauche` | Déplacer la fenêtre flottante vers la gauche. |
| `Super + Maj + Bas` | Déplacer la fenêtre flottante vers le bas. |
| `Super + Maj + Haut` | Déplacer la fenêtre flottante vers le haut. |
| `Super + Maj + Droite` | Déplacer la fenêtre flottante vers la droite. |
### Opération multiple
| Touches | Action |
| ---------------------------- | -------------------------------------------------------------- |
| `Super + Ctrl + X` | Fermer tous les nœuds du bureau actuel. |
| `Super + N`, puis `X` | Fermer toutes les fenêtres locales non focalisées. |
| `Super + N`, puis `K` | Tuer toutes les fenêtres locales non focalisées. |
| `Super + N`, puis `M` | Amener toutes les fenêtres marquées vers le bureau focalisé. |
| `Super + N`, puis `1` en `9` | Amener toutes les fenêtres de ce bureau vers le bureau actuel. |
## Personnalisation courante
### Changer de thème
Utilisez :
```
Alt + Space
```
Choisissez un thème dans le sélecteur. L'environnement se met à jour sans qu'il soit nécessaire de redémarrer la session complète.
### Changer de fond d'écran
Utilisez :
```
Super + Alt + W
```
Le projet prend en charge les fonds d'écran aléatoires, les répertoires personnalisés, les fonds d'écran fixes, les fonds d'écran animés et le comportement de diaporama.
### Modifier le thème actuel
Utilisez RiceEditor lorsque vous souhaitez ajuster les paramètres visuels sans modifier manuellement chaque module :
```
RiceEditor
```
Les modifications courantes incluent les bordures, les ombres, les animations, la transparence, le comportement du fond d'écran et les paramètres des modules spécifiques au thème.
## Dépannage
| Problème | Ce qu'il faut vérifier |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| La connexion revient au gestionnaire d'affichage | Vérifiez que la session BSPWM est installée et consultez `~/.xsession-errors`. |
| Les modules de la barre sont incorrects | Vérifiez `~/.config/bspwm/config/system.ini`. |
| L'applet réseau ne fonctionne pas | Vérifiez que NetworkManager est installé et en cours d'exécution. |
| L'affichage de la VM est corrompu | Essayez le backend Picom `xrender` à la place de `glx`. |
| Les raccourcis clavier échouent | Vérifiez `sxhkd` est en cours d'exécution et consultez `~/.config/bspwm/config/sxhkdrc`. |
| Le thème semble mal aligné | Le projet est conçu pour du 1600x900 et 96 DPI ; adaptez-le à votre écran. |
| Les configurations existantes ont disparu | Vérifiez le dossier de sauvegarde créé par l'installateur et votre propre `dotfiles-backup`. |
## Notes pour une réinstallation propre
Pour une nouvelle tentative en toute sécurité :
1. Sauvegardez vos fichiers actuels.
2. Supprimez ou déplacez les anciens répertoires de dotfiles.
3. Retéléchargez la dernière `RiceInstaller`.
4. Relisez le script.
5. Exécutez-le depuis `$HOME` en tant qu'utilisateur normal.
N'exécutez pas d'installateurs modifiés aléatoires provenant de forks tiers, sauf si vous avez examiné le diff.
## Références
* [Dépôt officiel gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles)
* [RiceInstaller](https://github.com/gh0stzk/dotfiles/blob/master/RiceInstaller)
* [Premières étapes après l'installation](https://github.com/gh0stzk/dotfiles/wiki/First-steps-after-installation)
* [Wiki des raccourcis clavier](https://github.com/gh0stzk/dotfiles/wiki/Keyboard-Shortcuts)
* [Fichier de raccourcis clavier sxhkdrc actuel](https://github.com/gh0stzk/dotfiles/blob/master/config/bspwm/config/sxhkdrc)
* [Wiki de configuration des fonds d'écran](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/fr/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.
