• This repository has been archived on 30/Dec/2021
  • Stars
    star
    176
  • Rank 216,987 (Top 5 %)
  • Language
    JavaScript
  • Created over 13 years ago
  • Updated almost 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Upload images to imgur.com

🚨 This repo is no longer maintained. @KenEucker has graciously offered to continue development on his fork at https://github.com/KenEucker/imgur

➡️ It will continue to be published to npm under the imgur package name.


Command-line Usage

Installation

npm install imgur -g

Usage

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.

Module Usage

Installation

npm install imgur

Usage

Requiring the module:

const imgur = require('imgur');

Dealing with client IDs:

// Change this cliend id to your own.
const clientId = 'aCs53GSs4tga0ikp';

// Setting
imgur.setClientId(clientId);

// Getting
imgur.getClientId();

// You can specify path or keep it null. Defaults to ~/.imgur
const path = null;

// Saving to disk. Returns a promise.
imgur
  .saveClientId(clientId, path)
  .then(() => {
    console.log('Saved.');
  })
  .catch((err) => {
    console.log(err.message);
  });

// Loading from disk
imgur.loadClientId(path).then(imgur.setClientId);

Dealing with API URL:

In order to change the API Url say Mashape URL, use setAPIUrl(MashapeURL)

//Setting
imgur.setAPIUrl('https://api.imgur.com/3/');

//If setAPIUrl() is not called, API URL is read from process.env.IMGUR_API_URL

//Getting
imgur.getAPIUrl();

Dealing with Mashape Key

Requests to the Mashape URL expects a X-Mashape-Key: MashapeKey header. Set Mashape Key by using setMashapeKey(MashapeKey) method. Note: Defaults to process.env.IMGUR_MASHAPE_KEY

//Setting
imgur.setMashapeKey(https://imgur-apiv3.p.mashape.com/);

//Getting
imgur.getMashapeKey()

Dealing with credentials:

For when you want to upload images to an account.

// Setting
imgur.setCredentials('[email protected]', 'password', 'aCs53GSs4tga0ikp');

Uploading files; globbing supported:

// A single image
imgur
  .uploadFile('/home/kai/kittens.png')
  .then((json) => {
    console.log(json.link);
  })
  .catch((err) => {
    console.error(err.message);
  });

// All jpegs in a specific folder
// to an album you own
const albumId = 'F8KTV';
imgur
  .uploadFile('/home/kai/*.jpg', albumId)
  .then((json) => {
    console.log(json.link);
  })
  .catch((err) => {
    console.error(err.message);
  });

// Multiple image types from home folder
imgur
  .uploadFile('~/*.(jpg|png|gif)')
  .then((json) => {
    console.log(json.link);
  })
  .catch((err) => {
    console.error(err.message);
  });

Searching images within the gallery:

The first argument should be a query to search and it's the only required option. The second argument is optional params to sort your query by.

  • sort - Accepts 'time', 'viral', or 'top' as a value. Defaults to top.
  • dateRange - Accepts 'day', 'week', 'month', 'year', or 'all' as a value. Defaults to all.
  • page - Accepts an integer (e.g. 1, 2, 3, 4) as a value. Defaults to 1.

Search returns an object with the query response as an array of objects that include an image's ID, title, description, views, etc.. and the params you sent with the request.

const query = 'cats';
const optionalParams = { sort: 'top', dateRange: 'week', page: 1 };
imgur
  .search(query, optionalParams)
  .then((json) => {
    console.log(json);
  })
  .catch((err) => {
    console.error(err);
  });

Fetching image data:

const kittenPic = 'mbgq7nd';
imgur
  .getInfo(kittenPic)
  .then((json) => {
    console.log(json);
  })
  .catch((err) => {
    console.error(err.message);
  });

Fetching album data:

const kittenAlbum = 'mbgq7nd';
imgur
  .getAlbumInfo(kittenAlbum)
  .then((json) => {
    console.log(json);
  })
  .catch((err) => {
    console.error(err.message);
  });

Creating an album:

imgur
  .createAlbum()
  .then((json) => {
    console.log(json);
  })
  .catch((err) => {
    console.error(err.message);
  });

Uploading URLs of images hosted elsewhere:

// Include http(s) when specifying URLs
imgur
  .uploadUrl('https://octodex.github.com/images/topguntocat.png')
  .then((json) => {
    console.log(json.link);
  })
  .catch((err) => {
    console.error(err.message);
  });

Uploading Base-64 encoded images:

const imgurFavicon =
  'iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAmUlEQVQ4je2TsQ3CMBBFnxMa08WR2IQKJskIUNwMZAcYwWIQMs65JCUpEEIYW4pJy6v+6e6+/hVnnGsAzsCBMi7AsbbW/rIMsAU2xrnmkeruuzW7zgIw+JGbv6fGQpWzfy3HOsJlDQY/AlCv3jpF9oS5ZBOICKoB1YCIlCdQDR9127qyBHP5Gyw3CBXPr/qi709JHXE1S995AsqoJu8x78GsAAAAAElFTkSuQmCC';

imgur
  .uploadBase64(imgurFavicon)
  .then((json) => {
    console.log(json.link);
  })
  .catch((err) => {
    console.error(err.message);
  });

Uploading multiple images:

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((images) => {
    console.log(images);
  })
  .catch((err) => {
    console.error(err.message);
  });

Uploading an album:

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((album) => {
    console.log(album.data, album.images);
  })
  .catch((err) => {
    console.error(err.message);
  });

Deleting anonymous uploads

Delete an image based on the deletehash(generated during the image upload)

imgur
  .deleteImage(deletehash)
  .then((status) => {
    console.log(status);
  })
  .catch((err) => {
    console.error(err.message);
  });

License

MIT

More Repositories

1

isMobile

A simple JS library that detects mobile devices.
TypeScript
2,356
star
2

csgo

A containerized dedicated server for Counter-Strike: Global Offensive
Shell
242
star
3

demoinfogo-linux

Linux, OSX port of Valve's demoinfogo tool
C++
152
star
4

node-googl

A Node.js url shortener and expander powered by Google
JavaScript
97
star
5

php-bbcode

A naive attempt at a BBCode "parser" written in PHP. It uses regex and thus fails at complex, nested tags.
PHP
22
star
6

steamcmd

SteamCMD docker container
Shell
13
star
7

jquery-bbcode

Easily transform textareas into BBCode WYSIWYG editors.
JavaScript
9
star
8

bbcode

A naive attempt at a BBCode "parser" written in JavaScript. It uses regex and thus fails at complex, nested tags.
JavaScript
5
star
9

zepto-fluid-carousel

A Zepto plug-in to create fluid, responsive carousels
JavaScript
4
star
10

vim-config

My personal Vim setup
Vim Script
3
star
11

input-validator

Input Validator is a javascript library that performs the most common types of validation on the web.
JavaScript
2
star
12

go-sitemap

A Go package for consuming sitemaps
Go
2
star
13

minicat

Automate your JS/CSS minification and concatenation process -- conditionally.
PHP
1
star
14

go-prism

Capture CS:GO gameplay data for analysis
C++
1
star
15

ballin

An HTML5 canvas game and project for collabraCode();
JavaScript
1
star
16

mms_sample_ext

Sample Metamod:Source Plugin for CSGO that also implements a SourceMod Extension
C++
1
star
17

csgo-base

Base docker image for CSGO dedicated servers
1
star
18

tsquery

tsQuery is a JavaScript library that wraps around the TeamSite FormAPI to simplify item addressing, and event handling for rapid data capture form development.
JavaScript
1
star
19

show-next-version

JavaScript
1
star