From 2b2bb95181bc2c2d3d0b5c25c267bb574c3c2503 Mon Sep 17 00:00:00 2001
From: nanahi <130121847+na-na-hi@users.noreply.github.com>
Date: Sat, 14 Mar 2026 09:40:03 -0400
Subject: [PATCH] DOCS/man/mpv: document archive protocol

This protocol is useful for opening a specified file in an archive
instead of opening the archive as a playlist.
---
 DOCS/man/mpv.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst
index 420297483e..ce2c24f924 100644
--- a/DOCS/man/mpv.rst
+++ b/DOCS/man/mpv.rst
@@ -1474,6 +1474,20 @@ PROTOCOLS
 
     Like ``memory://``, but the string is interpreted as hexdump.
 
+``archive://[ARCHIVE PATH]|[FILE PATH IN ARCHIVE]``
+
+    Open a file at the specified path inside an archive. Requires libarchive
+    feature enabled. The archive path must have all ``%`` and ``|`` characters
+    URL escaped. The file path should not be URL escaped.
+
+    .. admonition:: Example
+
+        ::
+
+            mpv "archive://file.zip|video.mkv"
+
+        This will play ``video.mkv`` in the archive file ``file.zip``.
+
 PSEUDO GUI MODE
 ===============