imgurdl/README.md

IMGUR Album Downloader

Downloads complete albums from IMGUR.com.

Help and Usage

Help

Calling imgurdl.py without any arguments:

$ python imgurdl.py
usage: imgurdl.py [-h] OUTPUT_DIR ALBUM_HASH
imgurdl.py: error: the following arguments are required: OUTPUT_DIR, ALBUM_HASH

Display the usage help for imgurdl.py with argument -h.

usage: imgurdl.py [-h] OUTPUT_DIR ALBUM_HASH

Imgur Album Downloader

positional arguments:
  OUTPUT_DIR  Download the album into OUTPUT_DIR
  ALBUM_HASH  The album hash identifier to download

optional arguments:
  -h, --help  show this help message and exit

The imgurdl.py will also accept an URL as ALBUM_HASH.

Usage

To download and save all images from album RwwP1gT in the directory album use:

$ python imgurdl.py album RwwP1gT
Download: 9X8BR6s.jpg 100% |#######################| Time:  0:00:00  25.4 MiB/s
Download: ZIt8BCG.jpg 100% |#######################| Time:  0:00:00   2.5 MiB/s
Download: aYClgll.jpg 100% |#######################| Time:  0:00:00   1.9 MiB/s
Download: pcoW5xj.jpg 100% |#######################| Time:  0:00:00   2.3 MiB/s
Download: Mn7e4eE.jpg 100% |#######################| Time:  0:00:00   1.7 MiB/s
Download: GUUUV2K.jpg 100% |#######################| Time:  0:00:00   1.3 MiB/s
...

The images are stored in the subdirectory album/RwwP1gT.

$ ls -l album/RwwP1gT/
total 1648
-rw-r--r-- 1 bernd users 128273 Apr 29 10:18 9X8BR6s.jpg
-rw-r--r-- 1 bernd users  56728 Apr 29 10:18 aYClgll.jpg
-rw-r--r-- 1 bernd users  37078 Apr 29 10:18 GUUUV2K.jpg
-rw-r--r-- 1 bernd users  75085 Apr 29 10:18 Mn7e4eE.jpg
-rw-r--r-- 1 bernd users 123245 Apr 29 10:18 pcoW5xj.jpg
-rw-r--r-- 1 bernd users 117705 Apr 29 10:18 ZIt8BCG.jpg
...