img2pixel

Convert any image to pixel art for your terminal — perfect for neofetch, fastfetch, or just for fun.

Uses Unicode half-block characters (▀) with true-color ANSI codes to render 2× vertical resolution per character row.

Installation

From PyPI:

pip install img2pixel

From source:

git clone https://github.com/RooWiki/img2pixel
cd img2pixel
pip install .

Usage

img2pixel <image> [options]

Examples

# Preview in terminal
img2pixel avatar.png

# Save for neofetch
img2pixel avatar.png -o ~/.config/art.txt
neofetch --ascii ~/.config/art.txt

# Retro look — chunky blocks, limited palette
img2pixel avatar.png -w 35 -b 6 -c 16

# Fine detail, no palette limit
img2pixel avatar.png -w 60 -b 2

# 8-bit style
img2pixel avatar.png -b 8 -c 8

Neofetch integration

Generate the art file once and point neofetch to it:

img2pixel ~/Pictures/avatar.png -w 35 -o ~/.config/neofetch/art.txt

In your ~/.config/neofetch/config.conf:

image_backend="ascii"
image_source="$HOME/.config/neofetch/art.txt"

Requirements

• Python 3.8+
• Pillow (pip install Pillow)
• A terminal with true-color support (most modern terminals)

License

MIT