Instructions for how to use the download access script provided by Earthdata Search, allowing which allows users to easily download large quantities numbers of files easily.
IMPORTANT: The download access script works best on Mac, Linux and Linux Windows systems. Windows systems users will require need to a program that emulates a Unix Linux command line, such as Cyqwin Cygwin. Cygwin is free, and can be download here: https://www.cygwin.com/install.html
After downloading the script, open a terminal window Terminal (Mac or Linux) or Cygwin (Windows) and navigate to the folder that contains your script
Info |
---|
The files downloaded by this script will be downloaded to the folder that your script is in. If you want your files downloaded to a specific folder, please make sure to move the script to that folder before executing the script. |
Next, run the following command to make the script executable:
Code Block |
---|
chmod 777 download.sh |
Now that your script is executable, run the script using the following command. (Note: the leading period and forward slash is required.)
Code Block |
---|
./download.sh |
The script will ask for your Earthdata Login credentials.
Info |
---|
Note: your Earthdata userid Login and password are case-sensitive, so be sure CAPSLOCK is off. |
When asked for your Username, please enter your Earthdata useridLogin.
When asked for your Password, please enter your Earthdata Login password. Note that when When entering your password, you cannot see your password as you type. This is a Unix convention for security, but it can be confusing.
After entering your password, be sure to hit the RETURN key.
Info | ||
---|---|---|
| ||
The download access script works on Windows systems with a program that emulates a Linux command line, such as Cygwin. If you are a Windows user and you do not have Cygwin, you can download it here: https://www.cygwin.com/install.html |
Info | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
To download multiple files, a simple alternative to the script A quick workaround is to use the wget command as follows:
where username myusername is your Earthdata useridusername, password mypassword is your Earthdata password, and url_list.txt is a text file with one granule download link per line.
To download a single file, you can use wget as follows:
where url is link for the file you want to download. Another alternative is to use DownloadThemAll!, an add-in for the Firefox browser. (TIP: By adding .txt to the end of the download script, you can use DownloadThemAll!'s "import from file" feature to download the links it contains.). DownloadThemAll! is not compatible with Firefox Quantum, so be sure to check your version of Firefox to verify compatibility. An alternative to DownloadThemAll! is "Chrono Download Manager," an extension for the Google Chrome browser that has many of the features of DownThemAll! for Firefox. |
Info | ||
---|---|---|
| ||
Connection failures like "Operation timed out" or "No route to host" are an indication that the data provider's server may be temporarily unavailable. To see a list of known data provider outages, click the alerts button (the little bell icon) in the upper right-hand corner of Earthdata Search. |
Info | |||||||
---|---|---|---|---|---|---|---|
| |||||||
When running the script, if you get the error
this means the curl command is not recognizing the option --netrc-file. The --netrc-file option was added in curl version 7.21.5. You can check your version of curl by running the following command:
If your version of curl is less than 7.21.5, you need to update curl. |
Info | ||
---|---|---|
| ||
|
Info | ||
---|---|---|
| ||
|
...