player: parse and expose m3u playlist titles

Requested. Closes #2100.

2 files changed, 7 insertions, 0 deletions

diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index c116e1e005..a92768953e 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -20,6 +20,7 @@ Interface changes
 ::
 
  --- mpv 0.10.0 will be released ---
+    - add "playlist/N/title" property
     - add --video-stereo-mode=no to disable auto-conversions
     - add --force-seekable, and change default seekability in some cases
     - add vf yadif/vavpp/vdpaupp interlaced-only suboptions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 46aa590bc6..775b45d9e9 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -1530,6 +1530,11 @@ Property list
         been unloaded yet; in this case, ``current`` refers to the new
         selection. (Since mpv 0.7.0.)
 
+    ``playlist/N/title``
+        Name of the Nth entry. Only available if the playlist file contains
+        such fields, and only if mpv's parser supports it for the given
+        playlist format.
+
     When querying the property with the client API using ``MPV_FORMAT_NODE``,
     or with Lua ``mp.get_property_native``, this will return a mpv_node with
     the following contents:
@@ -1541,6 +1546,7 @@ Property list
                 "filename"  MPV_FORMAT_STRING
                 "current"   MPV_FORMAT_FLAG (might be missing; since mpv 0.7.0)
                 "playing"   MPV_FORMAT_FLAG (same)
+                "title"     MPV_FORMAT_STRING (optional)
 
 ``track-list``
     List of audio/video/sub tracks, current entry marked. Currently, the raw