byebg

Remova o fundo de suas imagens JPG automagicamente.

📌 Descrição

byebg é uma ferramenta de linha de comando e também uma integração com o menu de contexto do Windows, permitindo que desenvolvedores e usuários removam o fundo de imagens JPG de forma automática.

🚀 Instalação e Compilação

Pré-requisitos

Python >=3.8,<3.12
Pip ou Poetry
PyInstaller (para compilação do executável)
Docker

Passos utilizando PIP

Clone o repositório:

git clone https://github.com/gabrielfroes/byebg.git
cd byebg

Construa e execute a image docker:
```
docker compose up --build
```

Opcional: Gerar executavel com Docker compose

docker compose -f docker-compose.pyinstaller.yaml up --build

Compile o projeto (opcional):
```
pyinstaller --onefile --noconsole --icon=byebg.ico ./src/byebg.py
```
Pode ser que você precise ajustar o caminho correto do ícone se quiser incorporá-lo no executável.

Passos Utilizando Poetry

Certifique-se de ter o Poetry instalado (tutorial oficial)

Clone o repositório:

git clone https://github.com/gabrielfroes/byebg.git
cd byebg

Crie um ambiente virtual e instale as dependências:
```
poetry install
```
Compile o projeto (opcional):
```
pyinstaller --onefile --noconsole --icon=byebg.ico ./src/byebg.py
```
Pode ser que você precise ajustar o caminho correto do ícone se quiser incorporá-lo no executável.

Instalação do menu de contexto

Após compilar, se você quiser adicionar a opção no menu de contexto do Windows:

Adapte o arquivo .reg para apontar para o local correto do seu executável.
Execute o arquivo .reg como administrador.

Docker branch

Aos desenvolvedores que não tem o Python instalado e quiserem testar a funcionalide do byebg, podem testar utilizando o docker.

Para mais detalhes, visualize a branch main.

🎯 Como usar

Linha de Comando

Execute o script ou o executável compilado passando a imagem de entrada e a saída desejada:

python byebg.py input.jpg output.png

Menu de Contexto

Após instalar a integração com o menu de contexto:

Navegue até uma imagem JPG no windows explorer.
Clique com o botão direito na imagem.
Selecione a opção "Remover Fundo".
Uma nova imagem será gerada no mesmo diretório com o sufixo "_byebg.png".

🤖 Contribuições

Se você encontrar bugs, tiver sugestões de melhorias ou quiser expandir as funcionalidades, sinta-se à vontade para abrir uma issue ou enviar um pull request.

heltonricardo / byebg