Scroll to navigation

datalad download-url(1) datalad datalad download-url(1)


datalad download-url - download content


datalad download-url [-h] [-d PATH] [-O PATH] [-o] [--archive] [--nosave] [-m MESSAGE] url [url ...]


It allows for a uniform download interface to various supported URL schemes, re-using or asking for authentication details maintained by datalad.


$ datalad download-url s3://bucket/file2.dat


URL(s) to be downloaded. Constraints: value must be a string

-h, --help, --help-np
show this help message. --help-np forcefully disables the use of a pager for displaying the help message
-d PATH, --dataset PATH
specify the dataset to add files to. If no dataset is given, an attempt is made to identify the dataset based on the current working directory and/or the PATH given. Use --nosave to prevent adding files to the dataset. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) [Default: None]
-O PATH, --path PATH
path (filename or directory path) where to store downloaded file(s). In case of multiple URLs provided, must point to a directory. Otherwise current directory is used. Constraints: value must be a string [Default: None]
-o, --overwrite
flag to overwrite it if target file exists. [Default: False]
pass the downloaded files to datalad add-archive-content --delete. [Default: False]
by default all modifications to a dataset are immediately saved. Giving this option will disable this behavior. [Default: True]
-m MESSAGE, --message MESSAGE
a description of the state or the changes made to a dataset. Constraints: value must be a string [Default: None]


datalad is developed by The DataLad Team and Contributors <>.