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:
Clone this repository
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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8dc20a86699e089c774c0191f15616f8631f0ace5f2c8a6beb928e2892a51cca |
|
MD5 | f8c0b2e8ce50d9376954bd067dc0b54f |
|
BLAKE2b-256 | 78dedd747677175223dee35a65b14a8a5d160032d55d3c2903ac1def204b4c55 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | fc5289e92007b297464da0c86fea6f12f9ca849d4b0e944b76762dd353f109a1 |
|
MD5 | 425ad0c2784126c12ca1dc5862a7e45f |
|
BLAKE2b-256 | 7d8953afedf50535642ca2cc768121c8a820d2e16b3fb3dedae92dc0f5d89ee0 |