https://github.com/threadlinee/imagetoascii
Convert all types of images into ASCII ART
https://github.com/threadlinee/imagetoascii
art ascii ascii-art github hacking-tool image lua python useful-scripts vue
Last synced: 4 months ago
JSON representation
Convert all types of images into ASCII ART
- Host: GitHub
- URL: https://github.com/threadlinee/imagetoascii
- Owner: Threadlinee
- Created: 2025-07-23T17:04:33.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-07-23T17:29:13.000Z (6 months ago)
- Last Synced: 2025-07-23T20:14:37.008Z (6 months ago)
- Topics: art, ascii, ascii-art, github, hacking-tool, image, lua, python, useful-scripts, vue
- Language: Python
- Homepage: https://docs.github.com
- Size: 16.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🖼️ Image To ASCII ART Converter — Python GUI Edition
> 💻 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 🔥
---
## 📸 Preview
“From pixels to terminal vibes — built for hackers, artists, and anyone who loves that retro aesthetic.”
---
## ⚙️ Features
✅ **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**
---
## 🚀 How to Use
### 1. 🔧 Install Requirements
All needed libraries are listed in the `requirements.txt`. Run:
```bash
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.
```
## ☕ Support Me
If you like this project, feel free to [buy me a coffee](https://ko-fi.com/G2G114SBVV)!