2 min de leitura ·

ZPL2PDF: um conversor de ZPL para PDF open source

Você já precisou lidar com etiquetas em ZPL (Zebra Programming Language) e se perguntou: “Como eu consigo visualizar isso sem ter uma impressora Zebra por perto?”

Foi exatamente esse problema que me motivou a criar o ZPL2PDF, um projeto open source que converte arquivos ou strings ZPL diretamente em PDF, de forma simples e rápida.

Por que isso é útil?

Validação rápida: antes de mandar a etiqueta pra impressora, você consegue conferir no PDF se o layout está correto.
Integração em sistemas: dá pra usar em pipelines, automações ou até expor em serviços web.
Independência de hardware: não precisa ter uma Zebra por perto só pra testar.
Batch sem dor de cabeça: precisa enviar várias etiquetas para um cliente aprovar? Agora você pode gerar um único PDF com todas as etiquetas, sem limitações, direto pelo CLI.

Como usar (resumido)

Basta baixar o instalador na release do projeto no GitHub e executar o comando passando:

-i → O arquivo contendo o conteúdo ZPL ou uma string ZPL.
-n → O nome do arquivo de saída (PDF).
-o → O caminho onde o arquivo será salvo.

Exemplo rápido:

"C:\Program Files\ZPL2PDF\ZPL2PDF.exe" -i "C:\Users\user\Documents\exemple_zpl.txt" -o "C:\Users\user\Documents" -n "exemple_zpl.pdf"

Para ver exemplos mais completos e detalhes de configuração, confira o repositório:
👉 ZPL2PDF no GitHub

Contribuições

O projeto continua evoluindo. Se você tiver interesse em usar, abrir issues, sugerir melhorias ou mandar PRs, será super bem-vindo. 🚀

Fonte: https://github.com/brunoleocam/ZPL2PDF

user1

3 meses atrás

Interessante, a maior parte das soluções desse tipo possuem uma chamada para a api do Labelary. Pelo que vi do código muito rapidamente, não me parece ser o caso desse projeto.

brunoleocam

Autor

3 meses atrás

Isso mesmo! Busquei uma alternativa ao Labelary porque encontrei algumas limitações, especialmente em gerar múltiplas etiquetas de uma vez. Foi aí que encontrei a biblioteca BinaryKits.Zpl, que permite renderizar os códigos ZPL e convertê-los para PDF de forma local. Com isso, é possível gerar quantidade ilimitada de etiquetas e ainda chamar o conversor direto pelo CLI, sem depender de APIs externas.

luissilvah

3 meses atrás

Tive um problema recentemente sobre isso de gerar multiplas etiquetas.
A maneira que resolvemos aqui foi dividir em alguns grupos as etiquetas e enviar em passos depois juntamos todas. Gostei do projeto vou dar uma olhada mais com calma, mas observei que enfatizou bastante o windows conseguimos gerar essas no linux também? ou conhece algo para java?

brunoleocam

Autor

2 meses atrás

Olá luissilvah! Muito obrigado pelo feedback!

Ótima notícia: agora o ZPL2PDF tem suporte completo para Linux! 🎉

🐧 Linux Nativo

# Download
wget https://github.com/brunoleocam/ZPL2PDF/releases/download/v2.0.0/ZPL2PDF-v2.0.0-linux-x64.tar.gz

# Extrair
tar -xzf ZPL2PDF-v2.0.0-linux-x64.tar.gz
cd ZPL2PDF-v2.0.0-linux-x64

# Rodar daemon (conversão automática)
./ZPL2PDF start

# Ou conversão única
./ZPL2PDF -i etiqueta.txt -o ./output -n resultado.pdf

Pasta padrão: ~/Documents/ZPL2PDF Auto Converter
Coloque arquivos .txt ou .prn lá e os PDFs aparecem automaticamente na mesma pasta!

🐳 Docker (Recomendado)

Ainda mais simples com Docker - funciona em qualquer Linux:

# Criar pasta para monitoramento
mkdir -p ~/zpl-watch

# Rodar daemon
docker run -d \
  --name zpl2pdf \
  -v ~/zpl-watch:/app/watch \
  --restart unless-stopped \
  ghcr.io/brunoleocam/zpl2pdf:latest

# Pronto! Coloque arquivos ZPL em ~/zpl-watch
# PDFs aparecem automaticamente na mesma pasta

Vantagens:

✅ Sem instalação de dependências
✅ Funciona em qualquer distro
✅ Reinicia automaticamente
✅ Fácil atualização: docker pull ghcr.io/brunoleocam/zpl2pdf:latest

☕ Sobre Java

Como é .NET, não roda diretamente em Java, mas via Docker funciona com qualquer linguagem! Seu código Java só precisa criar arquivos ZPL na pasta monitorada - a conversão é automática.

Qualquer dúvida, é só me avisar!