From 59e993d42241d05eb3b8e2d95973148c38129cfe Mon Sep 17 00:00:00 2001
From: imonlinux <39863321+imonlinux@users.noreply.github.com>
Date: Fri, 26 Sep 2025 22:05:10 -0700
Subject: [PATCH] Create install_pipewire

---
 docs/install_pipewire | 85 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 docs/install_pipewire

diff --git a/docs/install_pipewire b/docs/install_pipewire
new file mode 100644
index 0000000..4af84d6
--- /dev/null
+++ b/docs/install_pipewire
@@ -0,0 +1,85 @@
+> 
+> Install Pipewire On Your Linux Voice Satellite
+> 
+
+
+## 1. Connect to your Pi over SSH using the username/password you configured during flashing:
+
+```sh
+ssh <your_username>@<pi_IP_address>
+```
+
+
+## 2. If already installed Disable/Stop the entire the Linux Voice Assistant service. If not installed, proceed to step (3.):
+
+```sh
+sudo systemctl disable --now linux-voice-assistant.service
+sudo rm /etc/systemd/system/linux-voice-assistant.service
+```
+
+
+## 3. Install Pipewire packages and necessary PulseAudio utilities:
+
+```sh
+sudo apt-get update
+sudo apt-get install \
+    pipewire \
+    pulseaudio-utils 
+```
+
+
+## 4. Reboot your Pi:
+
+```sh
+sudo reboot -h now
+```
+
+
+## 5. SSH back in to your Pi.  (See step 1.)
+
+
+## 6. Ensure Pipewire is runnining in user mode. 
+
+```sh
+systemctl --user status pipewire.service
+systemctl --user status pipewire-pulse.service
+
+```
+
+
+## 7. (OPTIONAL) If plugging speakers into the headphone jack of the ReSpeaker, set the correct PulseAudio Sink Port:
+
+Run `pactl list sinks` and scroll to the bottom and notice your Active Port is probably "analog-output-speaker".  Run the command below to output audio through the 3.5mm headphone jack.
+
+```sh
+pactl set-sink-port alsa_output.platform-soc_sound.stereo-fallback "analog-output-headphones"
+```
+
+**Please note that if you are setting this up on a Raspberry Pi 3B or 4B, you need an additional step at this point to make it route the audio through the 2mic hat (and likely the 4mic one as well). Run the following command to do this.**
+
+```sh
+pactl set-default-sink alsa_output.platform-soc_sound.stereo-fallback
+```
+
+
+## 8. Test and make sure you can hear the wav file.:
+
+```sh
+mpv --ao=pipewire --audio-device=default --audio-samplerate=44100 /usr/share/sounds/alsa/Front_Center.wav
+```
+
+**Note that if you have a Raspbery Pi 3B or 4B, this may or may not seem to work, but it will output on the hat as intended.**
+
+
+## 9. Reboot your Pi: (see step 4)
+
+
+## 10. Done! Return to the tutorial to continue the Linux Voice Assistant install.
+
+
+
+
+
+
+
+