asciimoo/drawille

Pixel graphics in terminal with unicode braille characters

Source code at GitHub https://github.com/asciimoo/drawille

{
  "createdAt": "2014-04-22T14:54:01Z",
  "defaultBranch": "master",
  "description": "Pixel graphics in terminal with unicode braille characters",
  "fullName": "asciimoo/drawille",
  "homepage": "",
  "language": "Python",
  "name": "drawille",
  "pushedAt": "2024-11-13T13:44:56Z",
  "stargazersCount": 3199,
  "topics": [],
  "updatedAt": "2025-11-25T08:32:39Z",
  "url": "https://github.com/asciimoo/drawille"
}

DRAWILLE

Drawing in terminal with Unicode [Braille][] characters

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

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

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

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

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

USAGE

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)

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:

$ pip install drawille

$ easy_install drawille

Bugs

Bugs or suggestions? Visit the issue tracker.

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