doc/user.rst: Clarify how MPD reads metadata

The writing and reading of metadata involves lots of different programs and libraries. Therefore it is prudent to point out how exactly MPD receives metadata. Ideally this helps to point users to the right place if their tags are not picked up correctly.

doc/user.rst: Clarify how MPD reads metadata
59da7780 · Wolfgang Müller · Max Kellermann · 108ce95b · 59da7780
Commit 59da7780 authored Feb 13, 2022 by Wolfgang Müller Committed by Max Kellermann Feb 14, 2022
Hide whitespace changes
Inline Side-by-side

Showing with 9 additions and 0 deletions

user.rst doc/user.rst +9 -0

No files found.
--- a/doc/user.rst
+++ b/doc/user.rst
@@ -1103,6 +1103,15 @@ See :ref:`tags` for a list of supported tags.
 The :ref:`metadata_to_use <metadata_to_use>` setting can be used to
 enable or disable certain tags.

+Note that :program:`MPD` may not necessarily read metadata itself,
+instead relying on data reported by the decoder that was used to read
+a file. For example, this is the case for the FFmpeg decoder: both
+:program:`MPD` and FFmpeg need to support a given metadata format in
+order for metadata to be picked up correctly.
+
+Only if a decoder does not have metadata support will :program:`MPD`
+attempt to parse a song's metadata itself.
+
 The queue
 ---------