Skip to content

Repository files navigation

🖼️ ImageType

Easy image editing for everyone: ImageType empowers visually impaired users to effortlessly add custom text to images for social media, greeting cards, and more, all with full screen reader compatibility. 🌟


🧐 Overview

ImageType is a professional desktop application designed to empower visually impaired and blind users to easily add custom text to images or create new graphics from scratch. 🚀 It focuses heavily on strict accessibility standards and provides a straightforward, high-contrast interface fully compatible with screen readers. 🎧 Whether you want to prepare text for social media posts, YouTube Shorts, or any other visual content, ImageType makes styling and positioning your words seamless.


✨ Core Features

  • 📱 Accessible Interface: Built with PySide6 for absolute native compatibility with modern screen readers and accessibility tools.
  • 🌍 Multilingual Text Input: Full support for typing in any language, with seamless rendering of Right-to-Left (RTL) Arabic text and mixed Arabic/English prose.
  • 🔠 Smart Font Fallback Engine: Automatically detects if a system font lacks Arabic support and dynamically falls back to the embedded Amiri font to prevent text corruption or broken characters.
  • Binary Search Sizing Optimization: Implements an advanced binary search algorithm to automatically and instantly calculate the maximum perfect font size to fit your text within image boundaries when the "Fit to Width" checkbox is enabled.
  • 🎯 Precise Text Positioning: Predefined layout anchoring grid (Top Left, Center, Bottom Right, etc.) that deactivates automatically when layout wrapping takes priority.
  • 🎨 Text Shadows & Outlines: Optional drop shadows for high-contrast visibility against complex backgrounds, with automatic adaptive text outlining (stroke width) based on font color.
  • 🖼️ Flexible Background Systems: Support for loading existing local images, generating solid color canvases, or exporting transparent PNG overlays.
  • 📐 Standard Aspect Ratios: Quick presets for major digital formats including Standard (16:9), Square (1:1), and Portrait (9:16) for YouTube Shorts and Instagram Reels.
  • 📋 Direct Clipboard Export: Features a one-click "Copy to Clipboard" button to paste your generated graphics straight into messaging or editing apps without saving files.
  • 💾 Local Profile & Preset Saving: Save all your text styles, font configurations, colors, and canvas settings into custom template profiles for instant reuse later.
  • 🎨 Dynamic QSS Themes: Full configuration for multiple application themes (like Dark Theme) that update the UI look on the fly without restarting.
  • 🔄 Embedded Automated Update Manager: Built-in asynchronous network checker that checks GitHub releases to alert, download, and launch software installers safely.

⬇️ Download & Run

Go to the 📥 Latest Releases Page to download the version that suits your needs:

1. ⚙️ Installed Version (Recommended)

  • 💾 Download the official Windows ImageType_Setup.exe installer.
  • 🛠️ Run the installer to register the program safely on your system environment.
  • 📂 In this mode, all your editable assets (languages, templates, fonts, themes) are stored and safely managed under your user documents folder: Documents/Ahmed Samy/ImageType/.

2. 🧳 Portable Version

  • 📦 Download the portable compressed archive file.
  • 📂 Extract the directory anywhere on your computer or USB drive.
  • 📁 To use your custom assets in portable mode, ensure your asset folders are placed inside a folder named data right next to the main ImageType.exe file.

🛠️ For Developers (Local Setup)

This project uses uv for blazing-fast, reliable Python dependency and virtual environment management. ⚡

  1. 👥 Clone the repository: git clone https://github.com/ahmedthebest31/ImageType.git
  2. 📂 Navigate to the project directory: cd ImageType
  3. 🔄 Install dependencies and sync the virtual environment: uv sync
  4. 🚀 Run the application in development mode: uv run main.py
  5. 🏗️ Build the standalone production executable using PyInstaller: uv run pyinstaller --noconfirm --onefile --windowed --name="ImageType" --icon="assets/icon_64.ico" main.py

💡 Creative Applications & Ideas

  • ✉️ Social Media Greetings: Easily design personalized holiday greeting cards or event announcements for platforms like Facebook and X.
  • 🎬 Video Thumbnails & Overlays: Produce rapid thumbnail text overlays or descriptive frames for YouTube Shorts, TikToks, and Instagram Reels.
  • 📚 Educational Graphics: Generate clear images with text for slide presentations, tutorials, or study notes to make information visually scannable.
  • 💬 Inspirational Quote Graphics: Instantly turn your favorite written quotes or text snippets into beautifully styled shareable graphics.

⚖️ License

This project is licensed under the GNU General Public License v3.0 (GPLv3). See the LICENSE file for more details.


🤝 Contributions & Suggestions

Your feedback is highly valued! If you have ideas for new layout features, encounter bugs, or want to contribute code:

  • 🐛 Open an Issue: Describe any bugs you find or suggest new feature requests.
  • 🔧 Open a Pull Request: Submit improvements or new UI translation blocks directly to the project.

📞 Contact

For any questions, business tracking, or technical support, feel free to open an official issue directly on GitHub.

About

a program to easily add custom text to images or create new images with text overlays.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages