Uma aplicação web robusta em Flask para adicionar marcas d'água personalizadas (texto ou imagem) aos seus arquivos PDF, protegendo seus documentos de forma simples e eficiente.
Reportar Bug
·
Solicitar Recurso
Índice
Este projeto resolve o problema de proteção de documentos, permitindo que usuários insiram identificações visuais (como logotipo ou texto de confidencialidade) antes de compartilhá-los. O funcionamento principal ocorre através do upload de um PDF pelo usuário, que pode escolher entre uma marca d'água de texto (customizando cor, fonte e tamanho) ou de imagem (fazendo o upload do arquivo). O sistema processa o arquivo no servidor, sobrepondo a marca d'água na opacidade e posição definidas, e retorna automaticamente o PDF final para download. O processamento é seguro, realizado em memória sem salvar os arquivos temporários no disco do servidor.
Principais características:
- Tipos de Marca d'Água: Texto customizado ou imagem.
- Controle de Estilo Total: Personalize opacidade, cor e tamanho da fonte.
- Processamento Seguro em Memória: Uploads e edições feitas diretamente na memória.
- Interface Dinâmica: O formulário se adapta com base no tipo escolhido.
Para executar uma cópia local funcionando, siga os passos abaixo. O gerenciamento de dependências é feito com a ferramenta uv.
- uv
curl -LsSf https://astral.sh/uv/install.sh | sh
- Clone o repositório
git clone https://github.com/alissonpef/flask_pdf_watermarker.git cd flask_pdf_watermarker - Sincronize as dependências e crie o ambiente virtual automaticamente
uv sync
- Crie as variáveis de ambiente baseadas no exemplo (se necessário)
cp .env.example .env
- Inicie o servidor de desenvolvimento
uv run flask run
Acesse a aplicação em http://127.0.0.1:5000 em seu navegador. Envie um arquivo PDF, escolha se deseja colocar uma marca d'água de texto ou imagem, ajuste a opacidade e posicione como preferir, depois clique em enviar para receber seu documento protegido.
Para rodar a verificação de linter e formatação com o Ruff:
uv run ruff format .
uv run ruff check .As contribuições são o que tornam a comunidade open source um lugar tão incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito apreciada.
- Faça o Fork do Projeto
- Crie a sua Branch de Funcionalidade (
git checkout -b feature/FuncionalidadeIncrivel) - Commit suas Mudanças (
git commit -m 'Adicione alguma FuncionalidadeIncrivel') - Faça o Push para a Branch (
git push origin feature/FuncionalidadeIncrivel) - Abra um Pull Request
Distribuído sob a Licença MIT. Veja LICENSE para mais informações.
Alisson Pereira Ferreira - alissonpef@gmail.com - LinkedIn
Link do Projeto: https://github.com/alissonpef/flask_pdf_watermarker
Made with ❤️ by Alisson Pereira.