You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Bryan Bennett 26b2ef6488
Archive + note new upstream
9 months ago
.gitignore Initial commit 6 years ago
LICENSE Initial commit 6 years ago Archive + note new upstream 9 months ago
pyxel Support python2.x with a __future__ import 6 years ago
pyxel_ss.png Code and README import 6 years ago

ARCHIVED. New upstream at


A small python script to show the colors in a text file to a true-color capable terminal.

Pyxel will read over files provided as input in order to extract and display squares of color for each one. These squares are ordered, and thus require complete parsing of the input before they can be displayed.

Pyxel requires a true-color capable terminal to function properly. There are a number of such terminals including KDE's Konsole, iTerm2, all VTE-based terminals, and st. This notably excludes urxvt and putty.

Pyxel is currently python2 and python3 compatible. This may change in the future if any interesting new features are python3 only.


Pyxel slurps all files provided to it. All of the following examples should work:

> pyxel < ~/.Xdefaults
> echo "#AAA#BBB#CCC #DDD" | pyxel
> echo "#AAA#BBB#CCC #DDD" | pyxel -
> pyxel ~/.Xdefaults
> pyxel ~/.Xdefaults ~/.vim/bundle/gruvbox/gruvbox.vim




Pyxel is directly inspired by l3ib's rainbow utility. I didn't like the Ruby dependency, so I decided to reimplement in Python3 (though I never read Rainbow's code, so any similarities are purely coincedental and likely unavoidable). I then rediscovered how much of a pain UI programming can be and decided to implement as a modern terminal application rather than via one of the numerous UI toolkits available in Python.