Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- audio_ausgänge_umschalten [2026/02/23 18:44] – [Schritt 2: Verzeichnis anlegen] ktt73
+++ audio_ausgänge_umschalten [2026/03/14 15:52] (aktuell) – ktt73
@@ Zeile 1: / Zeile 1: @@
-====== PipeWire Audio-Umschaltung unter GuideOS ======
+====== sound@cinnamon.org – GuideOS Fork ======
-Die Skripte schalten den Standard-Audioausgang per Klick zwischen Kopfhörer, Lautsprecher/Boxen und/oder Bluetooth-Headset um – über pactl direkt auf PipeWire-Ebene.
+GuideOS-Fork – Angepasst für [[https://github.com/GuideOS|GuideOS](https://github.com/GuideOS|GuideOS)], eine auf Debian basierende Distribution.
-===== Voraussetzungen =====
+Dieses Repository enthält eine modifizierte Version des Cinnamon-System-Applets ''sound@cinnamon.org'', in die die Funktionalität des Audio-Ausgang-Umschalters direkt integriert wurde.
-GuideOS mit Cinnamon-Desktop läuft
+Das bekannte Sound-Applet erhält dadurch ohne separate Installation einen zusätzlichen Untermenüpunkt „Audio Output" zum Umschalten zwischen allen verfügbaren Ausgabegeräten – aktive Audio-Streams werden dabei automatisch mitbewegt.
-PipeWire ist aktiv: ''pactl info | grep "Server Name"'' → zeigt "PulseAudio (on PipeWire)"
+===== Features =====
-''pactl'' ist verfügbar (Paket ''libpulse0'' vorhanden)
+  * Untermenü „Audio Output" direkt im vorhandenen Lautstärke-Applet
+  * Unterstützte Gerätetypen: Bluetooth, HDMI/DisplayPort, S/PDIF, USB-Audio, Line-out, Kopfhörer, Lautsprecher
+  * Kompatibel mit PipeWire (''pipewire-pulse'') und PulseAudio
+  * Verschiebt alle laufenden Audio-Streams automatisch beim Umschalten
+  * Untermenü-Label zeigt immer den aktuell aktiven Ausgang an
+  * Aktualisiert die Geräteliste alle 4 Sekunden (erkennt z. B. neu verbundene Bluetooth-Geräte)
+  * Filtert Monitor-Sinks automatisch aus
-===== Schritt 1: Sink-IDs und Ports ermitteln =====
+===== Voraussetzungen =====
-<block round box 70%>
+  * Cinnamon Desktop-Umgebung
-<code bash>
+  * PulseAudio oder PipeWire mit ''pactl''
-pactl list short sinks
-pactl list sinks | grep -E "(Sink #|Ports:|Active Port)"
-</code>
-</block>
-Beispiel-Ausgabe:
+===== Installation =====
-^ Sink-ID ^ Name ^ Active Port ^ Verfügbare Ports ^
+**1. Repository klonen:**
-| 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 |
-===== Schritt 2: Verzeichnis anlegen =====
-<block>
 <code bash>
-mkdir -p ~/.local/bin
+git clone https://github.com/GuideOS/audio-output-switcher.git
+cd audio-output-switcher
 </code>
-</block>
-Sicherstellen, dass ''~/.local/bin'' im PATH liegt:
+Der ''main''-Branch enthält immer den aktuellen stabilen Stand.
-<block>
-<code bash>
-echo $PATH | grep ".local/bin"
-</code>
-</block>
-Falls nicht vorhanden, in ''~/.bashrc'' ergänzen:
+**2. Das modifizierte Applet in den Cinnamon-Applet-Pfad kopieren:**
-<block>
-<code bash>
-export PATH="$HOME/.local/bin:$PATH"
-source ~/.bashrc
-</code>
-</block>
-===== Schritt 3: Skripte erstellen =====
-==== 3.1 Kopfhörer (01-Headphone.sh) ====
 <code bash>
-nano ~/.local/bin/01-Headphone.sh
+mkdir -p ~/.local/share/cinnamon/applets/
+cp -r .local/share/cinnamon/applets/sound@cinnamon.org \
+      ~/.local/share/cinnamon/applets/
 </code>
-<code bash> #!/bin/sh
+<WRAP round important>
-sink=74
+**Achtung:** Das Original-Applet liegt unter ''/usr/share/cinnamon/applets/sound@cinnamon.org'' und wird durch diesen Fork im benutzerspezifischen Pfad ''~/.local/'' überlagert (nicht überschrieben). Cinnamon bevorzugt automatisch die Version in ''~/.local/''.
-port=analog-output
-pactl set-sink-port "$sink" "$port"
+Um den Fork rückgängig zu machen, genügt es, das Verzeichnis wieder zu löschen:
-pactl set-default-sink "$sink"
-</code>
-==== 3.2 Boxen (02-Box.sh) ====
 <code bash>
-nano ~/.local/bin/02-Box.sh
+rm -rf ~/.local/share/cinnamon/applets/sound@cinnamon.org
 </code>
+</WRAP>
-<code bash> #!/bin/sh
+**3. Cinnamon neu starten** (''Alt+F2'' → ''r'' → ''Enter'') oder abmelden und neu anmelden.
-sink=72
-port=analog-output-lineout
-pactl set-sink-port "$sink" "$port"
+===== Verwendung =====
-pactl set-default-sink "$sink"
-</code>
-==== 3.3 Bluetooth (03-Blue.sh) ====
+Klick auf das Sound-Icon in der Taskleiste öffnet das Lautstärke-Menü. Dort befindet sich der Eintrag „Audio Output" mit allen verfügbaren Ausgängen. Der aktive Ausgang ist mit ''✓'' markiert. Ein Klick wechselt sofort und verschiebt alle laufenden Streams.
-<code bash>
-nano ~/.local/bin/03-Blue.sh
-</code>
-<code bash> #!/bin/sh
+===== Projektstruktur =====
-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
+<code>
-pactl set-default-sink "$sink"
+audio-output-switcher/
+└── .local/share/cinnamon/applets/
+    └── sound@cinnamon.org/
+        ├── applet.js          # Sound-Applet mit integriertem Audio-Ausgang-Umschalter
+        ├── metadata.json
+        └── settings-schema.json
 </code>
-===== Schritt 4: Skripte ausführbar machen =====
+===== Lizenz =====
-<code bash>
-chmod +x ~/.local/bin/01-Headphone.sh
-chmod +x ~/.local/bin/02-Box.sh
-chmod +x ~/.local/bin/03-Blue.sh
-</code>
-===== Schritt 5: .desktop-Dateien erstellen =====
-Für die Taskleisten-Integration braucht Cinnamon ''.desktop''-Dateien mit Icon und Befehl.
-==== 5.1 Kopfhörer ====
-<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>
-==== 5.2 Boxen ====
-<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>
-==== 5.3 Bluetooth ====
-<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>
-Hinweis: ''BENUTZERNAME'' durch deinen echten Linux-Benutzernamen ersetzen (''whoami'').
-===== Schritt 6: Icons in Taskleiste einbinden =====
-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
-===== Schritt 7: Testen =====
-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"
-===== Fehlerbehebung =====
+MIT License – © 2026 GuideOS. Siehe [[https://github.com/GuideOS/audio-output-switcher/blob/main/LICENSE|LICENSE](https://github.com/GuideOS/audio-output-switcher/blob/main/LICENSE|LICENSE)].
-^ 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 |