From: Mike Brady <4265913+mikebrady@users.noreply.github.com>
Date: Wed, 30 Nov 2022 16:23:26 +0000 (+0000)
Subject: Add detail about the new 'progress_interval' metadata setting.
X-Git-Tag: 4.1.1~2^2~9
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5bf379f7808eb442ab67b31e996e1afc049a227b;p=thirdparty%2Fshairport-sync.git

Add detail about the new 'progress_interval' metadata setting.
---

diff --git a/scripts/shairport-sync.conf b/scripts/shairport-sync.conf
index 730b4c1c..660d2b2a 100644
--- a/scripts/shairport-sync.conf
+++ b/scripts/shairport-sync.conf
@@ -216,6 +216,9 @@ metadata =
 //	cover_art_cache_directory = "/tmp/shairport-sync/.cache/coverart"; // artwork will be  stored in this directory if the dbus or MPRIS interfaces are enabled or if the MQTT client is in use. Set it to "" to prevent caching, which may be useful on some systems
 //	pipe_name = "/tmp/shairport-sync-metadata";
 //	pipe_timeout = 5000; // wait for this number of milliseconds for a blocked pipe to unblock before giving up
+//	progress_interval = 0.0; // if non-zero, progress 'phbt' messages will be sent at the interval specified in seconds. A 'phb0' message will also be sent when the first audio frame of a play session is about to be played.
+//		Each message consists of the RTPtime of a a frame of audio and the exact system time when it is to be played. The system time, in nanoseconds, is based the CLOCK_MONOTONIC_RAW of the machine -- if available -- or CLOCK_MONOTONIC otherwise.
+//		Messages are sent when the frame is placed in the output device's buffer, thus, they will be _approximately_ 'audio_backend_buffer_desired_length_in_seconds' (default 0.2 seconds) ahead of time.
 //	socket_address = "226.0.0.1"; // if set to a host name or IP address, UDP packets containing metadata will be sent to this address. May be a multicast address. "socket-port" must be non-zero and "enabled" must be set to yes"
 //	socket_port = 5555; // if socket_address is set, the port to send UDP packets to
 //	socket_msglength = 65000; // the maximum packet size for any UDP metadata. This will be clipped to be between 500 or 65000. The default is 500.