Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/asciimoo/drawille

Pixel graphics in terminal with unicode braille characters
https://github.com/asciimoo/drawille

Last synced: 1 day ago
JSON representation

Pixel graphics in terminal with unicode braille characters

Host: GitHub
URL: https://github.com/asciimoo/drawille
Owner: asciimoo
License: agpl-3.0
Created: 2014-04-22T14:54:01.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2024-02-12T09:44:46.000Z (10 months ago)
Last Synced: 2024-10-29T14:56:55.223Z (about 1 month ago)
Language: Python
Homepage:
Size: 254 KB
Stars: 3,118
Watchers: 54
Forks: 128
Open Issues: 18
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

starred-awesome - drawille - Pixel graphics in terminal with unicode braille characters (Python)

README

        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](docs/images/drawille_01.png)

![Drawille](docs/images/xkcd.png)

![Drawille](docs/images/sine_tracking.gif)

![Drawille](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](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](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, 

```

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