imgur

Upload images to imgur.com

npm install imgur -g

Pass binary image files, urls, and/or base64-encoded image strings as arguments. Globbing is supported.

Upload a single image:

imgur cat.png

Upload multiple images (globbing supported):

imgur cat.png cats.gif cats23.jpg
 
imgur ~/*.(jpg|png|gif)
 
imgur ~/Pictures/kittens/*.jpg ~/gifs/sfw/*.gif

Upload an image from another place on the web. Be sure to include http(s):

imgur --url https://octodex.github.com/images/topguntocat.png

Upload a Base-64 encoded image:

imgur --base64 iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAmUlEQVQ4je2TsQ3CMBBFnxMa08WR2IQKJskIUNwMZAcYwWIQMs65JCUpEEIYW4pJy6v+6e6+/hVnnGsAzsCBMi7AsbbW/rIMsAU2xrnmkeruuzW7zgIw+JGbv6fGQpWzfy3HOsJlDQY/AlCv3jpF9oS5ZBOICKoB1YCIlCdQDR9127qyBHP5Gyw3CBXPr/qi709JHXE1S995AsqoJu8x78GsAAAAAElFTkSuQmCC

Saving a client id for subsequent use:

imgur --save f9ae01148b53261

Display saved client id:

imgur --show

Remove previously saved client id:

imgur --clear

Use a specific client id one time only (overrides saved id):

imgur --client-id f9ae01148b53261 --file ~/me.jpg
 
# Short-hand
imgur -c f9ae01148b53261 -f ~/me.jpg

Add images to an existing album by specifying an album ID:

imgur --album-id F8KTV --file ~/me.jpg
 
# Short-hand
imgur -a F8KTV ~/me.jpg

You must own the album. If it's an anonymous album you need to use the deletehash in place of the album ID.

npm install imgur
var imgur = require('imgur');
// Setting 
imgur.setClientId('aCs53GSs4tga0ikp');
 
// Getting 
imgur.getClientId();
 
// Saving to disk. Returns a promise. 
// NOTE: path is optional. Defaults to ~/.imgur 
imgur.saveClientId(path)
    .then(function () {
        console.log('Saved.');
    })
    .catch(function (err) {
        console.log(err.message);
    });
 
 
// Loading from disk 
// NOTE: path is optional. Defaults to ~/.imgur 
imgur.loadClientId(path)
    .then(imgur.setClientId);

For when you want to upload images to an account.

// Setting 
imgur.setCredentials('email@domain.com', 'password', 'aCs53GSs4tga0ikp');
 
// A single image 
imgur.uploadFile('/home/kai/kittens.png')
    .then(function (json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });
 
// All jpegs in a specific folder 
// to an album you own 
var albumId = 'F8KTV';
imgur.uploadFile('/home/kai/*.jpg', albumId)
    .then(function (json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });
 
// Multiple image types from home folder 
imgur.uploadFile('~/*.(jpg|png|gif)')
    .then(function(json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });
var kittenPic = 'mbgq7nd';
imgur.getInfo(kittenPic)
    .then(function(json) {
        console.log(json);
    })
    .catch(function (err) {
        console.error(err.message);
    });
 
var kittenAlbum = 'mbgq7nd';
imgur.getAlbumInfo(kittenAlbum)
    .then(function(json) {
        console.log(json);
    })
    .catch(function (err) {
        console.error(err.message);
    });
 
imgur.createAlbum()
    .then(function(json) {
        console.log(json);
    })
    .catch(function (err) {
        console.error(err.message);
    });
 
// Include http(s) when specifying URLs 
imgur.uploadUrl('https://octodex.github.com/images/topguntocat.png')
    .then(function (json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });
var imgurFavicon = 'iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAmUlEQVQ4je2TsQ3CMBBFnxMa08WR2IQKJskIUNwMZAcYwWIQMs65JCUpEEIYW4pJy6v+6e6+/hVnnGsAzsCBMi7AsbbW/rIMsAU2xrnmkeruuzW7zgIw+JGbv6fGQpWzfy3HOsJlDQY/AlCv3jpF9oS5ZBOICKoB1YCIlCdQDR9127qyBHP5Gyw3CBXPr/qi709JHXE1S995AsqoJu8x78GsAAAAAElFTkSuQmCC';
 
imgur.uploadBase64(imgurFavicon)
    .then(function (json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Upload an array of images of the desired upload type ('File', 'Url', 'Base64').

Returns an array of images (imgur image data).

imgur.uploadImages(images, uploadType /*, albumId */)
    .then(function(images) {
        console.log(images);
    })
    .catch(function (err) {
        console.error(err.message);
    });
 

Create a new album and upload an array of images of the desired upload type to it ('File', 'Url', 'Base64').

Returns an object with the album data and an array of images { data: {...}, images: [{...}, ...]}.

The third parameter is an optional fail safe, meaning if the array of images is empty or invalid, it will not fail, but returns an object with empty data and empty images.

imgur.uploadAlbum(images, uploadType /*, failSafe */)
    .then(function(album) {
        console.log(album.data, album.images);
    })
    .catch(function (err) {
        console.error(err.message);
    });