doc/protocol.rst: document RealUri

MaxKellermann · MaxKellermann · commit 9b4b3c3c5605 · 2026-06-17T12:42:37.000+02:00
diff --git a/NEWS b/NEWS
@@ -5,6 +5,7 @@ ver 0.25 (not yet released)
   - show detailed seek errors
   - support filename "cover.jxl" for "albumart" command
   - "albumart" response includes a "file" field with the artwork path
+  - song property "RealUri"
 * decoder
   - faad: implement seeking
   - faad: output 32 bit floating point samples instead of 16 bit integer
diff --git a/doc/protocol.rst b/doc/protocol.rst
@@ -391,6 +391,9 @@ may contain :ref:`song tags <tags>` and other metadata, specifically:
   fractional part).  Example: ``60-120`` plays only the second minute;
   "``180`` skips the first three minutes.
 
+- ``RealUri``: if this song really refers to another file (e.g. a
+  track in a CUE sheet), then this is its URI.
+
 - ``Format``: the audio format of the song
   (or an approximation to a format supported by MPD and the
   decoder plugin being used).  When playing this file, the
