ArchASP Dotfiles

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 : 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

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 et docs/shell.md.

✦ Preview

_{Capture historique avant la migration SwayFX et QuickShell.}

✦ Repository

ArchASP
├── arch-system       système/root · /etc · services système · installation
└── Dotfiles_ArchAP   utilisateur · $HOME · Stow · systemd --user

Les 31 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.

✦ Quick Start

Le chemin heureux utilise Bash pour le tableau des packages :

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 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.

✦ Documentation

Guide	Sujet
Documentation	Index et responsabilités des documents
Architecture	Frontières ArchASP, Stow et données locales
Installation	Clone neuf, sous-modules, Stow et validations
Desktop	Chaîne greetd/UWSM/Sway et composants Wayland
Shell	Zsh, outils interactifs, plugins et scripts
systemd	Services système et unités utilisateur
Packages	Inventaires Pacman, AUR, services et outils externes
Recovery	Reconstruction complète après perte du disque
Security	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.

✦ Mirrors

Rôle	Dépôt
Upstream principal	Forgejo
Miroir public	GitHub

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.