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.

Quickstart

Getting Imgur API credentials

Go to https://api.imgur.com/oauth2/addclient 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):

[imgur]
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 http://i.imgur.com/6WsQPpw.gif

If you want your images to appear in your account, you additionally need to get a refresh token. See the Imgur API <https://apidocs.imgur.com/#authorization-and-oauth> for information on how to obtain this. Then, add a refresh_token line in your config file:

[imgur]
id = 9354da9ecdcfae3
secret = 8387eca75687ecad9876ead47786edac0875dc0d
refresh_token = 9812398ab1b2cc98de9fa982bacd31cb312c6194

Project details


Download files

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

Source Distribution

imgur-uploader-0.3.0.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

imgur_uploader-0.3.0-py2.py3-none-any.whl (3.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file imgur-uploader-0.3.0.tar.gz.

File metadata

  • Download URL: imgur-uploader-0.3.0.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.3

File hashes

Hashes for imgur-uploader-0.3.0.tar.gz
Algorithm Hash digest
SHA256 8dc20a86699e089c774c0191f15616f8631f0ace5f2c8a6beb928e2892a51cca
MD5 f8c0b2e8ce50d9376954bd067dc0b54f
BLAKE2b-256 78dedd747677175223dee35a65b14a8a5d160032d55d3c2903ac1def204b4c55

See more details on using hashes here.

File details

Details for the file imgur_uploader-0.3.0-py2.py3-none-any.whl.

File metadata

  • Download URL: imgur_uploader-0.3.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 3.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.3

File hashes

Hashes for imgur_uploader-0.3.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 fc5289e92007b297464da0c86fea6f12f9ca849d4b0e944b76762dd353f109a1
MD5 425ad0c2784126c12ca1dc5862a7e45f
BLAKE2b-256 7d8953afedf50535642ca2cc768121c8a820d2e16b3fb3dedae92dc0f5d89ee0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page