KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

drawille

★ 3,249 Open GitHub ↗

Pixel graphics in terminal with unicode braille characters

// 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
```

```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/ >.

### 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/)

drawille

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README