datalad download-url


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


Download content

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 <>.