Skip to main content

Downloader for public and proprietary ESO archive data

Project description

A python package which provides an easy way to download data for a given ESO observational program ID.

Getting started

To run eso-downloader, you will need to add your ESO portal username and password to the system keyring (the secure place to store login details), and create a config file detailing where to put the data.

Storing passwords/credentials

This package uses the keyring package ( to store passwords and other credentials. If keyring is unable to find a place to store and read secrets from, see how to configure keyring at

To add your password to the keyring on your system, run:

keyring set eso-downloader <your ESO portal username>

and enter your ESO portal password (in the future, we hope that there will be long-lasting tokens so that we do not need to store the portal password directly). To confirm that the password is saved, run:

keyring get eso-downloader <your ESO portal username>

Creating a config file

An initial starter config file (in .ini format) would be:

username = <your ESO portal username>
base_dir = <where you want to save the downloaded data>

If you need to use different paths or different usernames for particular programs, you can add sections for specific programs e.g.:

username = <some other username>


base_dir = <some other directory>

Running the script

The script will use the config file and the list of program IDs passed to it to download in parallel all the files needed for the reduction of the found science files, skipping those already downloaded (see algorithm below).


eso-downloader --config <path_to_config_file> <program_id> <program_id> ...

will start the download. If sent SIGTERM, the script will stop requesting new files, and finish downloading the files it was working on.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eso-downloader-0.1.tar.gz (50.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page