add 'path-extended' option (#3021)

2022-10-07 18:23:06 +02:00
parent bc9d291c13
commit 7f30a0d7a7
3 changed files with 17 additions and 1 deletions
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -263,6 +263,17 @@ Description
    * ``"windows"``: ``". "``


+extractor.*.path-extended
+-------------------------
+Type
+    ``bool``
+Default
+    ``true``
+Description
+    On Windows, use `extended-length paths <https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation>`__
+    prefixed with ``\\?\`` to work around the 260 characters path length limit.
+
+
 extractor.*.extension-map
 -------------------------
 Type
--- a/docs/gallery-dl.conf
+++ b/docs/gallery-dl.conf
@@ -24,6 +24,8 @@
        "path-replace": "_",
        "path-remove": "\\u0000-\\u001f\\u007f",
        "path-strip": "auto",
+        "path-extended": true,
+
        "extension-map": {
            "jpeg": "jpg",
            "jpe" : "jpg",