zenodo-get 3.0.0

Zenodo_get - a downloader for Zenodo records

zenodo_get: a downloader for Zenodo records

A Python tool for downloading files from Zenodo records. Requires Python 3.10+.

Installation

The simplest way (no installation needed) is using uvx, a tool runner from uv:

uvx zenodo_get RECORD_ID_OR_DOI

Alternatively, install with pipx or pip:

pipx install zenodo-get
# or
pip install zenodo-get

Usage

uvx zenodo_get RECORD_ID_OR_DOI

Common Options

Option	Description
-o DIR	Output directory (created if needed)
-g PATTERN	Filter files by glob pattern (e.g., -g "*.pdf")
-m	Generate md5sums.txt for verification
-w FILE	Write URLs to file instead of downloading (-w - for stdout)
-e	Continue on error (skip failed files)
-n	Start fresh (don't resume previous download)
-v N	Verbosity level 0-4 (default: 2)

Retry Options

Option	Description
--max-http-retries N	HTTP retries with exponential backoff (default: 5)
--backoff-factor N	Backoff multiplier in seconds (default: 0.5)
-R N	Application-level retries for checksum failures (default: 1)
-p N	Pause between retries in seconds (default: 3)
-t N	Connection timeout in seconds (default: 25)

Examples

# Download all files from a record
uvx zenodo_get 1234567

# Download only PDFs to a specific directory
uvx zenodo_get 1234567 -g "*.pdf" -o ./downloads

# Generate URL list for external download manager
uvx zenodo_get 1234567 -w urls.txt

# Use DOI instead of record ID
uvx zenodo_get -d 10.5281/zenodo.1234567

Exit Codes

• 0: All files downloaded successfully
• Non-zero: Error occurred (checksum mismatch, download failure, timeout, etc.)

Citation

If you use this tool in academic work:

uvx zenodo_get --cite