earthpic 0.3

Earth photos downloader

Python script downloading Earth photos taken by Himawari-8 satelite. Website: http://himawari8.nict.go.jp/

Inspired by this reddit thread: https://www.reddit.com/r/programming/comments/441do9/i_made_a_windows_powershell_script_that_puts_a/

Especially by european_impostor’s Powershell script: https://gist.github.com/MichaelPote/92fa6e65eacf26219022

And most of all, its Python implementations: by celoyd: https://gist.github.com/celoyd/39c53f824daef7d363db and by willwhitney: https://gist.github.com/willwhitney/e9e2c42885385c51843e

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

Installation

To install, download source or clone it with git

git clone https://github.com/pywkm/earthpic.git

Change to eartpic/ directory and run setup.py

cd earthpic/ python setup.py install

This should install all dependencies (Pillow, requests, pytz and click). If you have problem with installing Pillow package during python setup.py install and/or with pip install pillow, you can download wheel file from http://www.lfd.uci.edu/~gohlke/pythonlibs/ and install it with command pip install <path/to/whl_file>.

Usage

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.