💻 Turn any image into clean, crispy ASCII art using a dope Tkinter GUI — scaled perfectly to your screen like Ilphu’s classic tool, but in Python 🔥
“From pixels to terminal vibes — built for hackers, artists, and anyone who loves that retro aesthetic.”
✅ Auto-scaling to your screen resolution
✅ Slick dark-themed GUI (Tkinter)
✅ Supports all major image formats: .jpg, .png, .bmp, .gif, .ico, .webp, etc.
✅ Instant ASCII preview in terminal style
✅ Reset / Exit with Ctrl + C
✅ Built 100% offline — no image ever leaves your machine
✅ Cross-platform — works on Windows, macOS, and Linux
All needed libraries are listed in the requirements.txt. Run:
pip install -r requirements.txt
2. 🧠 Launch the App
python ascii_converter.py
Then just click ⬆️ Upload Image ⬆️, pick your pic, and boom — ASCII magic.
📄 requirements.txt
Pillow
numpy
You can add more later if needed (e.g., color ASCII, exports, etc.)
🧠 How It Works
The script converts your image into grayscale, scales it perfectly based on your monitor's resolution, maps pixel brightness to characters using a custom ASCII ramp, and displays the result inside a styled text box.
Want to change the character style? Modify this:
self.ascii_ramp = " .:-=+*#%@"
Try emojis, symbols, or custom ramps for different vibes 😎
🛠 Built With
🐍 Python 3.7+
🖼 Pillow – image handling
📊 NumPy – pixel matrix crunchin’
🖥 Tkinter – GUI (native, no bloat)
💡 Inspired by Ilphu's C++ ASCII Renderer: andrei.codes/ascii-camera
✍️ Author
👤 Threadlinee
🎩 Ethical Hacker | 💻 GUI Mastermind | 🎨 Terminal Art Enthusiast
“I don’t make tools. I make digital art for the command line gods.”
📄 License
MIT License — Do whatever you want, just don’t sell it as your own. Credit where credit due ✊
🌟 Support & Ideas
💬 Got ideas? Wanna collab? DM or open a PR. ASCII art ain’t dead — we bringin’ it back, pixel by pixel.
⭐ Like this project?
Show some love. Star the repo. Fork it. Share it.
Let the world know that ASCII art is STILL ALIVE.If you like this project, feel free to buy me a coffee!