diff options
Diffstat (limited to 'data')
| -rw-r--r-- | data/man/gallery-dl.1 | 2 | ||||
| -rw-r--r-- | data/man/gallery-dl.conf.5 | 188 |
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"] } |