Environnement utilisateur Arch Linux reproductible, composé avec GNU Stow.
Overview · Stack · Preview · Quick Start · Documentation · Version
## ✦ Overview `Dotfiles_ArchAP` décrit la couche **utilisateur** d'ArchASP : session Wayland, shell, applications terminal, scripts personnels et unités systemd user. Chaque package reproduit son chemin sous `$HOME` et GNU Stow déploie les liens symboliques correspondants. L'administration système reste séparée dans [`arch-system`](https://git.labfytools.com/fy59/arch-system) : installation Arch, boot, stockage, réseau, paquets, `/etc` et helpers root. Les inventaires de ce dépôt documentent la machine réelle, mais ne constituent pas un installateur automatique. ## ✦ Stack | Desktop | Shell | | --- | --- | | `greetd → tuigreet → UWSM → SwayFX` | `Zsh → Starship → Atuin` | | `QuickShell → barre et notifications` | `FZF → Zoxide → Eza → Bat → Yazi` | | Wofi · Swaylock · Cliphist · Kitty | plugins Zsh et Tmux épinglés par sous-modules | ```mermaid flowchart LR G[greetd] --> T[tuigreet] --> U[UWSM] --> S[SwayFX] S --> B[QuickShell : barre et notifications] S --> W[Wofi] S --> L[Swaylock] S --> C[Cliphist] S --> K[Kitty] ``` Les responsabilités et dépendances sont détaillées dans [`docs/desktop.md`](docs/desktop.md) et [`docs/shell.md`](docs/shell.md). ## ✦ Preview Captures actuelles de QuickShell et SwayFX avec **Kitty** et un **Firefox de test sur ArchWiki**, sur le workspace 5. La vue d'ensemble a été prise dans une session de démonstration isolée, également sur le workspace 5, pour ne pas montrer les aperçus des autres workspaces personnels.
Vue d'ensemble : prévisualisation des fenêtres, navigation et déplacement entre workspaces.
Menu Applications : recherche, catégories et favoris.
Control Center : Maintenir éveillé, avec une demande manuelle distincte de l'inhibition automatique des applications.
Apparence : fond d'écran, thème, lumière nocturne et localisation.
Menu de fenêtre : accès aux fenêtres ouvertes et aux actions de l'application.
## ✦ Repository ```text ArchASP ├── arch-system système/root · /etc · services système · installation └── Dotfiles_ArchAP utilisateur · $HOME · Stow · systemd --user ``` Les 32 packages Stow couvrent le desktop, le shell, le développement, les services utilisateur et l'apparence. `.assets/` contient les inventaires de reconstruction ; `docs/` contient la documentation et n'est jamais un package Stow. Voir le [contrat d'architecture](docs/architecture.md). ## ✦ Quick Start Le chemin heureux utilise Bash pour le tableau des packages : ```bash git clone --recurse-submodules \ ssh://git@git.labfytools.com:2223/fy59/Dotfiles_ArchAP.git \ "$HOME/.dotfiles" cd "$HOME/.dotfiles" packages=(atuin bat bin btop cliphist eza fastfetch fzf gtk-3.0 gtklock \ hyprwhspr icons kitty mako nvim opencode portal qt5ct qt6ct \ quickshell starship sway swaylock systemd themes tmux uwsm wallpapers wofi yazi \ ytmusic-tui zsh) stow --no --verbose=2 --target="$HOME" "${packages[@]}" stow --verbose=2 --target="$HOME" "${packages[@]}" ``` Le dry-run doit être examiné avant le déploiement. Les prérequis, conflits, inventaires et validations sont décrits dans le [guide d'installation](docs/installation.md). ## ✦ Documentation | Guide | Sujet | | --- | --- | | [Documentation](docs/README.md) | Index et responsabilités des documents | | [Architecture](docs/architecture.md) | Frontières ArchASP, Stow et données locales | | [Installation](docs/installation.md) | Clone neuf, sous-modules, Stow et validations | | [Desktop](docs/desktop.md) | Chaîne greetd/UWSM/Sway et composants Wayland | | [Sélecteur de fichiers](portal/README.md) | Portail FileChooser, Yazi, Kitty et raccourcis | | [Shell](docs/shell.md) | Zsh, outils interactifs, plugins et scripts | | [systemd](docs/systemd.md) | Services système et unités utilisateur | | [Packages](docs/packages.md) | Inventaires Pacman, AUR, services et outils externes | | [Recovery](docs/recovery.md) | Reconstruction complète après perte du disque | | [Security](docs/security.md) | Secrets exclus et règles de publication | ## Session Restore V2 QuickShell crée un checkpoint avant logout, reboot ou poweroff. Au login suivant, un chooser unique restaure la session en un clic, sans autre interaction. Firefox s’appuie sur son companion signé et un native host de corrélation ; Limusic reste géré par l’autostart Sway. La fenêtre terminal est restaurée, mais pas son contenu ni ses processus. Ratios exacts, fullscreen et scratchpad ne sont pas pris en charge ; le multi-output physique n’est pas validé et le provider Firefox actuel reste limité au profil supporté. Voir [installation, fonctionnement et tests V2](docs/session-restore-v2.md). ## ✦ Mirrors | Rôle | Dépôt | | --- | --- | | Upstream principal | [Forgejo](https://git.labfytools.com/fy59/Dotfiles_ArchAP) | | Miroir public | [GitHub](https://github.com/labfytools/Dotfiles_ArchAP) | Le fetch d'`origin` reste attaché à Forgejo. Ses deux URLs de push publient vers Forgejo et GitHub. ## ✦ Version | Branche | Rôle | | --- | --- | | `0.1.0` | Snapshot stable de la première version nettoyée et documentée | | `main` | Développement courant | La branche stable est immobile : les développements suivants avancent sur `main` sans déplacer automatiquement `0.1.0`. ## ✦ License Aucune licence n'est actuellement déclarée pour ce dépôt. En l'absence de licence, aucun droit de réutilisation n'est accordé implicitement.