Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/qeesung/image2ascii
:foggy: Convert image to ASCII
https://github.com/qeesung/image2ascii
ascii-art ascii-image convert-images golang image image2ascii
Last synced: 2 days ago
JSON representation
:foggy: Convert image to ASCII
- Host: GitHub
- URL: https://github.com/qeesung/image2ascii
- Owner: qeesung
- License: mit
- Created: 2018-10-20T05:06:25.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-08-29T04:21:10.000Z (over 2 years ago)
- Last Synced: 2024-12-12T23:07:21.559Z (9 days ago)
- Topics: ascii-art, ascii-image, convert-images, golang, image, image2ascii
- Language: Go
- Homepage:
- Size: 34.2 MB
- Stars: 892
- Watchers: 11
- Forks: 78
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - image2ascii - Convert image to ASCII. (Images / Search and Analytic Databases)
- awesome-go - image2ascii - Convert image to ASCII - ★ 199 (Images)
- awesome-go-extra - image2ascii - 10-20T05:06:25Z|2022-07-18T02:27:18Z| (Images / Advanced Console UIs)
README
# :foggy: Image2ascii
[](https://travis-ci.org/qeesung/image2ascii)
[](https://coveralls.io/github/qeesung/image2ascii?branch=master)
[](https://app.codacy.com/app/qeesung/image2ascii?utm_source=github.com&utm_medium=referral&utm_content=qeesung/image2ascii&utm_campaign=Badge_Grade_Dashboard)
[](https://goreportcard.com/report/github.com/qeesung/image2ascii)
[](https://godoc.org/github.com/qeesung/image2ascii)
[](https://opensource.org/licenses/MIT)
[](https://github.com/sindresorhus/awesome)
Image2ASCII is a library that converts images into ASCII images and provides command-line tools for easy use.
## Installation
```bash
go install github.com/qeesung/image2ascii@latest
```
## CLI usage
```bash
image2ascii version: image2ascii/1.0.0
>> HomePage: https://github.com/qeesung/image2ascii
>> Issue : https://github.com/qeesung/image2ascii/issues
>> Author : qeesung
Usage: image2ascii [-s] -f -r -w -g
Options:
-c Colored the ascii when output to the terminal (default true)
-f string
Image filename to be convert (default "docs/images/lufei.jpg")
-g int
Expected image height, -1 for image default height (default -1)
-i Reversed the ascii when output to the terminal
-r float
Ratio to scale the image, ignored when use -w or -g (default 1)
-s Fit the terminal screen, ignored when use -w, -g, -r (default true)
-t Stretch the picture to overspread the screen
-w int
Expected image width, -1 for image default width (default -1)
```
convert the image fit the screen(default is true)
```bash
image2ascii -f docs/images/pikaqiu2.jpg
```
convert the image to ascii image with fixed width and height
```bash
# width: 100
# height: 30
image2ascii -f docs/images/baozou.jpg -w 100 -g 30
```
convert the image to ascii image by ratio
```bash
# ratio: 0.3
# width: imageWidth * 0.3
# height: imageHeight * 0.3
image2ascii -f docs/images/pikaqiu.jpg -r 0.3
```
convert the image to stretch the screen
```bash
image2ascii -f docs/images/long.jpg -t
```
convert the image without the color
```bash
image2ascii -f docs/images/lufei.jpg -s -c=false
```
convert the image disable fit the screen
```bash
image2ascii -f docs/images/lufei.jpg -s=false
```
convert the image reverse the chars
```bash
image2ascii -f docs/images/lufei.jpg -i
```
## Library usage
```golang
package main
import (
"fmt"
"github.com/qeesung/image2ascii/convert"
_ "image/jpeg"
_ "image/png"
)
func main() {
// Create convert options
convertOptions := convert.DefaultOptions
convertOptions.FixedWidth = 100
convertOptions.FixedHeight = 40
// Create the image converter
converter := convert.NewImageConverter()
fmt.Print(converter.ImageFile2ASCIIString(imageFilename, &convertOptions))
}
```
convert options
```golang
type Options struct {
Ratio float64 // convert ratio
FixedWidth int // convert the image width fixed width
FixedHeight int // convert the image width fixed height
FitScreen bool // only work on terminal, fit the terminal height or width
StretchedScreen bool // only work on terminal, stretch the width and heigh to overspread the terminal screen
Colored bool // only work on terminal, output ascii with color
Reversed bool // if reverse the ascii pixels
}
```
supported convert function
```golang
type Converter interface {
// convert a image object to ascii matrix
Image2ASCIIMatrix(image image.Image, imageConvertOptions *Options) []string
// convert a image object to ascii matrix and then join the matrix to a string
Image2ASCIIString(image image.Image, options *Options) string
// convert a image object by input a string to ascii matrix
ImageFile2ASCIIMatrix(imageFilename string, option *Options) []string
// convert a image object by input a string to ascii matrix then join the matrix to a string
ImageFile2ASCIIString(imageFilename string, option *Options) string
}
```
## Sample outputs
| Raw Image | ASCII Image |
|:---------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------:|
|  |  |
|  |  |
|  |  |
|  |  |
|  |  |
|  |  |
## License
This project is under the MIT License. See the [LICENSE](https://github.com/qeesung/image2ascii/blob/master/LICENSE) file for the full license text.