Skip to main content

A simple command line client for uploading files to Imgur.

Project description

A simple command line client for uploading files to Imgur.

Created for my PyCon US 2015 Docker tutorial so that students using my cloud servers can see the gifs they create at the end of exercise 1.

This tool is open source under the MIT License.


Getting Imgur API credentials

Go to and register a new Imgur API client. You will need an Imgur account to do this.

You can put it any valid URL for the callback URL - we won’t be using it.

Installing imgur-uploader

Installing imgur-uploader is easy. It runs on versions of Python >=2.7 or >=3.3.

If you just want to use imgur-uploader, you can just pip install imgur-uploader.

If you want to tweak or enhance imgur-uploader, follow these instructions:

  1. Clone this repository
  2. Install the tool with pip install -e .

Using imgur-uploader

First, create a file called ~/.config/imgur_uploader/uploader.cfg, with the following contents (substitute your credentials):

id = 9354da9ecdcfae3
secret = 8387eca75687ecad9876ead47786edac0875dc0d

Otherwise, set the IMGUR_API_ID and IMGUR_API_SECRET environment variables in your terminal session, using your client’s credentials.

Upload an image by running imgur-uploader path/to/my.gif

The tool will return a shortened link to your uploaded gif upon completion:

Uploading file my.gif
File uploaded - see your gif at

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
imgur_uploader-0.2.1-py2.py3-none-any.whl (5.1 kB) Copy SHA256 hash SHA256 Wheel 2.7 Apr 6, 2017
imgur-uploader-0.2.1.tar.gz (3.6 kB) Copy SHA256 hash SHA256 Source None Apr 6, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page