https://github.com/chunqiuyiyu/ervy

Bring charts to terminal.
https://github.com/chunqiuyiyu/ervy

ascii blog chart cli console data-visualization terminal

Last synced: 6 months ago
JSON representation

Bring charts to terminal.

• Host: GitHub
• URL: https://github.com/chunqiuyiyu/ervy
• Owner: chunqiuyiyu
• License: mit
• Created: 2018-10-20T07:47:06.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-08-27T11:51:00.000Z (about 2 years ago)
• Last Synced: 2025-05-02T07:26:11.434Z (7 months ago)
• Topics: ascii, blog, chart, cli, console, data-visualization, terminal
• Language: JavaScript
• Homepage: https://www.chunqiuyiyu.com/ervy/
• Size: 164 KB
• Stars: 1,594
• Watchers: 27
• Forks: 44
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome - ervy - Bring charts to terminal. (JavaScript)
• my-awesome - chunqiuyiyu/ervy - visualization,terminal pushed_at:2023-08 star:1.6k fork:0.0k Bring charts to terminal. (JavaScript)
• awesome-ascii - ervy
• my-awesome-starred - chunqiuyiyu/ervy - Bring charts to terminal. (JavaScript)

README

          
```

___________                    

\_   _____/_________  _____.__.

 |    __)_\_  __ \  \/ <   |  |

 |        \|  | \/\   / \___  |

/_______  /|__|    \_/  / ____|

        \/              \/     

```

[![Travis (.org)](https://img.shields.io/travis/chunqiuyiyu/ervy.svg?style=flat-square)](https://travis-ci.org/chunqiuyiyu/ervy)

![GitHub](https://img.shields.io/github/license/chunqiuyiyu/ervy.svg?style=flat-square)

[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg?style=flat-square)](https://standardjs.com)

[![Install Size](https://flat.badgen.net/packagephobia/install/ervy)](https://packagephobia.now.sh/result?p=ervy)

> Bring charts to terminal

## Preview

[Live Demo](https://www.chunqiuyiyu.com/ervy#demo)(powered by [jQuery Terminal Emulator](https://terminal.jcubic.pl/))

## Why build this

There is no special reason, just because I love terminal and ASCII art. It's very cool! Hope you enjoy Ervy and make your terminal more beautiful.

## Supported Chart types

### Bar

![](/site/imgs/bar.png)

### Pie

![](/site/imgs/pie.png)

### Bullet

![](/site/imgs/bullet.png)

### Donut

![](/site/imgs/donut.png)

### Gauge

![](/site/imgs/gauge.png)

### Scatter

![](/site/imgs/scatter.png)

## APIs

## main function

```js

ervy.[chartType](data, options)

```

## render colored characters

```js

// foreground color

ervy.fg(color, character)

// background color

ervy.bg(color, [length])

```

Supported color: black, red, green, yellow, blue, magenta, cyan and white.

Use [demo](/demo/index.js) to understand how to combine APIs in actual code.

## Credits

[@jcubic](https://github.com/jcubic)

## License

[MIT](./LICENSE)