====== PipeWire Audio-Umschaltung unter GuideOS ======
<block round box 70%>
Die Skripte schalten den Standard-Audioausgang per Klick zwischen Kopfhörer, Lautsprecher/Boxen und/oder Bluetooth-Headset um – über pactl direkt auf PipeWire-Ebene.
</block>

===== Voraussetzungen =====
<block round box 70%>
GuideOS mit Cinnamon-Desktop läuft

PipeWire ist aktiv: ''pactl info | grep "Server Name"'' → zeigt "PulseAudio (on PipeWire)"

''pactl'' ist verfügbar (Paket ''libpulse0'' vorhanden)
</block>
===== Schritt 1: Sink-IDs und Ports ermitteln =====

<block round box 70%>
<code bash>
pactl list short sinks
pactl list sinks | grep -E "(Sink #|Ports:|Active Port)"
</code>
</block>

<block round box 70%>
Beispiel-Ausgabe:

^ Sink-ID ^ Name ^ Active Port ^ Verfügbare Ports ^
| 72 | alsa_output.pci-... (Boxen) | analog-output-lineout | analog-output-lineout, analog-output-headphones |
| 74 | alsa_output.usb-Logitech... (Kopfhörer) | analog-output | analog-output |
| 95 | bluez_output... (Bluetooth) | headset-output | headset-output |
</block>
===== Schritt 2: Verzeichnis anlegen =====
<block round box 70%>
<code bash>
mkdir -p ~/.local/bin
</code>
</block>

Sicherstellen, dass ''~/.local/bin'' im PATH liegt:
<block round box 70%>
<code bash>
echo $PATH | grep ".local/bin"
</code>
</block>

Falls nicht vorhanden, in ''~/.bashrc'' ergänzen:
<block round box 70%>
<code bash>
export PATH="$HOME/.local/bin:$PATH"
source ~/.bashrc
</code>
</block>
===== Schritt 3: Skripte erstellen =====

==== 3.1 Kopfhörer (01-Headphone.sh) ====
<block round box 70%>
<code bash>
nano ~/.local/bin/01-Headphone.sh
</code>

<code bash> #!/bin/sh
sink=74
port=analog-output

pactl set-sink-port "$sink" "$port"
pactl set-default-sink "$sink"
</code>
</block>
==== 3.2 Boxen (02-Box.sh) ====
<block round box 70%>
<code bash>
nano ~/.local/bin/02-Box.sh
</code>

<code bash> #!/bin/sh
sink=72
port=analog-output-lineout

pactl set-sink-port "$sink" "$port"
pactl set-default-sink "$sink"
</code>
</block>
==== 3.3 Bluetooth (03-Blue.sh) ====
<block round box 70%>
<code bash>
nano ~/.local/bin/03-Blue.sh
</code>

<code bash> #!/bin/sh
sink=$(pactl list short sinks | grep bluez | cut -f1)
[ -z "$sink" ] && { echo "Kein Bluetooth-Gerät gefunden"; exit 1; }

pactl set-sink-port "$sink" headset-output
pactl set-default-sink "$sink"
</code>
</block>
===== Schritt 4: Skripte ausführbar machen =====
<block round box 70%>
<code bash>
chmod +x ~/.local/bin/01-Headphone.sh
chmod +x ~/.local/bin/02-Box.sh
chmod +x ~/.local/bin/03-Blue.sh
</code>
</block>
===== Schritt 5: .desktop-Dateien erstellen =====
Für die Taskleisten-Integration braucht Cinnamon ''.desktop''-Dateien mit Icon und Befehl.

==== 5.1 Kopfhörer ====
<block round box 70%>
<code bash>
nano ~/.local/share/applications/audio-headphone.desktop
</code>

<code>[Desktop Entry] 
Name=Kopfhörer Comment=Audio auf Kopfhörer umschalten 
Exec=/home/BENUTZERNAME/.local/bin/01-Headphone.sh 
Icon=audio-headphones 
Terminal=false Type=Application Categories=AudioVideo; 
</code>
</block>
==== 5.2 Boxen ====
<block round box 70%>
<code bash>
nano ~/.local/share/applications/audio-box.desktop
</code>

<code>[Desktop Entry] 
Name=Boxen Comment=Audio auf Boxen umschalten 
Exec=/home/BENUTZERNAME/.local/bin/02-Box.sh 
Icon=audio-speakers 
Terminal=false 
Type=Application Categories=AudioVideo; 
</code>
</block>
==== 5.3 Bluetooth ====
<block round box 70%>
<code bash>
nano ~/.local/share/applications/audio-bluetooth.desktop
</code>

<code>[Desktop Entry] 
Name=Bluetooth Audio 
Comment=Audio auf Bluetooth umschalten 
Exec=/home/BENUTZERNAME/.local/bin/03-Blue.sh 
Icon=audio-headset 
Terminal=false 
Type=Application Categories=AudioVideo; 
</code>
</block>

<WRAP round tip 70%>
Hinweis: ''BENUTZERNAME'' durch deinen echten Linux-Benutzernamen ersetzen (''whoami'').
</WRAP>
===== Schritt 6: Icons in Taskleiste einbinden =====
<block round box 70%>
Rechtsklick auf die Taskleiste → "Applets"

Applet "Leistenstarter" suchen → mit "+" aktivieren

Rechtsklick auf den neuen Leistenstarter in der Taskleiste → "+ Hinzufügen"

Im Dialog:

Name: z.B. ''Kopfhörer''

Befehl: ''~/.local/bin/01-Headphone.sh''

Icon: Auf das Icon-Feld klicken → Suchbegriff ''audio-headphones'' eingeben

Schritte für Boxen (''audio-speakers'') und Bluetooth (''audio-headset'') wiederholen
</block>
===== Schritt 7: Testen =====
<block round box 70%>
Klick auf das Kopfhörer-Icon in der Taskleiste

Prüfen: ''pactl get-default-sink'' (sollte Sink 74 zeigen)

GUI-Kontrolle: ''pavucontrol'' → Tab "Ausgabegeräte"
</block>
===== Fehlerbehebung =====
<block round box 70%>
^ Problem ^ Lösung ^
| Skript startet nicht | ''chmod +x'' erneut ausführen |
| Icon fehlt in Taskleiste | ''.desktop''-Datei nach ''~/.local/share/applications/'' kopieren, Cinnamon neu starten: ''cinnamon --replace &'' |
| Sink-ID nicht gefunden | ''pactl list short sinks'' → IDs in Skripten anpassen |
| Bluetooth kein Ton | Erst ''bluetoothctl connect MAC'', dann Skript ausführen |
</block>