Node Image Downloader

A Node module for downloading image to disk from a given URL

Install

1npm install --save image-downloader

Options

• url (required) - the image URL to download
• dest (required) - the image destination. Can be a directory or a filename. If a directory is given, ID will automatically extract the image filename from options.url (see usage bellow)
• extractFilename - boolean indicating whether the image filename will be automatically extracted from options.url or not. Set to false to have options.dest without a file extension for example. (default: true)
• headers - HTTP headers (default: {})
• timeout - milliseconds before a request times out
• maxRedirects - the maximum number of allowed redirects; if exceeded, an error will be emitted. (default: 21)

For advanced options, see Node.js http.request()'s options documentation

Usage

Download to a directory and save with the original filename

1const download = require('image-downloader');
2
3const options = {
4  url: 'http://someurl.com/image.jpg',
5  dest: '/path/to/dest',               // will be saved to /path/to/dest/image.jpg
6};
7
8download.image(options)
9  .then(({ filename }) => {
10    console.log('Saved to', filename); // saved to /path/to/dest/image.jpg
11  })
12  .catch((err) => console.error(err));

Download to a directory and save with an another filename

1const download = require('image-downloader');
2
3options = {
4  url: 'http://someurl.com/image2.jpg',
5  dest: '/path/to/dest/photo.jpg',     // will be saved to /path/to/dest/photo.jpg
6};
7
8download.image(options)
9  .then(({ filename }) => {
10    console.log('Saved to', filename); // saved to /path/to/dest/photo.jpg
11  })
12  .catch((err) => console.error(err));

Download with another filename without extension

1const download = require('image-downloader');
2
3options = {
4  url: 'http://someurl.com/image3.jpg',
5  dest: '/path/to/dest/photo',         // will be saved to /path/to/dest/photo
6  extractFilename: false,
7};
8
9download.image(options)
10  .then(({ filename }) => {
11    console.log('Saved to', filename), // saved to /path/to/dest/photo
12  })
13  .catch((err) => console.error(err));

Development Setup

1. Install Nix Package Manager

2. Install direnv with your OS package manager

3. Hook it direnv into your shell

4. At the top-level of your project run:

   1direnv allow

   The next time your launch your terminal and enter the top-level of your project, direnv will check for changes.

Contribute

Please follow CONTRIBUTING.md.

License

Under the MIT license. See LICENSE file for more details.