im2ansi: A command-line tool to convert images into ANSI/ASCII art

76 views
Skip to first unread message

Youssef Saeed

unread,
Dec 4, 2025, 1:59:38 AM (4 days ago) Dec 4
to The Ring Programming Language
Hello everyone,

I'm excited to share a new command-line tool I built with Ring called im2ansi.

It's a simple, cross-platform utility that converts any image into beautiful ANSI, ASCII, SVG, or HTML art, right in your terminal. I wanted a fast and flexible tool for this, and Ring was a perfect fit for the job.

Here are a couple of screenshots showing what it can do:
https://i.snipboard.io/wFKsaf.jpghttps://i.snipboard.io/OAp3K9.jpg

Key Features:
  • Export to ANSI, ASCII, SVG, or HTML.
  • Flexible Sizing: Easily control the output width and height.
  • Highly Customizable: Use custom character sets, choose from 12 built-in ASCII ramps, and invert colors.
  • Cross-Platform: Works on Linux, macOS, and Windows.
Get Started

The easiest way to try it is to download a pre-built executable from the GitHub releases page:
Quick Example

im2ansi -p my_image.jpg

You can find the full documentation and source code on the GitHub repository:
This was a fun project to build, and I'd love to hear your thoughts. Contributions, bug reports, and suggestions are all welcome!

Best regards,
Youssef

Mahmoud Fayed

unread,
Dec 4, 2025, 2:29:37 AM (4 days ago) Dec 4
to The Ring Programming Language
Hello Youssef

Thank you very much for developing this wonderful tool :D

It's a great example about developing command-line tools using Ring, RingStbImage & RingFastPro

This is a screen shot from my machine

im2ansi.png

Added to Ring Website - News section & Resources section too

Keep up the GREAT WORK :D

Greetings,
Mahmoud

Youssef Saeed

unread,
Dec 4, 2025, 2:58:52 AM (4 days ago) Dec 4
to The Ring Programming Language
Hello Mahmoud,

Thank you for your kind words and for adding the tool to the News and Resources sections on the Ring website.

Best regards,
Youssef

Mahmoud Fayed

unread,
Dec 4, 2025, 3:09:30 AM (4 days ago) Dec 4
to The Ring Programming Language
Hello Youssef

You are welcome :D

Greetings,
Mahmoud

Ka mara

unread,
Dec 4, 2025, 11:39:18 AM (4 days ago) Dec 4
to Mahmoud Fayed, The Ring Programming Language

Hello Youssef,
This is SO NICE and INTERESTING.

THANKS for Creating it.

Tim


--

---
You received this message because you are subscribed to the Google Groups "The Ring Programming Language" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ring-lang+...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/ring-lang/dce5cbca-d543-4f40-a92b-51e6b339578bn%40googlegroups.com.

Youssef Saeed

unread,
Dec 5, 2025, 4:38:52 AM (3 days ago) Dec 5
to The Ring Programming Language
Hello Ka mara,

Thank you for your kind words!

Best regards,
Youssef

Mansour Ayouni

unread,
Dec 5, 2025, 8:06:32 AM (3 days ago) Dec 5
to Youssef Saeed, The Ring Programming Language
Hello Youssef,

A beautiful and fun tool!
image.png

Thank you for providing it!
I'm thinking of using it in some innovative daraviz ideas, in the Softanza Data Analytics module to visualise patterns of matrix data...

The principle is that I always prioritise the visualisation of data structures, tables, calendars, timelines, diagrams, and even statistical plots in the console in plain ascii form (before adding image-based visualizations).

The goal is to allow programmers to debug their visual outputs in the console without needing additional library and GUI frontends.

I'll let you know.

Best,
Mansour

Youssef Saeed

unread,
Dec 5, 2025, 8:44:18 AM (3 days ago) Dec 5
to The Ring Programming Language
Hello Mansour,

Thank you for testing the tool and for your kind words!


> I'm thinking of using it in some innovative daraviz ideas, in the Softanza Data Analytics module to visualise patterns of matrix data...

> The principle is that I always prioritise the visualisation of data structures, tables, calendars, timelines, diagrams, and even statistical plots in the console in plain ascii form (before adding image-based visualizations).

> The goal is to allow programmers to debug their visual outputs in the console without needing additional library and GUI frontends.

That sounds like a fascinating use case. I really like your philosophy of prioritizing ASCII-based data visualization in the console—it is a very practical approach for debugging. I would love to see how it turns out.

Best regards,
Youssef
Reply all
Reply to author
Forward
0 new messages