drawille - GitLite

KO | EN

gitlite — search

#cross-platform #react #kubernetes #graphql #cli #c #python #rag #html #web

drawille

(★ 3,250)

Pixel graphics in terminal with unicode braille characters

File Explorer

ZIP Download

- - drawille_01.png
  - rotating_cube.gif
  - sine_tracking.gif
  - turtle.png
  - usage.png
  - xkcd.png
- basic.py
- flappy_birds.py
- image2term.py
- image2term3.py
- rotating_cube.py
- sine_tracking.py
- speed_test.py
- turtle.py
- vidille.py
- xkcd.py
drawille.py
LICENSE
README.md
setup.py
tests.py

# Installation Guide

python

Prerequisites

Python
pip

Setup Steps

pip install drawille

Install the drawille package via pip.

Key Commands

pip install drawille

Install drawille using the python package manager.

easy_install drawille

Install drawille using easy_install.

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`pip install`

View Details ▼

Install Python packages.

pip install {{package1 package2 ...}}

Install one or more packages:

pip install {{package1 package2 ...}} {{[-U|--upgrade]}}

Upgrade all specified packages to the latest version, installing any that are not already present:

pip install {{package}}=={{version}}

Install a specific version of a package:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

DRAWILLE
========

Drawing in terminal with Unicode [Braille][] characters

[Braille]: http://en.wikipedia.org/wiki/Braille

[![Flattr this git repo](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=asciimoo&url=https://github.com/asciimoo/drawille&title=drawille&language=&tags=github&category=software)

![Drawille](https://raw.githubusercontent.com/asciimoo/drawille/master/docs/images/drawille_01.png)

![Drawille](https://raw.githubusercontent.com/asciimoo/drawille/master/docs/images/xkcd.png)

![Drawille](https://raw.githubusercontent.com/asciimoo/drawille/master/docs/images/sine_tracking.gif)

![Drawille](https://raw.githubusercontent.com/asciimoo/drawille/master/docs/images/rotating_cube.gif)

### USAGE

```python
from __future__ import print_function
from drawille import Canvas
from math import sin, radians

c = Canvas()

for x in range(0, 1800, 10):
    c.set(x / 10, 10 + sin(radians(x)) * 10)

print(c.frame())
```

![Usage](https://raw.githubusercontent.com/asciimoo/drawille/master/docs/images/usage.png)

```python
from drawille import Turtle

t = Turtle()

for _ in range(36):
    t.right(10)
    for _ in range(36):
        t.right(10)
        t.forward(8)

print(t.frame())
```

![Turtle](https://raw.githubusercontent.com/asciimoo/drawille/master/docs/images/turtle.png)

### Installation

To install drawille, simply:

```bash
$ pip install drawille
```

or

```bash
$ easy_install drawille
```

### Bugs

Bugs or suggestions? Visit the [issue tracker](https://github.com/asciimoo/drawille/issues).

Tested fonts

| Font           | Works |
| -------------- | ----- |
| Terminus       | Yes   |
| Fixed          | Yes   |
| DejaVuSansMono | Yes   |

Tested terminals

| Terminal     | Works |
| ------------ | ----- |
| rxvt-unicode | Yes   |

### LICENSE

```
drawille is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

drawille is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with drawille. If not, see < http://www.gnu.org/licenses/ >.

(C) 2014- by Adam Tauber, <asciimoo@gmail.com>
```

### Other implementations / similar projects

* [https://github.com/null93/drawille](https://github.com/null93/drawille) (Java)
 * [https://github.com/madbence/node-drawille](https://github.com/madbence/node-drawille) (nodejs)
 * [https://github.com/exrook/drawille-go](https://github.com/exrook/drawille-go) (go)
 * [https://github.com/maerch/ruby-drawille](https://github.com/maerch/ruby-drawille) (ruby)
 * [https://github.com/sunetos/TextPlots.jl](https://github.com/sunetos/TextPlots.jl) (julia)
 * [https://github.com/mkremins/drawille-clj](https://github.com/mkremins/drawille-clj) (clojure)
 * [https://github.com/mydzor/bash-drawille](https://github.com/mydzor/bash-drawille) (bash)
 * [https://github.com/hoelzro/term-drawille](https://github.com/hoelzro/term-drawille) (perl 5)
 * [https://github.com/whatthejeff/php-drawille](https://github.com/whatthejeff/php-drawille) (PHP)
 * [https://github.com/yamadapc/haskell-drawille](https://github.com/yamadapc/haskell-drawille) (haskell)
 * [https://github.com/nidhoggfgg/rsille](https://github.com/nidhoggfgg/rsille) (rust)
 * [https://github.com/P1start/drawille-rs](https://github.com/P1start/drawille-rs) (rust)
 * [https://github.com/liam-middlebrook/drawille-sharp](https://github.com/liam-middlebrook/drawille-sharp) (C#)
 * [https://github.com/asciimoo/lua-drawille](https://github.com/asciimoo/lua-drawille) (Lua)
 * [https://github.com/l-a-i-n/drawille-plusplus](https://github.com/l-a-i-n/drawille-plusplus) (CPP)
 * [https://github.com/massn/elixir-drawille](https://github.com/massn/elixir-drawille) (elixir)
 * [https://github.com/sshbio/drawille](https://github.com/sshbio/drawille) (emacs lisp)
 * [https://gist.github.com/sshbio/###](https://gist.github.com/sshbio/cb0073a0e8c50a681288c8bff74d9c4b) (awk, images only)
 * [https://github.com/Huulivoide/libdrawille](https://github.com/Huulivoide/libdrawille) (c)
 * [https://github.com/PMunch/drawille-nim](https://github.com/PMunch/drawille-nim) (nim)
 * [https://github.com/Goheeca/cl-drawille](https://github.com/Goheeca/cl-drawille) (common lisp)

### Further reading

* [HackerNews](https://news.ycombinator.com/item?id=7776112)
 * [Reddit](http://www.reddit.com/r/programming/comments/263opn/drawille_pixel_graphics_in_a_terminal_using/)
 * [ohloh](http://www.ohloh.net/p/drawille)
 * [Braille unicode pixelation](http://blog.jverkamp.com/2014/05/30/braille-unicode-pixelation/)