Files
my_sway_konfig/README.md
2025-12-17 18:10:08 +01:00

143 lines
4.9 KiB
Markdown

# Sway Desktop Wiederherstellung via Ansible
Dieses Repository enthält die Konfigurationen und das Ansible-Playbook, um ein vollständiges und personalisiertes Sway-Desktop-Setup automatisiert bereitzustellen.
Das Playbook konfiguriert unter anderem:
* **Desktop-Umgebung:** Sway, Waybar, Wofi, Alacritty, Mako
* **Hintergrund:** Statisches Hintergrundbild
* **Skripte:** Automatisches Verbinden von Bluetooth-Geräten, Update-Anzeige für Waybar
* **Systemdienste:** MPD (Music Player Daemon), rclone-Synchronisierung
---
## 1. Voraussetzungen
Bevor Sie das Playbook ausführen können, müssen die folgenden Werkzeuge auf dem Zielsystem (Arch Linux) installiert sein:
1. **Ansible:**
```bash
sudo pacman -S ansible
```
2. **git** und **base-devel** (um AUR-Pakete bauen zu können):
```bash
sudo pacman -S --needed git base-devel
```
3. **Ein AUR-Helper (empfohlen: `yay`):** Das Playbook verwendet `yay`, um Pakete aus dem Arch User Repository (AUR) zu installieren. Bitte installieren Sie es manuell, bevor Sie das Playbook starten.
```bash
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
cd ..
rm -rf yay
```
---
## 2. Konfiguration mit Ansible bereitstellen (Empfohlene Methode)
Der empfohlene Weg, dieses Setup zu installieren, ist die Verwendung des mitgelieferten Ansible-Playbooks.
### Playbook ausführen
1. **Navigieren Sie in das Verzeichnis:**
```bash
cd ~/my_sway_konfig
```
2. **Führen Sie das Playbook aus:**
Dieser Befehl startet den automatisierten Prozess. Er wird Sie nach Ihrem `sudo`-Passwort fragen, um Pakete zu installieren und Systemkonfigurationen vorzunehmen.
```bash
ansible-playbook sway_config_deploy.yml --ask-become-pass
```
3. **(Optional) Zielbenutzer ändern:**
Standardmäßig ist das Playbook für den Benutzer `jonnybravo` konfiguriert. Um es für einen anderen Benutzer auszuführen, verwenden Sie die `--extra-vars`-Option:
```bash
ansible-playbook sway_config_deploy.yml --ask-become-pass --extra-vars "target_user=anderer_benutzer"
```
### Playbook testen (ohne Änderungen)
Bevor Sie das Playbook ausführen, können Sie mit `--check` und `--diff` eine Simulation durchführen. Dies ist sehr nützlich, um zu sehen, was sich ändern würde, ohne das System zu verändern.
```bash
# Simuliert die Ausführung und zeigt alle geplanten Änderungen an
ansible-playbook sway_config_deploy.yml --ask-become-pass --check --diff
```
---
## 3. Referenz: Installierte Pakete
Das Playbook installiert die folgenden Pakete. Diese Liste dient als Referenz.
### Offizielle Repositories (via pacman)
- sway
- waybar
- wofi
- alacritty
- swaylock
- swayidle
- mako
- kanshi
- wl-clipboard
- brightnessctl
- grim
- slurp
- playerctl
- qalculate-gtk
- tmux
- rclone
- pacman-contrib
- udisks2
- udiskie
- mpd
- ncmpcpp
- ttf-dejavu
- otf-font-awesome
- papirus-icon-theme
- nwg-look
### Arch User Repository (AUR) (via yay)
- tty-clock
- catppuccin-gtk-theme-mocha
---
## 4. MPD & ncmpcpp Cheatsheet
Hier sind einige nützliche Befehle zur Steuerung des Music Player Daemon (MPD) und des Clients `ncmpcpp`.
**Wichtiger Hinweis:** Dein MPD-Server läuft auf Port `6601`. Fast alle Befehle benötigen daher die Angabe `-p 6601`.
### MPD (Der Server)
| Befehl | Beschreibung |
| ------------------------------------ | ------------------------------------------ |
| `systemctl --user status mpd` | Zeigt den Status des MPD-Dienstes an. |
| `systemctl --user restart mpd` | Startet den MPD-Dienst neu. |
| `mpc -p 6601 update` | Scannt dein Musikverzeichnis nach neuen Liedern. |
### mpc (Einfacher Kommandozeilen-Client)
| Befehl | Beschreibung |
| ------------------------------------ | ------------------------------------------ |
| `mpc -p 6601 toggle` | Spielt ab oder pausiert. |
| `mpc -p 6601 next` | Nächstes Lied. |
| `mpc -p 6601 prev` | Vorheriges Lied. |
| `mpc -p 6601 current` | Zeigt den aktuell spielenden Titel an. |
### ncmpcpp (Visueller Client im Terminal)
**Starten:** `ncmpcpp -p 6601`
| Taste(n) | Aktion |
| ---------------- | ------------------------------------------ |
| `1` | Aktuelle Wiedergabeliste |
| `2` | Musik-Browser (Dateisystem) |
| `q` | Beenden |
| `Leertaste` | Wiedergabe umschalten (Play/Pause) |
| `>` | Nächstes Lied |
| `<` | Vorheriges Lied |
| `u` | Musik-Datenbank aktualisieren |