Update upstream source from tag 'upstream/1.28.3'

Update to upstream version '1.28.3'
with Debian dir fe41cbe50ee9a08af1064b39f7e0695bbb30046b

2 files changed, 112 insertions, 78 deletions

diff --git a/data/man/gallery-dl.1 b/data/man/gallery-dl.1
index 3d84f58..f4791df 100644
--- a/data/man/gallery-dl.1
+++ b/data/man/gallery-dl.1
@@ -1,4 +1,4 @@
-.TH "GALLERY-DL" "1" "2024-12-20" "1.28.2" "gallery-dl Manual"
+.TH "GALLERY-DL" "1" "2025-01-04" "1.28.3" "gallery-dl Manual"
 .\" disable hyphenation
 .nh
 
diff --git a/data/man/gallery-dl.conf.5 b/data/man/gallery-dl.conf.5
index c27f632..7028b7a 100644
--- a/data/man/gallery-dl.conf.5
+++ b/data/man/gallery-dl.conf.5
@@ -1,4 +1,4 @@
-.TH "GALLERY-DL.CONF" "5" "2024-12-20" "1.28.2" "gallery-dl Manual"
+.TH "GALLERY-DL.CONF" "5" "2025-01-04" "1.28.3" "gallery-dl Manual"
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -454,18 +454,34 @@ response before \f[I]retrying\f[] the request.
 .IP "Default:" 9
 .br
 * \f[I]"0.5-1.5"\f[]
-\f[I]ao3\f[], \f[I]civitai\f[],
-\f[I][Danbooru]\f[], \f[I][E621]\f[], \f[I][foolfuuka]:search\f[], \f[I]itaku\f[],
+\f[I]ao3\f[],
+\f[I]civitai\f[],
+\f[I][Danbooru]\f[],
+\f[I][E621]\f[],
+\f[I][foolfuuka]:search\f[],
+\f[I]itaku\f[],
 \f[I]koharu\f[],
-\f[I]newgrounds\f[], \f[I][philomena]\f[], \f[I]pixiv:novel\f[], \f[I]plurk\f[],
-\f[I]poipiku\f[] , \f[I]pornpics\f[], \f[I]scrolller\f[], \f[I]soundgasm\f[],
-\f[I]urlgalleries\f[], \f[I]vk\f[], \f[I]zerochan\f[]
+\f[I]newgrounds\f[],
+\f[I][philomena]\f[],
+\f[I]pixiv:novel\f[],
+\f[I]plurk\f[],
+\f[I]poipiku\f[] ,
+\f[I]pornpics\f[],
+\f[I]scrolller\f[],
+\f[I]soundgasm\f[],
+\f[I]urlgalleries\f[],
+\f[I]vk\f[],
+\f[I]zerochan\f[]
 .br
 * \f[I]"1.0-2.0"\f[]
-\f[I]flickr\f[], \f[I]weibo\f[], \f[I][wikimedia]\f[]
+\f[I]flickr\f[],
+\f[I]weibo\f[],
+\f[I][wikimedia]\f[]
 .br
 * \f[I]"2.0-4.0"\f[]
-\f[I]behance\f[], \f[I]imagefap\f[], \f[I][Nijie]\f[]
+\f[I]behance\f[],
+\f[I]imagefap\f[],
+\f[I][Nijie]\f[]
 .br
 * \f[I]"3.0-6.0"\f[]
 \f[I]bilibili\f[],
@@ -782,17 +798,20 @@ or a \f[I]list\f[] with IP and explicit port number as elements.
 \f[I]string\f[]
 
 .IP "Default:" 9
-\f[I]"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:128.0) Gecko/20100101 Firefox/128.0"\f[]
+.br
+* \f[I]"gallery-dl/VERSION"\f[]: \f[I][Danbooru]\f[], \f[I]mangadex\f[]
+.br
+* \f[I]"gallery-dl/VERSION (by mikf)"\f[]: \f[I][E621]\f[]
+.br
+* \f[I]"Patreon/72.2.28 (Android; Android 14; Scale/2.10)"\f[]: \f[I]patreon\f[]
+.br
+* \f[I]"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:LATEST) Gecko/20100101 Firefox/LATEST"\f[]: otherwise
 
 .IP "Description:" 4
 User-Agent header value to be used for HTTP requests.
 
 Setting this value to \f[I]"browser"\f[] will try to automatically detect
-and use the User-Agent used by the system's default browser.
-
-Note: This option has no effect on
-pixiv, e621, mangadex, and patreon
-extractors, as these need specific values to function correctly.
+and use the \f[I]User-Agent\f[] header of the system's default browser.
 
 
 .SS extractor.*.browser
@@ -1965,9 +1984,15 @@ A (comma-separated) list of subcategories to include
 when processing a user profile.
 
 Possible values are
-\f[I]"user-models"\f[],
-\f[I]"user-posts"\f[],
-\f[I]"user-images"\f[].
+
+.br
+* \f[I]"user-models"\f[]
+.br
+* \f[I]"user-posts"\f[]
+.br
+* \f[I]"user-images"\f[]
+.br
+* \f[I]"user-videos"\f[]
 
 It is possible to use \f[I]"all"\f[] instead of listing all values separately.
 
@@ -1993,7 +2018,7 @@ It is possible to use \f[I]"all"\f[] instead of listing all values separately.
 .IP "Description:" 4
 Extract additional \f[I]generation\f[] metadata.
 
-Note: This requires 1 additional HTTP request per image.
+Note: This requires 1 additional HTTP request per image or video.
 
 
 .SS extractor.civitai.nsfw
@@ -2135,7 +2160,7 @@ Setting this option to \f[I]"auto"\f[]
 uses the same domain as a given input URL.
 
 
-.SS extractor.danbooru.external
+.SS extractor.[Danbooru].external
 .IP "Type:" 6
 \f[I]bool\f[]
 
@@ -2147,7 +2172,7 @@ For unavailable or restricted posts,
 follow the \f[I]source\f[] and download from there if possible.
 
 
-.SS extractor.danbooru.ugoira
+.SS extractor.[Danbooru].ugoira
 .IP "Type:" 6
 \f[I]bool\f[]
 
@@ -2212,48 +2237,6 @@ greater than the per-page limit, gallery-dl will stop after the first
 batch. The value cannot be less than 1.
 
 
-.SS extractor.derpibooru.api-key
-.IP "Type:" 6
-\f[I]string\f[]
-
-.IP "Default:" 9
-\f[I]null\f[]
-
-.IP "Description:" 4
-Your \f[I]Derpibooru API Key\f[],
-to use your account's browsing settings and filters.
-
-
-.SS extractor.derpibooru.filter
-.IP "Type:" 6
-\f[I]integer\f[]
-
-.IP "Default:" 9
-\f[I]56027\f[] (\f[I]Everything\f[] filter)
-
-.IP "Description:" 4
-The content filter ID to use.
-
-Setting an explicit filter ID overrides any default filters and can be used
-to access 18+ content without \f[I]API Key\f[].
-
-See \f[I]Filters\f[] for details.
-
-
-.SS extractor.derpibooru.svg
-.IP "Type:" 6
-\f[I]bool\f[]
-
-.IP "Default:" 9
-\f[I]true\f[]
-
-.IP "Description:" 4
-Download SVG versions of images when available.
-
-Try to download the \f[I]view_url\f[] version of these posts
-when this option is disabled.
-
-
 .SS extractor.deviantart.auto-watch
 .IP "Type:" 6
 \f[I]bool\f[]
@@ -4097,25 +4080,73 @@ Selects the format of \f[I]images\f[] \f[I]files\f[].
 Possible formats:
 
 .br
-* \f[I]original\f[]
+* \f[I]download_url\f[] (\f[I]"a":1,"p":1\f[])
 .br
-* \f[I]default\f[]
+* \f[I]url\f[] (\f[I]"w":620\f[])
 .br
-* \f[I]default_small\f[]
+* \f[I]original\f[] (\f[I]"q":100,"webp":0\f[])
 .br
-* \f[I]default_blurred\f[]
+* \f[I]default\f[] (\f[I]"w":620\f[])
 .br
-* \f[I]default_blurred_small\f[]
+* \f[I]default_small\f[] (\f[I]"w":360\f[])
 .br
-* \f[I]thumbnail\f[]
+* \f[I]default_blurred\f[] (\f[I]"w":620\f[])
 .br
-* \f[I]thumbnail_large\f[]
+* \f[I]default_blurred_small\f[] (\f[I]"w":360\f[])
 .br
-* \f[I]thumbnail_small\f[]
+* \f[I]thumbnail\f[] (\f[I]"h":360,"w":360\f[])
 .br
-* \f[I]url\f[]
+* \f[I]thumbnail_large\f[] (\f[I]"h":1080,"w":1080\f[])
 .br
-* \f[I]download_url\f[]
+* \f[I]thumbnail_small\f[] (\f[I]"h":100,"w":100\f[])
+
+
+.SS extractor.[philomena].api-key
+.IP "Type:" 6
+\f[I]string\f[]
+
+.IP "Default:" 9
+\f[I]null\f[]
+
+.IP "Description:" 4
+Your account's API Key,
+to use your personal browsing settings and filters.
+
+
+.SS extractor.[philomena].filter
+.IP "Type:" 6
+\f[I]integer\f[]
+
+.IP "Default:" 9
+:\f[I]derpibooru\f[]:
+\f[I]56027\f[] (\f[I]Everything\f[] filter)
+:\f[I]ponybooru\f[]:
+\f[I]3\f[] (\f[I]Nah.\f[] filter)
+:otherwise:
+\f[I]2\f[]
+
+
+.IP "Description:" 4
+The content filter ID to use.
+
+Setting an explicit filter ID overrides any default filters and can be used
+to access 18+ content without \f[I]API Key\f[].
+
+See \f[I]Filters\f[] for details.
+
+
+.SS extractor.[philomena].svg
+.IP "Type:" 6
+\f[I]bool\f[]
+
+.IP "Default:" 9
+\f[I]true\f[]
+
+.IP "Description:" 4
+Download SVG versions of images when available.
+
+Try to download the \f[I]view_url\f[] version of these posts
+when this option is disabled.
 
 
 .SS extractor.pillowfort.external
@@ -6218,7 +6249,7 @@ Note: This requires 1 additional HTTP request per post.
 .br
 * "preview_url"
 .br
-* ["sample_url", "preview_url", "file_url"}
+* ["sample_url", "preview_url", "file_url"]
 
 .IP "Description:" 4
 Alternate field name to retrieve download URLs from.
@@ -6992,10 +7023,13 @@ before outputting them as JSON.
 .. code:: json
 
 {
-"Pictures": ["jpg", "jpeg", "png", "gif", "bmp", "svg", "webp"],
-"Video"   : ["flv", "ogv", "avi", "mp4", "mpg", "mpeg", "3gp", "mkv", "webm", "vob", "wmv"],
-"Music"   : ["mp3", "aac", "flac", "ogg", "wma", "m4a", "wav"],
-"Archives": ["zip", "rar", "7z", "tar", "gz", "bz2"]
+"Pictures" : ["jpg", "jpeg", "png", "gif", "bmp", "svg", "webp",
+"avif", "heic", "heif", "ico", "psd"],
+"Video"    : ["flv", "ogv", "avi", "mp4", "mpg", "mpeg", "3gp", "mkv",
+"webm", "vob", "wmv", "m4v", "mov"],
+"Music"    : ["mp3", "aac", "flac", "ogg", "wma", "m4a", "wav"],
+"Archives" : ["zip", "rar", "7z", "tar", "gz", "bz2"],
+"Documents": ["txt", "pdf"]
 }