Skip to content

Repository files navigation

img2irc (2.0.0-alpha)

img2irc converts images to IRC and ANSI art using real font glyphs. it has a CLI, an interactive terminal editor, a browser editor, and Python/JavaScript APIs.

img2irc block example

choose from Unicode blocks, braille, or custom glyphs; adjust the image with filters, smooth the contours, and add text overlays. OCR preserves image text, with FIGlet for larger labels. output supports IRC's 99 colours, 256-colour ANSI, and 24-bit truecolour.

install

from a clone of this repository:

cargo install --path . --locked

see installation for release downloads, AUR packages, and build requirements. rendering fonts are bundled; no font installation is needed.

usage

img2irc photo.png --width 80
img2irc photo.png --render irc --width 80 > art.irc
img2irc --tui photo.png

paths and HTTP(S) URLs work as input. ansi is the default colour mode. img2irc --help lists all CLI options.

docs

if you like this project, i would appreciate a vote on the AUR!

licensed under GPL-3.0-only.

About

a highly versatile, award-winning image to IRC/ANSI art tool

Topics

Resources

Stars

46 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages