/byebg

🚫 Remova o fundo das fotos automagicamente!

Primary LanguageDockerfile

byebg

Remova o fundo de suas imagens JPG automagicamente.

Ícone byebg

📌 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

  1. Clone o repositório:

    git clone https://github.com/gabrielfroes/byebg.git
    cd byebg
  2. Construa e execute a image docker:

    docker compose up --build
  3. Opcional: Gerar executavel com Docker compose

    docker compose -f docker-compose.pyinstaller.yaml up --build
  4. 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)

  1. Clone o repositório:

    git clone https://github.com/gabrielfroes/byebg.git
    cd byebg
  2. Crie um ambiente virtual e instale as dependências:

    poetry install
  3. 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:

  1. Adapte o arquivo .reg para apontar para o local correto do seu executável.
  2. 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

Ícone byebg

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

  1. Navegue até uma imagem JPG no windows explorer.
  2. Clique com o botão direito na imagem.
  3. Selecione a opção "Remover Fundo".
  4. 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.