> 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 hacker Arch Linux avec BSPWM
[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'assistance pour changer rapidement de style.
Exemple d'environnement de bureau BSPWM issu du README du projet.
{% hint style="warning" %}
Installez cela 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 ; examinez donc l'installateur et sauvegardez votre configuration actuelle avant de l'exécuter.
{% endhint %}
## Où cela s'insère
Cela relève de `Ressources utiles` parce qu'il s'agit d'une ressource de configuration de poste de travail, et non 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 très orientés terminal.
## Ce que cela vous apporte
| Composant | Ce que cela signifie |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| BSPWM | Gestionnaire de fenêtres en mode tiling 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 rapide du shell avec complétions, recherche dans l'historique et aperçus fzf-tab. |
| Configuration Neovim | Configuration d'éditeur prête à l'emploi avec LSP, complétion, formatage, explorateur, barre d'état et tableau de bord. |
| RiceEditor | Application d'assistance pour ajuster les paramètres visuels sans modifier manuellement chaque configuration. |
## Aperçu visuel
Le projet est très visuel, alors regardez les captures d'écran et la démo avant d'installer.
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 d'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émos BSPWM, Polybar, Eww, Rofi et de thèmes.
{% embed url="" %}
## Avant l'installation
L'installateur officiel est prévu pour Arch Linux et les distributions basées sur Arch. Le README indique que les distributions non 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
```
## Installation rapide d'Arch
Utilisez ceci lorsque vous partez d'une machine ou d'une VM Arch propre et que vous voulez le chemin le plus court possible.
### 1. Démarrer l'ISO Arch
Démarrez depuis l'ISO officiel d'Arch. Si vous utilisez le Wi-Fi, connectez-vous d'abord :
```bash
iwctl
```
Dans `iwctl`:
```
liste des périphériques
station wlan0 scan
station wlan0 get-networks
station wlan0 connect "SSID"
exit
```
Vérifier la connexion Internet :
```bash
ping -c 3 archlinux.org
```
Synchroniser l'heure :
```bash
timedatectl set-ntp true
```
### 2. Installer Arch rapidement
La voie rapide consiste à utiliser `archinstall`:
```bash
archinstall
```
Choix recommandés :
| Option | Choisir |
| ----------------------- | ---------------------------------------------------------------------------- |
| Disposition du disque | Par défaut ou manuel, selon votre VM/disque. |
| Chargeur d'amorçage | `systemd-boot` pour UEFI, GRUB si vous le préférez. |
| Profil | Minimal suffit ; l'environnement de 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. Activer les éléments de base
Connectez-vous en tant qu'utilisateur normal, puis vérifiez 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 dossier 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
```
Donnez-lui la permission d'exécution :
```bash
chmod +x RiceInstaller
```
Exécutez-le en tant qu'utilisateur normal :
```bash
./RiceInstaller
```
L'installateur est interactif. Il peut vous demander si vous voulez les configurations Neovim et Firefox incluses. Lisez chaque invite au lieu d'appuyer sur Entrée partout.
### Installation en un bloc
Pour une installation rapide en labo après avoir déjà un Arch fonctionnel :
```bash
cd "$HOME"
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
less RiceInstaller
chmod +x RiceInstaller
./RiceInstaller
```
## Ce que fait l'installateur
À un niveau général, 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 si nécessaire.
7. Installe l'environnement BSPWM.
8. Active MPD pour les fonctions 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. Gardez tout de même votre propre sauvegarde d'abord.
## 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 la fin de l'autoconfiguration au premier lancement.
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 de :
| 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é de l'ordinateur portable. |
Si vous êtes sur un PC de bureau, l'interface réseau est généralement la principale à surveiller.
## Commandes utiles
| Commande | Utilisez |
| ----------------------------------- | -------------------------------------------------------------- |
| `RiceSelector` | Ouvrir le sélecteur de thème. |
| `RiceEditor` | Modifier visuellement le thème actuel. |
| `WallSelect` | Ouvrir le sélecteur de fond d'écran. |
| `Term --selecterm` | Choisir l'application de terminal. |
| `OpenApps --menu` | Ouvrir le lanceur d'applications. |
| `OpenApps --KeyHelp` | Ouvrir la fiche mémo des raccourcis clavier. |
| `OpenApps --screenshot` | Ouvrir l'outil de capture d'écran. |
| `OpenApps --netmanager` | Ouvrir l'applet de gestion réseau. |
| `OpenApps --bluetooth` | Ouvrir l'applet Bluetooth. |
| `OpenApps --clipboard` | Ouvrir le gestionnaire du presse-papiers. |
| `OpenApps --powermenu` | Ouvrir le menu d'alimentation. |
| `OpenApps --keyboard` | Ouvrir l'applet de disposition du clavier. |
| `OpenApps --scratch` | Ouvrir le scratchpad. |
| `HideBar -h` | Masquer les barres. |
| `HideBar -u` | Afficher les barres. |
| `SoftReload` | Recharger l'environnement en douceur. |
| `ScreenLocker` | Verrouiller l'écran. |
| `bspc wm -r` | Recharger BSPWM. |
| `pkill -USR1 -x sxhkd` | Recharger les raccourcis clavier. |
| `~/.config/bspwm/config/system.ini` | Variables matérielles/modules à vérifier après l'installation. |
| `~/.config/bspwm/config/sxhkdrc` | Fichier principal des raccourcis clavier. |
## Raccourcis clavier complets
Le projet affiche la fiche mémo visuelle avec `Alt + F1`. `Super` désigne la touche Windows sur la plupart des claviers. La source de référence est le fichier installé `~/.config/bspwm/config/sxhkdrc`; ce tableau suit le fichier amont actuel et regroupe tous les raccourcis pour en faciliter la lecture.
### Aide
| Touches | Action |
| ---------- | ---------------------------------------------- |
| `Alt + F1` | Afficher la fiche mémo des raccourcis clavier. |
### Applications principales
| Touches | Action |
| ---------------------- | ------------------------------------- |
| `Super + Return` | Ouvrir un terminal normal. |
| `Super + Alt + Return` | Ouvrir un terminal flottant. |
| `Super + Space` | Ouvrir 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 du 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` | Terminer l'application avec `xkill`. |
| `Ctrl + Super + Alt + S` | Rechargement à chaud. |
| `Super + Alt + H` | Masquer la barre. |
| `Super + Alt + U` | Afficher la barre. |
| `Ctrl + Alt + Plus` | Augmenter la transparence de la fenêtre focalisée. |
| `Ctrl + Alt + Moins` | Réduire la transparence de la fenêtre focalisée. |
| `Ctrl + Alt + T` | Réinitialiser la transparence de la fenêtre focalisée. |
| `XF86MonBrightnessUp` | Augmenter la luminosité. |
| `XF86MonBrightnessDown` | Réduire la luminosité. |
| `XF86AudioRaiseVolume` | Augmenter le volume. |
| `XF86AudioLowerVolume` | Réduire le volume. |
| `XF86AudioMute` | Basculer le son muet. |
| `XF86AudioNext` | Piste multimédia suivante. |
| `XF86AudioPrev` | Piste multimédia précédente. |
| `XF86AudioPlay` | Lire/mettre en pause le média. |
| `XF86AudioStop` | Arrêter le média. |
### Noyau BSPWM
| Touches | Action |
| ----------------- | ---------------------------------------- |
| `Super + Alt + R` | Recharger BSPWM. |
| `Super + X` | Fermer le nœud focalisé. |
| `Super + Maj + X` | Tuer le nœud focalisé. |
| `Super + Échap` | Recharger les liaisons de touches sxhkd. |
### États et indicateurs des nœuds
| Touches | Action |
| ---------------- | ------------------------------------------------------ |
| `Alt + T` | Définir le nœud en mosaïque. |
| `Alt + Maj + T` | Définir le nœud en pseudo-mosaïque. |
| `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 épinglé. |
| `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 tourner 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 l’espace 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 l’espace 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 la suivre. |
| `Super + Ctrl + Droite` | Envoyer la fenêtre focalisée vers l’espace de travail suivant et la suivre. |
| `Alt + Tab` | Sélecteur de fenêtres. |
| `Super + Alt + Gauche` | Focaliser la fenêtre à l’ouest, sinon la précédente. |
| `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, sinon la suivante. |
| `Ctrl + Alt + Gauche` | Déplacer la fenêtre focalisée vers l’ouest. |
| `Ctrl + Alt + Bas` | Déplacer la fenêtre focalisée vers le sud. |
| `Ctrl + Alt + Haut` | Déplacer la fenêtre focalisée vers le nord. |
| `Ctrl + Alt + Droite` | Déplacer 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 division horizontale/est. |
| `Super + Ctrl + V` | Pré-sélectionner une division verticale/sud. |
| `Super + Ctrl + Q` | Annuler la pré-sélection. |
### Déplacer et redimensionner
| Touches | Action |
| ---------------------- | --------------------------------------------- |
| `Super + Ctrl + B` | Équilibrer les nœuds du bureau. |
| `Super + Alt + Plus` | Augmenter la taille du nœud en mosaïque. |
| `Super + Alt + Moins` | Réduire la taille du nœud en mosaïque. |
| `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 le 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 le 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 voulez ajuster les paramètres visuels sans modifier manuellement chaque module :
```
RiceEditor
```
Les modifications typiques 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 | À vérifier |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------- |
| La connexion revient au gestionnaire d’affichage | Confirmez 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 | Confirmez que NetworkManager est installé et en cours d’exécution. |
| L’affichage graphique de la VM semble cassé | Essayez le backend Picom `xrender` à la place de `glx`. |
| Les raccourcis clavier ne fonctionnent pas | 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 1600x900 et 96 DPI ; adaptez-le à votre moniteur. |
| Les configurations existantes ont disparu | Vérifiez le dossier de sauvegarde créé par l’installateur et vos propres `dotfiles-backup`. |
## Notes pour une réinstallation propre
Pour la tentative la plus sûre :
1. Sauvegardez vos fichiers actuels.
2. Supprimez ou déplacez les anciens répertoires de dotfiles.
3. Retéléchargez la dernière version de `RiceInstaller`.
4. Relisez le script une fois de plus.
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, à moins d’avoir examiné le diff.
## Références
* [Dépôt officiel de 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 liaisons de touches 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 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/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 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.
