No description, website, or topics provided.
Clone or download


Automatically downloads all completed espa scenes. Each scene is downloaded to the --target_directory and organized by order.

Support Information

This project is unsupported software provided by the U.S. Geological Survey (USGS) Earth Resources Observation and Science (EROS) Land Satellite Data Systems (LSDS) Project. For questions regarding products produced by this source code, please contact us at


This software is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The software has not received final approval by the U.S. Geological Survey (USGS). No warranty, expressed or implied, is made by the USGS or the U.S. Government as to the functionality of the software and related material nor shall the fact of release constitute any such warranty. The software is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the software.



  • Python Version >= 2.7.9 (required for HTTPS)
  • Note:
    • These were tested with both python 2.7.14 and 3.6.4.
    • For Python Version >= 2.6.0, the requests library must be installed.


  • Install with pip automatically:
pip install git+ -h
  • Clone this repository:
git clone bulk-downloader
cd bulk-downloader
python ./ -h


Runtime options

Argument Description
-e or --email The email address used to submit the order
-o or --order The order you wish to download. (ALL or ESPA order-id)
-d or --target_directory The local directory to store downloaded scenes
-u or --username Your ERS username
-p or --password Your ERS password
-c or --checksum Download checksum files
-r or --retry Retry instead of skipping failed files
-n or --no-order-directories Store all files in one directory

Linux/Mac Example: python ./ -d /some/directory/with/free/space -u your_username

Windows Example: C:\python27\python -d C:\some\directory\with\free\space -u your_username


Retrieves all completed scenes for the user/order and places them into the target directory. Scenes are organized by order.

It is safe to cancel and restart the client, as it will only download scenes one time (per directory)

If you intend to automate execution of this script, please take care to ensure only 1 instance runs at a time. Also please do not schedule execution more frequently than once per hour.