]> git.ipfire.org Git - thirdparty/shairport-sync.git/commitdiff
Take more uptodate version of documents
authorMike Brady <4265913+mikebrady@users.noreply.github.com>
Thu, 29 Sep 2022 11:53:32 +0000 (12:53 +0100)
committerMike Brady <4265913+mikebrady@users.noreply.github.com>
Thu, 29 Sep 2022 11:53:32 +0000 (12:53 +0100)
RELEASENOTES.md
TROUBLESHOOTING.md

index bfb2c8fa3af7cd2ed534d75ec180f0a8f317644a..9fdc062871788fb9f0f48a63b3f6891f284a5bf8 100644 (file)
@@ -1,4 +1,29 @@
-Please see the [Release Notes for 3.3](https://github.com/mikebrady/shairport-sync/releases/tag/3.3).
+Version 4.1-rc0 Release Candidate
+====
+
+Really Big Update -- AirPlay 2!
+----
+Version 4.1 brings support for AirPlay 2 operation. It works with iOS, iPadOS, macOS, HomePod mini and Apple TV sources, but not with Windows.
+Limited support is available for HomeKit -- Shairport Sync speakers can be added to the Home app, though not all features are working.
+AirPlay 2 operation requires a companion program called NQPTP and requires a somewhat more powerful system. Please see [AIRPLAY2.md](./AIRPLAY.md) for more.
+
+Note that you can still build Shairport Sync to support "classic" AirPlay (aka "AirPlay 1") as before.
+
+The various guides for building and updating Shairport Sync have been consolidated into [BUILD.md](./BUILD.md). 
+
+Here is a brief list of the high-level new features and changes (more to be added):
+* AirPlay 2 operation.
+* Improved `libao` backend for better compatibility with HomeBrew installations.
+* Improved MQTT and D-Bus facilities.
+* Automatically-generated Docker images (forthcoming).
+
+There have been many many bug fixes and enhancements to the core operation of Shairport Sync.
+
+Version 3.3.9
+====
+**Bug Fix**
+* Version 3.3.9 fixes a build failure with convolution raised since `automake 1.16.5` and https://git.savannah.gnu.org/cgit/automake.git/commit/?id=f4a3a70f69e1dbccb6578f39ef47835098a04624.
+Further details in [Fabrice Fontaine's original PR](https://github.com/mikebrady/shairport-sync/pull/1314) to the `development` branch. Many thanks to [Fabrice Fontaine](https://github.com/ffontaine) for the bug report and for the fix.
 
 Version 3.3.8
 ====
index 73e9e7b939e691b1a1f7a8cfb3b4985e3809a28c..d6436fdfd021366d5035e3e9fc603d3c20eaa7ce 100644 (file)
@@ -15,6 +15,15 @@ If you are using the default ALSA backend, don't forget to check two simple thin
 
 You can use `alsamixer` for both of theses checks. A muted output has the letter(s) `M` as its value. Select it and type `M` again to unmute. 
 
+### Audio is Delayed!
+If the audio from your Shairport Sync device is delayed slightly by comparison with audio from other devices, it may be that the output device being fed by Shairport Sync is introducing a delay while it processes the audio. If your output device include any digital processing component, it probably delays the audio while it processing occurs. 
+
+For instance, if your output device is a HDMI-connected device such as a TV or an AV Receiver, it will almost certainly delay audio by anything up to several hundred milliseconds.
+
+The fix for this is to ask Shairport Sync to provide the audio to the output device _slightly ahead of time_, so that by the time the output device has processed it, the audio emerges at exactly the right time. The setting to look for is in the `general` section of the Shairport Sync configuration file and is called `audio_backend_latency_offset_in_seconds`. By default it is `0.0` seconds.
+
+For example, if your output device is delaying audio by 100 milliseconds (0.1 seconds), set the `audio_backend_latency_offset_in_seconds` to `-0.1`, so that audio is provided to your output device 0.1 seconds early. Remember to uncomment the line by removing the initial `//` and then restart Shairport Sync (or reboot the device) for the changed setting to take effect.
+
 ### WiFi adapter running in power-saving / low-power mode
 
 **Check Throughput**