New upstream version 1.31.2.upstream/1.31.2upstream

5 files changed, 151 insertions, 20 deletions

diff --git a/data/completion/_gallery-dl b/data/completion/_gallery-dl
index 681b429..624f499 100644
--- a/data/completion/_gallery-dl
+++ b/data/completion/_gallery-dl
@@ -51,6 +51,7 @@ _arguments -s -S \
 {-r,--limit-rate}'[Maximum download rate (e.g. 500k, 2.5M, or 800k-2M)]':'<rate>' \
 --chunk-size'[Size of in-memory data chunks (default: 32k)]':'<size>' \
 --sleep'[Number of seconds to wait before each download. This can be either a constant value or a range (e.g. 2.7 or 2.0-3.5)]':'<seconds>' \
+--sleep-skip'[Number of seconds to wait after skipping a file download]':'<seconds>' \
 --sleep-request'[Number of seconds to wait between HTTP requests during data extraction]':'<seconds>' \
 --sleep-429'[Number of seconds to wait when receiving a '\''429 Too Many Requests'\'' response]':'<seconds>' \
 --sleep-extractor'[Number of seconds to wait before starting data extraction for an input URL]':'<seconds>' \
diff --git a/data/completion/gallery-dl b/data/completion/gallery-dl
index 1f3a33d..27f8d30 100644
--- a/data/completion/gallery-dl
+++ b/data/completion/gallery-dl
@@ -10,7 +10,7 @@ _gallery_dl()
     elif [[ "${prev}" =~ ^()$ ]]; then
         COMPREPLY=( $(compgen -d -- "${cur}") )
     else
-        COMPREPLY=( $(compgen -W "--help --version --filename --destination --directory --extractors --user-agent --clear-cache --compat --update-check --input-file --input-file-comment --input-file-delete --no-input --quiet --warning --verbose --get-urls --resolve-urls --dump-json --resolve-json --simulate --extractor-info --list-keywords --error-file --print --Print --print-to-file --Print-to-file --list-modules --list-extractors --write-log --write-unsupported --write-pages --print-traffic --no-colors --retries --http-timeout --proxy --source-address --force-ipv4 --force-ipv6 --no-check-certificate --limit-rate --chunk-size --sleep --sleep-request --sleep-429 --sleep-extractor --no-part --no-skip --no-mtime --no-download --option --config --config-yaml --config-toml --config-create --config-status --config-open --config-ignore --ignore-config --username --password --netrc --cookies --cookies-export --cookies-from-browser --abort --terminate --filesize-min --filesize-max --download-archive --range --post-range --chapter-range --filter --post-filter --chapter-filter --postprocessor --no-postprocessors --postprocessor-option --write-metadata --write-info-json --write-infojson --write-tags --zip --cbz --mtime --mtime-from-date --rename --rename-to --ugoira --ugoira-conv --ugoira-conv-lossless --ugoira-conv-copy --exec --exec-after" -- "${cur}") )
+        COMPREPLY=( $(compgen -W "--help --version --filename --destination --directory --extractors --user-agent --clear-cache --compat --update-check --input-file --input-file-comment --input-file-delete --no-input --quiet --warning --verbose --get-urls --resolve-urls --dump-json --resolve-json --simulate --extractor-info --list-keywords --error-file --print --Print --print-to-file --Print-to-file --list-modules --list-extractors --write-log --write-unsupported --write-pages --print-traffic --no-colors --retries --http-timeout --proxy --source-address --force-ipv4 --force-ipv6 --no-check-certificate --limit-rate --chunk-size --sleep --sleep-skip --sleep-request --sleep-429 --sleep-extractor --no-part --no-skip --no-mtime --no-download --option --config --config-yaml --config-toml --config-create --config-status --config-open --config-ignore --ignore-config --username --password --netrc --cookies --cookies-export --cookies-from-browser --abort --terminate --filesize-min --filesize-max --download-archive --range --post-range --chapter-range --filter --post-filter --chapter-filter --postprocessor --no-postprocessors --postprocessor-option --write-metadata --write-info-json --write-infojson --write-tags --zip --cbz --mtime --mtime-from-date --rename --rename-to --ugoira --ugoira-conv --ugoira-conv-lossless --ugoira-conv-copy --exec --exec-after" -- "${cur}") )
     fi
 }
 
diff --git a/data/completion/gallery-dl.fish b/data/completion/gallery-dl.fish
index 5a3d8aa..318c098 100644
--- a/data/completion/gallery-dl.fish
+++ b/data/completion/gallery-dl.fish
@@ -45,6 +45,7 @@ complete -c gallery-dl -l 'no-check-certificate' -d 'Disable HTTPS certificate v
 complete -c gallery-dl -x -s 'r' -l 'limit-rate' -d 'Maximum download rate (e.g. 500k, 2.5M, or 800k-2M)'
 complete -c gallery-dl -x -l 'chunk-size' -d 'Size of in-memory data chunks (default: 32k)'
 complete -c gallery-dl -x -l 'sleep' -d 'Number of seconds to wait before each download. This can be either a constant value or a range (e.g. 2.7 or 2.0-3.5)'
+complete -c gallery-dl -x -l 'sleep-skip' -d 'Number of seconds to wait after skipping a file download'
 complete -c gallery-dl -x -l 'sleep-request' -d 'Number of seconds to wait between HTTP requests during data extraction'
 complete -c gallery-dl -x -l 'sleep-429' -d 'Number of seconds to wait when receiving a "429 Too Many Requests" response'
 complete -c gallery-dl -x -l 'sleep-extractor' -d 'Number of seconds to wait before starting data extraction for an input URL'
diff --git a/data/man/gallery-dl.1 b/data/man/gallery-dl.1
index 90a423a..a465f37 100644
--- a/data/man/gallery-dl.1
+++ b/data/man/gallery-dl.1
@@ -1,4 +1,4 @@
-.TH "GALLERY-DL" "1" "2025-12-20" "1.31.1" "gallery-dl Manual"
+.TH "GALLERY-DL" "1" "2026-01-02" "1.31.2" "gallery-dl Manual"
 .\" disable hyphenation
 .nh
 
@@ -155,6 +155,9 @@ Size of in-memory data chunks (default: 32k)
 .B "\-\-sleep" \f[I]SECONDS\f[]
 Number of seconds to wait before each download. This can be either a constant value or a range (e.g. 2.7 or 2.0-3.5)
 .TP
+.B "\-\-sleep\-skip" \f[I]SECONDS\f[]
+Number of seconds to wait after skipping a file download
+.TP
 .B "\-\-sleep\-request" \f[I]SECONDS\f[]
 Number of seconds to wait between HTTP requests during data extraction
 .TP
diff --git a/data/man/gallery-dl.conf.5 b/data/man/gallery-dl.conf.5
index 7729342..ba881e5 100644
--- a/data/man/gallery-dl.conf.5
+++ b/data/man/gallery-dl.conf.5
@@ -1,4 +1,4 @@
-.TH "GALLERY-DL.CONF" "5" "2025-12-20" "1.31.1" "gallery-dl Manual"
+.TH "GALLERY-DL.CONF" "5" "2026-01-02" "1.31.2" "gallery-dl Manual"
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -502,6 +502,19 @@ Python \f[I]Expression\f[] controlling which skipped files to count towards
 Number of seconds to sleep before each download.
 
 
+.SS extractor.*.sleep-skip
+.IP "Type:" 6
+\f[I]Duration\f[]
+
+.IP "Default:" 9
+\f[I]0\f[]
+
+.IP "Description:" 4
+Number of seconds to sleep after
+\f[I]skipping\f[]
+a file download.
+
+
 .SS extractor.*.sleep-extractor
 .IP "Type:" 6
 \f[I]Duration\f[]
@@ -2631,7 +2644,7 @@ to download images in JPEG format at their original resolution.
 * \f[I]list\f[] of \f[I]strings\f[]
 
 .IP "Default:" 9
-\f[I]"quality=100"\f[]
+\f[I]"original=true,quality=100"\f[]
 
 .IP "Example:" 4
 .br
@@ -3541,6 +3554,17 @@ when processing a user profile.
 It is possible to use \f[I]"all"\f[] instead of listing all values separately.
 
 
+.SS extractor.facebook.loop
+.IP "Type:" 6
+\f[I]bool\f[]
+
+.IP "Default:" 9
+\f[I]false\f[]
+
+.IP "Description:" 4
+Continue when detecting a jump to a set's beginning.
+
+
 .SS extractor.facebook.videos
 .IP "Type:" 6
 .br
@@ -3662,12 +3686,26 @@ Custom \f[I]offset\f[] starting value when paginating over posts.
 \f[I]list\f[] of \f[I]integers\f[]
 
 .IP "Default:" 9
-\f[I][1, 2, 3, 4, 302, 303]\f[]
+\f[I]null\f[]
+
+.IP "Example:" 4
+[1, 2, 3, 4, 302, 303]
 
 .IP "Description:" 4
 List of file formats to consider during format selection.
 
 
+.SS extractor.fansly.previews
+.IP "Type:" 6
+\f[I]bool\f[]
+
+.IP "Default:" 9
+\f[I]true\f[]
+
+.IP "Description:" 4
+Download previews if no other format is available.
+
+
 .SS extractor.fansly.token
 .IP "Type:" 6
 \f[I]string\f[]
@@ -4762,6 +4800,17 @@ If the selected format is not available,
 the first in the list gets chosen (usually mp3).
 
 
+.SS extractor.koofr.zip
+.IP "Type:" 6
+\f[I]bool\f[]
+
+.IP "Default:" 9
+\f[I]false\f[]
+
+.IP "Description:" 4
+Download shared /links/ with multiple files as a single .zip file.
+
+
 .SS extractor.lolisafe.domain
 .IP "Type:" 6
 \f[I]string\f[]
@@ -5634,6 +5683,8 @@ when processing a user profile.
 * \f[I]novel-user\f[]
 .br
 * \f[I]novel-bookmark\f[]
+.br
+* \f[I]sketch\f[]
 
 .IP "Note:" 4
 It is possible to use \f[I]"all"\f[] instead of listing all values separately.
@@ -6860,6 +6911,17 @@ Ignore audio tracks
 Download video covers.
 
 
+.SS extractor.tiktok.photos
+.IP "Type:" 6
+\f[I]bool\f[]
+
+.IP "Default:" 9
+\f[I]true\f[]
+
+.IP "Description:" 4
+Download photos.
+
+
 .SS extractor.tiktok.videos
 .IP "Type:" 6
 \f[I]bool\f[]
@@ -6871,18 +6933,55 @@ Download video covers.
 Download videos using \f[I]ytdl\f[].
 
 
-.SS extractor.tiktok.user.avatar
+.SS extractor.tiktok.tiktok-range
+.IP "Type:" 6
+\f[I]string\f[]
+
+.IP "Default:" 9
+\f[I]""\f[]
+
+.IP "Example:" 4
+"1-20"
+
+.IP "Description:" 4
+Range or playlist indices of \f[I]tiktok\f[] posts to extract.
+
+When using ytdl, see
+\f[I]ytdl/playlist_items\f[]
+for details.
+
+
+.SS extractor.tiktok.posts.order-posts
+.IP "Type:" 6
+\f[I]string\f[]
+
+.IP "Default:" 9
+\f[I]"desc"\f[]
+
+.IP "Description:" 4
+Controls the order in which
+posts are processed.
+
+\f[I]"asc"\f[] | \f[I]"reverse"\f[]
+Ascending order (oldest first)
+\f[I]"desc"\f[]
+Descending order (newest first)
+\f[I]"popular"\f[]
+*Popular* order
+
+
+.SS extractor.tiktok.posts.ytdl
 .IP "Type:" 6
 \f[I]bool\f[]
 
 .IP "Default:" 9
-\f[I]true\f[]
+\f[I]false\f[]
 
 .IP "Description:" 4
-Download user avatars.
+Extract user posts with \f[I]ytdl\f[]
 
 
-.SS extractor.tiktok.user.module
+.SS extractor.tiktok.posts.module
 .IP "Type:" 6
 \f[I]Module\f[]
 
@@ -6896,22 +6995,36 @@ to extract posts from a \f[I]tiktok\f[] user profile with.
 See \f[I]extractor.ytdl.module\f[].
 
 
-.SS extractor.tiktok.user.tiktok-range
+.SS extractor.tiktok.user.include
 .IP "Type:" 6
-\f[I]string\f[]
+.br
+* \f[I]string\f[]
+.br
+* \f[I]list\f[] of \f[I]strings\f[]
 
 .IP "Default:" 9
-\f[I]""\f[]
-
-.IP "Example:" 4
-"1-20"
+\f[I]["avatar", "posts"]\f[]
 
 .IP "Description:" 4
-Range or playlist indices of \f[I]tiktok\f[] user posts to extract.
+A (comma-separated) list of subcategories to include
+when processing a user profile.
 
-See
-\f[I]ytdl/playlist_items\f[]
-for details.
+.IP "Supported Values:" 4
+.br
+* \f[I]avatar\f[]
+.br
+* \f[I]posts\f[]
+.br
+* \f[I]reposts\f[]
+.br
+* \f[I]stories\f[]
+.br
+* \f[I]likes\f[]
+.br
+* \f[I]saved\f[]
+
+.IP "Note:" 4
+It is possible to use \f[I]"all"\f[] instead of listing all values separately.
 
 
 .SS extractor.tumblr.avatar
@@ -7928,6 +8041,20 @@ Fetch extra submission metadata during gallery downloads.
 This requires 1 additional HTTP request per submission.
 
 
+.SS extractor.webtoons.bgm
+.IP "Type:" 6
+\f[I]bool\f[]
+
+.IP "Default:" 9
+\f[I]true\f[]
+
+.IP "Description:" 4
+Download an episode's background music if available.
+
+.IP "Note:" 4
+Requires \f[I]ytdl\f[]
+
+
 .SS extractor.webtoons.quality
 .IP "Type:" 6
 .br
@@ -7937,7 +8064,6 @@ This requires 1 additional HTTP request per submission.
 .br
 * \f[I]object\f[] (ext → type)
 
-
 .IP "Default:" 9
 \f[I]"original"\f[]