Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Earth photos downloader

Project Description

Python script downloading Earth photos taken by Himawari-8 satelite. Website:

Inspired by this reddit thread:

Especially by european_impostor’s Powershell script:

And most of all, its Python implementations: by celoyd: and by willwhitney:

This script is Windows specific. Python 3.4+ only compatible. Tested on Windows 7, Python 3.4.4 and Python 3.5.1


To install, download source or clone it with git

git clone

Change to eartpic/ directory and run

cd earthpic/ python install

This should install all dependencies (Pillow, requests, pytz and click). If you have problem with installing Pillow package during python install and/or with pip install pillow, you can download wheel file from and install it with command pip install <path/to/whl_file>.


Call earthpic –help from command line to view this help:

usage: earthpic [-h] [-d DATE] [-t TIME] [-s SCALE] [-w] [-v] [-l N_PHOTOS]
[-b] [-p PATH]

Download satelite Earth photo(s)

optional arguments:
-h, --help show this help message and exit
-d DATE, --date DATE
 date of the photo [format: YYYY-MM-DD] (default: 2016-02-09)
-t TIME, --time TIME
 time of the photo [fotmat: hh:mm] (default: 00:05)
-s SCALE, --scale SCALE
 scale of the photo, choices: 1, 2, 4, 8, 16 or 20 (default: 2)
-w, --wallpaper
 set downloaded image as desktop wallpaper (default: False)
-v, --verbose increase output verbosity (default: False)
-l N_PHOTOS, --last N_PHOTOS
 process N photos to given date (default: 1)
-b, --batch run batch downloading photos. To stop, press ctrl+c. (default: False)
-p PATH, --path PATH
 path where images will be saved (default: images)

So, for instance calling just earthpic without arguments will download latest satelite photo (current time minus ~20 minutes - delay of original service) and save it to ./images/ directory, without setting it as desktop wallpaper.

To specify date and time of picture write: earthpic -d 2016-02-01 -t 02:50. All dates/times are considered as in UTC timezone.

To set downloaded picture as wallpaper, write: earthpic -w -d 2016-02-01 -t 02:50.

To change scale (size, quality of wallpaper): earthpic -w -s 4 -d 2016-02-01 -t 02:50.

Release History

Release History

This version
History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date (8.8 kB) Copy SHA256 Checksum SHA256 Source Feb 9, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting