https://github.com/stephentth/imgcat

A simple command to render image to terminal. Written in Go.
https://github.com/stephentth/imgcat

cli golang image image-processing

Last synced: 10 months ago
JSON representation

A simple command to render image to terminal. Written in Go.

• Host: GitHub
• URL: https://github.com/stephentth/imgcat
• Owner: stephentth
• License: mit
• Created: 2019-03-25T07:54:37.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2019-03-27T14:10:24.000Z (about 7 years ago)
• Last Synced: 2025-05-31T10:53:10.659Z (about 1 year ago)
• Topics: cli, golang, image, image-processing
• Language: Go
• Homepage:
• Size: 318 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# imgcat

## Introduce

A simple utily to render an image to terminal. Support load image from local disk and from image url.

Features:

* Ouput image 2 pixel per glyph.

* Can fetch image from url.

* Auto analize your terminal size and scale output image base on it.

## Screenshots

    
Simple cat an image local

    

    
Simple cat an image remote

    


## Install

If you have go installed in your system.

```

go get -u github.com/stephentt-me/imgcat

```

Make sure `$GOPATH/bin` is in your `$PATH`.

Or [download binary here](https://github.com/stephentt-me/imgcat/releases) and put it into your `$PATH`.

## Usage

"Cat" image from file

```

imgcat foo.jpg

```

"Curl" image from url

```

imgcat 

```

## Development

To build from source, after clone this repo, run:

```

make build

```

Run unitest:

```

make test

```

## License

MIT