Skip to content
Display images in the terminal
Branch: master
Clone or download
Latest commit 4206eb5 Aug 12, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
img Use ▄ instead of ▀ May 28, 2016
.gitignore initial commit May 27, 2016
LICENSE Add license May 28, 2016 update readme Aug 12, 2017
color.go Use integer math, avoid float64 castings in loop May 28, 2016
color_test.go Use uint16 for colors May 28, 2016
image.go Provide default whratio when size cannot be read Jun 11, 2016
image_test.go initial commit May 27, 2016
main.go clean up Aug 12, 2017


pxl is a little hack to display images in the terminal.


You will need to have Go installed and configured in your path. Your terminal must have xterm-256color mode enabled.

go get


pxl filename

Close the image with <ESC>.


You may want to squint your eyes or take a few steps backwards when looking at the output.


image pxl


This software is distributed under the BSD-style license found in the LICENSE file.

You can’t perform that action at this time.