Display images in the terminal
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
.editorconfig Init May 8, 2018
.gitattributes Init May 8, 2018
.gitignore Init May 8, 2018
.npmrc Init May 8, 2018
.travis.yml Init May 8, 2018
example.js Init May 8, 2018
fixture.jpg Init May 8, 2018
index.js Use my fork of `jimp` May 9, 2018
license Init May 8, 2018
package.json 0.1.1 May 9, 2018
readme.md Add tip to readme on how to display a remote image May 16, 2018
screenshot-iterm.jpg Init May 8, 2018
screenshot.png Init May 8, 2018
test.js Init May 8, 2018

readme.md

terminal-image Build Status

Display images in the terminal

Works in any terminal that supports colors.

In iTerm, the image will be displayed in full resolution, since iTerm has special image support.

Install

$ npm install terminal-image

Usage

const terminalImage = require('terminal-image');

(async () => {
	console.log(await terminalImage.file('unicorn.jpg'));
})();

API

Supports PNG and JPEG images.

terminalImage.buffer(imageBuffer)

Returns a Promise<string> with the ansi escape codes to display the image.

imageBuffer

Type: Buffer

Buffer with the image.

terminalImage.file(filePath)

Returns a Promise<string> with the ansi escape codes to display the image.

filePath

Type: string

File path to the image.

Tip

Display a remote image

const terminalImage = require('terminal-image');
const got = require('got');

(async () => {
	const {body} = await got('sindresorhus.com/unicorn', {encoding: null});
	console.log(await terminalImage.buffer(body));
})();

Related

License

MIT © Sindre Sorhus