https://github.com/prasad-kmd/ascii-img-gui

A GUI version of a ascii art generator, built for Windows.
https://github.com/prasad-kmd/ascii-img-gui

ascii ascii-art ascii-art-generator ascii-image-converter

Last synced: 3 months ago
JSON representation

A GUI version of a ascii art generator, built for Windows.

• Host: GitHub
• URL: https://github.com/prasad-kmd/ascii-img-gui
• Owner: prasad-kmd
• License: apache-2.0
• Created: 2025-02-07T09:41:45.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2025-02-16T17:35:09.000Z (3 months ago)
• Last Synced: 2025-02-16T18:26:41.310Z (3 months ago)
• Topics: ascii, ascii-art, ascii-art-generator, ascii-image-converter
• Language: Python
• Homepage:
• Size: 9.77 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# **ASCII Image Converter GUI - Release Information**  

## **📌 Application Overview**  

**ASCII Image Converter GUI** is a simple graphical interface for `ascii-image-converter.exe`, allowing users to convert images into ASCII art **without using the terminal**. It supports various customization options and provides a user-friendly experience.  

Based on [TheZoraiz](https://github.com/TheZoraiz/ascii-image-converter)'s `ascii-image-converter` Repo.

---

### **✅ Features**  

- **Supports all flags of `ascii-image-converter.exe`** (color, grayscale, complex, negative, flip, etc.).  

- **Simple and intuitive GUI** using **PyQt6**.  

- **Allows users to select any supported image file** for conversion.  

- **Save output ASCII art as `.png` or `.txt`** in the same directory.  

- **"About Us" window with GitHub contribution link**.  

- **Optimized `.exe` file** with embedded dependencies.  

---

## **📂 Installation & Usage**  

### **💾 System Requirements:**  

- **OS:** Windows 10/11 (64-bit)  

- **RAM:** Minimum 2GB  

- **Disk Space:** 50MB free space  

- **Dependencies:** None (Standalone `.exe`)  

### **🚀 How to Use:**  

1. **Download & Install** the `.exe` file.  

2. **Run `ascii_img.exe`** .  

3. **Select an image** and choose your desired options.  

4. Click **"Process"** to generate ASCII art.  

5. The output file is saved in the **same folder as the input image**.  

---

## **📦 File Details**  

| **File Name**            | **Description**                          | **Size** |

|--------------------------|------------------------------------------|---------|

| `ascii_img.exe`    | Main GUI application                     | *33.2 MB*  |

**Initial release was deleted. Wait for new release. ;)**

---

## **🔧 Technical Details**  

- **Built with:** `Python 3.x`, `PyQt6`, `PyInstaller`  

- **Compiled using PyInstaller** (`--onefile`, `--windowed`, `--strip`, `UPX compression`)  

- **Embedded `ascii-image-converter.exe`** to ensure a standalone executable.  

- **Compressed `.exe`** to reduce file size while maintaining performance.  

---

## **🛠 Known Issues & Troubleshooting**  

| **Issue**               | **Solution** |

|-------------------------|-------------|

| App icon missing in `.exe` | Ensure you extracted all files correctly. |

---

## **🌍 Contribute & Support**  

**GitHub Repository:** [🔗 Click Here](https://github.com/prasad-kmd/ascii-img-gui)  

Want to contribute? Feel free to submit pull requests or report issues on GitHub!  

---

## **📜 License**  

This software is released under the **Apache-2.0 License**.  

---

### **🚀 Enjoy converting images to ASCII art effortlessly!**  

Let me know if you need modifications. 😊