SoundWire Server with GUI Install Instructions for Raspberry Pi OS / Raspbian
-----------------------------------------------------------------------------

System Setup:

- SoundWire Server version 3.0 and later uses Qt5 for its GUI. The 32-bit
  version was built for Raspberry Pis running Raspbian Stretch or later, 
  but may work on earlier Raspbian versions. The 64-bit version was built
  for Raspberry Pis running Raspberry Pi OS Bullseye or later.
  If you always run without a GUI (command line only, no desktop manager) 
  on a 32-bit OS or have an older RPi (ver 1 or 2) then SoundWire Server
  version 2.1.2 (non-GUI) is recommended, works on all Raspberry Pi models
  with 32-bit OS.

- SoundWire Server uses Pulse Audio. Install Pulse Audio Volume Control 
  (pavucontrol) using your package manager.
     sudo apt-get install pulseaudio
     sudo apt-get install pavucontrol

- You may need to install some Qt5 libraries, in particular the Qt5Widgets
  library and its dependencies. 
     sudo apt-get install libqt5widgets5

- If you're running a firewall, open firewall ports 59010 & 59011 UDP. You may
  do this from the GUI using firewall-config or a similar utility.

- Install the portaudio package using your package manager, or from
  http://www.portaudio.com/download.html
     sudo apt-get install libportaudio2

- Install libcurl package. If there is more than one option choose the OpenSSL
  flavor of libcurl. SoundWire Server will start without libcurl but will not
  be able to check for updates.
     sudo apt-get install libcurl4       (if not present use libcurl3)

- On Raspberry Pi OS Bookworm and later, check your audio configuration:
  Do 'sudo raspi-config', go to Advanced Options > Audio Config. If Pipewire
  is selected change it to PulseAudio. SoundWire Server may work with Pipewire
  because it's partly compatible with Pulse but we have seen some problems.
  If you'd like to use Pipewire and audio is noisy try changing the SoundWire
  Server sample rate as described in README.txt. If there are still problems
  switch to PulseAudio using raspi-config and undo any sample rate changes.

- Install any other packages needed to satisfy shared library dependencies if 
  SoundWireServer fails to start. You should run it from the command line to
  see any error messages. If you are unable to get the latest SoundWire Server
  version running you can try the older non-GUI SoundWire Server version 2.1.2
  if you are using a 32-bit OS. Note that PortAudio usually displays a large
  number of errors, so these are suppressed unless you use the -verbose option
  when running SoundWireServer.

SoundWire Server Program Installation:

1. Add the directory containing these files to your search path. (You can skip
   this step if you run SoundWireServer from the command line using the full
   path.)

2. At this point you can start SoundWire Server from the command line by typing
   SoundWireServer. To run without the GUI use the -nogui option. To start it
   from the desktop do the steps below.

3. Copy the icon file sw-icon.xpm to directory ~/.local/share/icons or some 
   other standard location for icons.

4. Copy the launcher file SoundWire-Server.desktop to /usr/share/applications
   to appear in the apps menu and associate the app icon. You can also put the
   .desktop file on your desktop, if supported.

You may need to modify these instructions depending on your Raspberry Pi's 
operating system version and configuration.

(Continue with the README.txt file.)
