Image Overlay Z

English • Português (Brasil)

---

English

A user-friendly graphical application that adds an image overlay over multiple images at once (PNG, JPG formats). It offers full customization, including an intelligent feature to automatically adjust the overlay's tone for perfect visibility on any background.

✨ Key Features

• Intuitive Graphical Interface (GUI): No command line needed. An easy-to-use interface guides you through the process.
• Intelligent Auto-Recolor: Automatically analyzes the background of each image and adjusts the overlay to be dark on light areas and light on dark areas, ensuring maximum visibility.
• Batch Processing: Apply an overlay to hundreds of images in a single operation.
• Fully Customizable:
  • Adjust the overlay size (in pixels or percentage).
  • Choose the exact position (top-left, bottom-right, etc.).
  • Set the opacity level for a more subtle effect.
• Multiple Format Support: Works with PNG, JPG/JPEG, and BMP files.

🚀 How to Run

Prerequisites

• Python 3.8 or higher.
• Required libraries, which can be installed via pip:

  pip install pillow numpy

Running the Application

1. Make sure you have all the required libraries installed.
2. Run the script from your terminal:

   python image_overlay_z_gui.py

3. The application window will open, allowing you to select your language and begin the process.

Or open the page "Index.html" that is the recently created web version of the program.

For a detailed step-by-step guide, please refer to our User Manual.

🤝 How to Contribute

Contributions are always welcome! If you have an idea to improve the project, feel free to create an issue or submit a pull request.

📄 License

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

---

Português (Brasil)

Uma aplicação gráfica amigável que adiciona uma sobreposição de imagem sobre várias imagens simultaneamente (formatos PNG, JPG). Oferece personalização completa, incluindo uma função inteligente para ajustar automaticamente o tom da sobreposição para uma visibilidade perfeita em qualquer fundo.

✨ Funcionalidades Principais

• Interface Gráfica Intuitiva (GUI): Não é necessário usar a linha de comando. Uma interface fácil de usar guia você por todo o processo.
• Ajuste de Cor Automático e Inteligente: Analisa automaticamente o fundo de cada imagem e ajusta a sobreposição para ficar escura em áreas claras e clara em áreas escuras, garantindo máxima visibilidade.
• Processamento em Lote: Aplique uma sobreposição em centenas de imagens em uma única operação.
• Totalmente Personalizável:
  • Ajuste o tamanho da sobreposição (em pixels ou porcentagem).
  • Escolha a posição exata (canto superior esquerdo, inferior direito, etc.).
  • Defina o nível de opacidade para um efeito mais sutil.
• Suporte a Múltiplos Formatos: Compatível com arquivos PNG, JPG/JPEG e BMP.

🚀 Como Executar

Pré-requisitos

• Python 3.8 ou superior.
• Bibliotecas necessárias, que podem ser instaladas via pip:

  pip install pillow numpy

Executando a Aplicação

1. Certifique-se de que todas as bibliotecas necessárias estão instaladas.
2. Execute o script a partir do seu terminal:

   python image_overlay_z_gui.py

3. A janela da aplicação será aberta, permitindo que você escolha seu idioma e inicie o processo.

Ou abra a página "Index.html" que é a versão web recém criada do programa.

Para um guia detalhado com o passo a passo, consulte o nosso Manual do Usuário.

🤝 Como Contribuir

Contribuições são sempre bem-vindas! Se você tem alguma ideia para melhorar o projeto, se sinta livre para criar uma issue ou enviar uma pull request.

📄 License

Este projeto está sob a licença GNU General Public License v3.0 (GPLv3). Veja o arquivo LICENSE para mais detalhes.