From: Matt Blaha <github@mattblaha.com>
Date: Mon, 2 Dec 2019 17:43:28 +0000 (-0600)
Subject: Includ note about audio_backend_buffer_desired_length in TROUBLESHOOTING.md
X-Git-Tag: 3.3.6~8^2
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F938%2Fhead;p=thirdparty%2Fshairport-sync.git

Includ note about audio_backend_buffer_desired_length in TROUBLESHOOTING.md
---

diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md
index 8a4e14e5..fd500e60 100644
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -231,3 +231,20 @@ This will then be used by default by Shairport-Sync and any other applications u
 Note that some distributions (such as Volumio 2) don't use an asound.conf file by default, they instead specify the hardware details directly in '/etc/mpd.conf' files so some more in-depth modification is needed to override this.
 
 (Note: not tested by Mike B.)
+
+### Buffer underflow to audio backend
+
+**Problem **
+
+Audio may seem to pause or drop for several seconds. iOS devices may regularly disconnect altogether and display an error message. This may be caused by a combination of factors listed above such as slow WiFi or limited resources on the device running Shairport Sync.
+
+**Possible Solution **
+
+If none of the above steps completely remove the issue, try increasing the audio backend buffer setting in the backend section of shairport-sync.conf. (This section may vary depending on the value of the "output_backend" setting.)
+
+For example:
+
+````
+audio_backend_buffer_desired_length = 19845;
+````
+Is triple the default for the ALSA backend and effectively solves the above issue with a Pi Zero on a busy network.