diff options
Diffstat (limited to 'data')
| -rw-r--r-- | data/man/gallery-dl.1 | 2 | ||||
| -rw-r--r-- | data/man/gallery-dl.conf.5 | 152 |
2 files changed, 148 insertions, 6 deletions
diff --git a/data/man/gallery-dl.1 b/data/man/gallery-dl.1 index 751d470..d4efeed 100644 --- a/data/man/gallery-dl.1 +++ b/data/man/gallery-dl.1 @@ -1,4 +1,4 @@ -.TH "GALLERY-DL" "1" "2022-07-15" "1.22.4" "gallery-dl Manual" +.TH "GALLERY-DL" "1" "2022-08-28" "1.23.0" "gallery-dl Manual" .\" disable hyphenation .nh diff --git a/data/man/gallery-dl.conf.5 b/data/man/gallery-dl.conf.5 index 39550ad..642cb78 100644 --- a/data/man/gallery-dl.conf.5 +++ b/data/man/gallery-dl.conf.5 @@ -1,4 +1,4 @@ -.TH "GALLERY-DL.CONF" "5" "2022-07-15" "1.22.4" "gallery-dl Manual" +.TH "GALLERY-DL.CONF" "5" "2022-08-28" "1.23.0" "gallery-dl Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -458,6 +458,8 @@ and optional for * \f[I]tsumino\f[] .br * \f[I]twitter\f[] +.br +* \f[I]zerochan\f[] These values can also be specified via the \f[I]-u/--username\f[] and \f[I]-p/--password\f[] command-line options or @@ -667,6 +669,21 @@ This can then be used in \f[I]filenames\f[], with a \f[I]metadata\f[] post processor, etc. +.SS extractor.*.path-metadata +.IP "Type:" 6 +\f[I]string\f[] + +.IP "Default:" 9 +\f[I]null\f[] + +.IP "Description:" 4 +Insert a reference to the current \f[I]PathFormat\f[] +data structure into metadata dictionaries as the given name. + +For example, setting this option to \f[I]"gdl_path"\f[] would make it possible +to access the current file's filename as \f[I]"[gdl_path.filename}"\f[]. + + .SS extractor.*.category-transfer .IP "Type:" 6 \f[I]bool\f[] @@ -1516,6 +1533,19 @@ Selects which site layout to expect when parsing posts. * \f[I]"new"\f[]: Expect the *new* site layout +.SS extractor.gelbooru.api-key & .user-id +.IP "Type:" 6 +\f[I]string\f[] + +.IP "Default:" 9 +\f[I]null\f[] + +.IP "Description:" 4 +Values from the API Access Credentials section found at the bottom of your +\f[I]Account Options\f[] +page. + + .SS extractor.generic.enabled .IP "Type:" 6 \f[I]bool\f[] @@ -1751,6 +1781,19 @@ Controls how to handle duplicate files in a post. Extract a user's direct messages as \f[I]dms\f[] metadata. +.SS extractor.kemonoparty.favorites +.IP "Type:" 6 +\f[I]string\f[] + +.IP "Default:" 9 +\f[I]artist\f[] + +.IP "Description:" 4 +Determines the type of favorites to be downloaded. + +Available types are \f[I]artist\f[], and \f[I]post\f[]. + + .SS extractor.kemonoparty.files .IP "Type:" 6 \f[I]list\f[] of \f[I]strings\f[] @@ -2007,6 +2050,17 @@ Store tokens received during OAuth authorizations in \f[I]cache\f[]. +.SS extractor.oauth.host +.IP "Type:" 6 +\f[I]string\f[] + +.IP "Default:" 9 +\f[I]"localhost"\f[] + +.IP "Description:" 4 +Host name / IP address to bind to during OAuth authorization. + + .SS extractor.oauth.port .IP "Type:" 6 \f[I]integer\f[] @@ -2424,6 +2478,17 @@ Download video embeds from external sites. Download videos. +.SS extractor.skeb.article +.IP "Type:" 6 +\f[I]bool\f[] + +.IP "Default:" 9 +\f[I]false\f[] + +.IP "Description:" 4 +Download article images. + + .SS extractor.skeb.sent-requests .IP "Type:" 6 \f[I]bool\f[] @@ -2502,6 +2567,21 @@ images from them. Search posts for inline images and videos. +.SS extractor.tumblr.original +.IP "Type:" 6 +\f[I]bool\f[] + +.IP "Default:" 9 +\f[I]true\f[] + +.IP "Description:" 4 +Download full-resolution \f[I]photo\f[] images. + +For each photo with "maximum" resolution +(width equal to 2048 or height equal to 3072), +use an extra HTTP request to find the URL to its full-resolution version. + + .SS extractor.tumblr.reblogs .IP "Type:" 6 \f[I]bool\f[] or \f[I]string\f[] @@ -2846,6 +2926,19 @@ to use your account's browsing settings and default filters when searching. See https://wallhaven.cc/help/api for more information. +.SS extractor.wallhaven.metadata +.IP "Type:" 6 +\f[I]bool\f[] + +.IP "Default:" 9 +\f[I]false\f[] + +.IP "Description:" 4 +Extract additional metadata (tags, uploader) + +Note: This requires 1 additional HTTP request for each post. + + .SS extractor.weasyl.api-key .IP "Type:" 6 \f[I]string\f[] @@ -3714,16 +3807,20 @@ See \f[I]metadata.event\f[] for a list of available events. \f[I]"json"\f[] .IP "Description:" 4 -Select how to write metadata. +Selects how to process metadata. .br -* \f[I]"json"\f[]: all metadata using \f[I]json.dump() +* \f[I]"json"\f[]: write metadata using \f[I]json.dump() <https://docs.python.org/3/library/json.html#json.dump>\f[] .br -* \f[I]"tags"\f[]: \f[I]tags\f[] separated by newlines +* \f[I]"tags"\f[]: write \f[I]tags\f[] separated by newlines .br -* \f[I]"custom"\f[]: result of applying \f[I]metadata.content-format\f[] +* \f[I]"custom"\f[]: write the result of applying \f[I]metadata.content-format\f[] to a file's metadata dictionary +.br +* \f[I]"modify"\f[]: add or modify metadata entries +.br +* \f[I]"delete"\f[]: remove metadata entries .SS metadata.filename @@ -3821,6 +3918,39 @@ When starting to download all files of a post, e.g. a Tweet on Twitter or a post on Patreon. +.SS metadata.fields +.IP "Type:" 6 +.br +* \f[I]list\f[] of \f[I]strings\f[] +.br +* \f[I]object\f[] (field name -> \f[I]format string\f[]) + +.IP "Example:" 4 +.br +* .. code:: json + +["blocked", "watching", "status[creator][name]"] + +.br +* .. code:: json + +{ +"blocked" : "***", +"watching" : "\\fE 'yes' if watching else 'no'", +"status[username]": "{status[creator][name]!l}" +} + + +.IP "Description:" 4 +.br +* \f[I]"mode": "delete"\f[]: +A list of metadata field names to remove. +.br +* \f[I]"mode": "modify"\f[]: +An object with metadata field names mapping to a \f[I]format string\f[] +whose result is assigned to said field name. + + .SS metadata.content-format .IP "Type:" 6 \f[I]string\f[] or \f[I]list\f[] of \f[I]strings\f[] @@ -4190,6 +4320,18 @@ The list of signal names to ignore, i.e. set as signal handler for. +.SS warnings +.IP "Type:" 6 +\f[I]string\f[] + +.IP "Default:" 9 +\f[I]"default"\f[] + +.IP "Description:" 4 +The \f[I]Warnings Filter action\f[] +used for (urllib3) warnings. + + .SS pyopenssl .IP "Type:" 6 \f[I]bool\f[] |
