Welcome folks today in this post we will be downloading imgur images using imgur api in python using imgur-downloader library. All the full source code of the application is shown below.

Get Started

In order to get started you need to install the following library using pip command as shown below

pip install imgur-downloader

After installing this library make an app.py file and copy paste the following code

app.py

ImgurDownloader(
    'http://i.imgur.com/removed.png', delete_dne=True, debug=True
).save_images()

• Downloads imgur links with .gifv extension as a mp4 file

ImgurDownloader('http://i.imgur.com/A61SaA1.gifv').save_images()

• save_images & direct_download methods now return tuple of two integers. The first integer represent successful downloads and the second represent skipped download (either failed or Imgur DNE detected). For example the value on the the last line of the output is what’s returned from save_images method:

# Code ran (url is an imgur Album with 5 images):
print(
    imguralbum.ImgurDownloader(
        url, dir1, file_name=rand_name, debug=False
    ).save_images()
)
# output: (5, 0)

Init function parameter changes

• Second optional parameter, dir_download=os.getcwd(), which allows for specific directory to download to (not adapted for cli), e.g.:

ImgurDownloader('http://imgur.com/SnkkAVU', '/home/user/Downloads/')

• Third optional parameter, file_name=”, which allows user to specify name of file if input is single image or folder if input is album. Note this takes priority over the imgur key and the album webpage title e.g.:

ImgurDownloader(
    'http://imgur.com/SnkkAVU', '/home/user/Downloads/', 'my-img')

Command Line Usage

$ imgur_downloader [album URL] [folder to save to]

Download all images from an album into the folder /Users/alex/images/downloaded

$ imgur_downloader http://imgur.com/a/uOOju /Users/alex/images/downloaded

Downloads all images and puts them into an album in the current directory called “uOOju”

$ imgur_downloader http://imgur.com/a/uOOju