aboutsummaryrefslogtreecommitdiffstats
path: root/data
diff options
context:
space:
mode:
Diffstat (limited to 'data')
-rw-r--r--data/man/gallery-dl.12
-rw-r--r--data/man/gallery-dl.conf.575
2 files changed, 43 insertions, 34 deletions
diff --git a/data/man/gallery-dl.1 b/data/man/gallery-dl.1
index 4137501..9751705 100644
--- a/data/man/gallery-dl.1
+++ b/data/man/gallery-dl.1
@@ -1,4 +1,4 @@
-.TH "GALLERY-DL" "1" "2025-10-03" "1.30.9" "gallery-dl Manual"
+.TH "GALLERY-DL" "1" "2025-10-12" "1.30.10" "gallery-dl Manual"
.\" disable hyphenation
.nh
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