diff options
Diffstat (limited to 'data/man/gallery-dl.conf.5')
| -rw-r--r-- | data/man/gallery-dl.conf.5 | 75 |
1 files changed, 42 insertions, 33 deletions
diff --git a/data/man/gallery-dl.conf.5 b/data/man/gallery-dl.conf.5 index b827aeb..320963f 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-10-03" "1.30.9" "gallery-dl Manual" +.TH "GALLERY-DL.CONF" "5" "2025-10-12" "1.30.10" "gallery-dl Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -173,14 +173,34 @@ segment, which will be joined together and appended to the .SS extractor.*.base-directory .IP "Type:" 6 -\f[I]Path\f[] +.br +* \f[I]Path\f[] +.br +* \f[I]object\f[] (\f[I]Condition\f[] → \f[I]Path\f[]) .IP "Default:" 9 \f[I]"./gallery-dl/"\f[] +.IP "Example:" 4 +.. code:: json + +"~/Downloads/gallery-dl" + +.. code:: json + +{ +"score >= 100": "$DL", +"duration" : "$DL/video", +"" : "/tmp/files/" +} + .IP "Description:" 4 Directory path used as base for all download destinations. +If this is an \f[I]object\f[], +it must contain \f[I]Conditions\f[] mapping to the \f[I]Path\f[] to use. +Specifying a default \f[I]Path\f[] with \f[I]""\f[] is required. + .SS extractor.*.parent-directory .IP "Type:" 6 @@ -646,8 +666,6 @@ This is supported for .br * \f[I]tsumino\f[] .br -* \f[I]twitter\f[] -.br * \f[I]vipergirls\f[] .br * \f[I]zerochan\f[] @@ -7127,20 +7145,6 @@ Wait until rate limit reset Wait for \f[I]N\f[] seconds -.SS extractor.twitter.relogin -.IP "Type:" 6 -\f[I]bool\f[] - -.IP "Default:" 9 -\f[I]true\f[] - -.IP "Description:" 4 -When receiving a "Could not authenticate you" error while logged in with -\f[I]username & password\f[], -refresh the current login session and -try to continue from where it left off. - - .SS extractor.twitter.locked .IP "Type:" 6 \f[I]string\f[] @@ -8806,7 +8810,7 @@ as a custom \f[I]format string\f[]. Possible replacement keys are .SS output.log .IP "Type:" 6 .br -* \f[I]string\f[] +* \f[I]Format String\f[] .br * \f[I]Logging Configuration\f[] @@ -8816,9 +8820,6 @@ as a custom \f[I]format string\f[]. Possible replacement keys are .IP "Description:" 4 Configuration for logging output to stderr. -If this is a simple \f[I]string\f[], it specifies -the format string for logging messages. - .SS output.logfile .IP "Type:" 6 @@ -8841,7 +8842,7 @@ File to write logging output to. .IP "Description:" 4 File to write external URLs unsupported by *gallery-dl* to. -The default format string here is \f[I]"{message}"\f[]. +The default \f[I]Format String\f[] here is \f[I]"{message}"\f[]. .SS output.errorfile @@ -8854,7 +8855,7 @@ The default format string here is \f[I]"{message}"\f[]. .IP "Description:" 4 File to write input URLs which returned an error to. -The default format string here is also \f[I]"{message}"\f[]. +The default \f[I]Format String\f[] here is also \f[I]"{message}"\f[]. When combined with \f[I]-I\f[]/\f[I]--input-file-comment\f[] or @@ -9031,8 +9032,8 @@ with the full path of a file or target directory, depending on name and any further elements its arguments. Each element of this list is evaluated as a \f[I]Format String\f[] using -the files' metadata as well as \f[I]{_path}\f[], \f[I]{_directory}\f[], -and \f[I]{_filename}\f[]. +the files' metadata as well as +\f[I]{_path}\f[], \f[I]{_temppath}\f[], \f[I]{_directory}\f[], and \f[I]{_filename}\f[]. .SS exec.commands @@ -9419,6 +9420,11 @@ A list of metadata field names to remove. An object with metadata field names mapping to a \f[I]Format String\f[] whose result is assigned to that field name. +.IP "Note::" 4 +Unlike standard \f[I]Format Strings\f[], replacement fields here +preserve the original type of their value +instead of automatically converting it to \f[I]type-str\f[]. + .SS metadata.content-format .IP "Type:" 6 @@ -9635,7 +9641,7 @@ See \f[I]metadata.event\f[] for a list of available events. Name of the metadata field whose value should be used. This value must be either a UNIX timestamp or a -\f[I]datetime\f[] object. +\f[I]type-datetime\f[] object. .IP "Note:" 4 This option is ignored if \f[I]mtime.value\f[] is set. @@ -9658,7 +9664,12 @@ This option is ignored if \f[I]mtime.value\f[] is set. The \f[I]Format String\f[] whose value should be used. The resulting value must be either a UNIX timestamp or a -\f[I]datetime\f[] object. +\f[I]type-datetime\f[] object. + +.IP "Note::" 4 +Unlike standard \f[I]Format Strings\f[], replacement fields here +preserve the original type of their value +instead of automatically converting it to \f[I]type-str\f[]. .SS python.archive @@ -10721,8 +10732,8 @@ Extended logging output configuration. .br * format .br -* General format string for logging messages -or an \f[I]object\f[] with format strings for each loglevel. +* General \f[I]Format String\f[] for logging messages +or an \f[I]object\f[] with \f[I]Format Strings\f[] for each loglevel. In addition to the default \f[I]LogRecord attributes\f[], @@ -10953,9 +10964,7 @@ that evaluate to a single value. .IP "Description:" 4 A \f[I]Condition\f[] is an \f[I]Expression\f[] -whose result is evaluated as a -\f[I]boolean\f[] -value. +whose result is evaluated as a \f[I]type-bool\f[] value. .SS Format String |