https://github.com/fennifith/Asciimg
A command line tool to display images in ASCII.
https://github.com/fennifith/Asciimg
cli nodejs
Last synced: 8 months ago
JSON representation
A command line tool to display images in ASCII.
- Host: GitHub
- URL: https://github.com/fennifith/Asciimg
- Owner: fennifith
- License: apache-2.0
- Created: 2018-04-14T00:23:58.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-10-18T18:46:53.000Z (about 7 years ago)
- Last Synced: 2025-02-12T11:06:53.215Z (9 months ago)
- Topics: cli, nodejs
- Language: JavaScript
- Homepage: https://npmjs.com/package/asciimg
- Size: 1.99 MB
- Stars: 14
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Asciimg (pronounced _ask-ee-em_) is a command line tool that displays images in ASCII.
## Installation
Assuming that you have already installed [npm](https://www.npmjs.com/), in the command line, type either one of the following:
### NPM
```bash
npm install -g asciimg
```
### From Source
```bash
git clone https://github.com/TheAndroidMaster/Asciimg
cd Asciimg
npm install
```
## Usage
```
asciimg
```
Or, to change the dimensions:
```
asciimg -h [height] -w [width]
```
If either the height or width is not specified, asciimg will pick the value that maintains the correct aspect ratio.
If your command line supports rgb color values:
```
asciimg --usergb
```
## Sample Images
The 'test.png' included in the repository is over 4000000 pixels in size, so it will take a while for the tool to convert it. Here are screenshots of the result of that and a few other images:
### My Profile Picture

### A Fidget Spinner
Why not.

### The Top Half of a Samsung Galaxy S2
