Klipper ou Marlin: qual firmware usar na impressora 3D

Sua impressora funciona, mas você desconfia que ela poderia entregar mais. Aí alguém no grupo solta a frase clássica: "instala Klipper que resolve". A dúvida entre Klipper ou Marlin é uma das que mais travam o maker intermediário — e a resposta mudou bastante nos últimos anos.

Até pouco tempo o argumento era simples: o Klipper tinha input shaping e o Marlin não tinha. Hoje o Marlin tem. Ou seja, a decisão deixou de ser "qual firmware tem o recurso" e virou uma conta de arquitetura, tempo de configuração e hardware extra.

Este comparativo usa a documentação oficial dos dois projetos como base — nada de número chutado — e fecha com um veredito por perfil de maker. Se você está com o dedo no gatilho de uma migração, leia antes de gastar o fim de semana.

Klipper ou Marlin: a diferença está na arquitetura

O Marlin roda inteiro dentro da placa da impressora. O microcontrolador (MCU) lê o G-code, calcula a trajetória e pulsa os motores — tudo no mesmo chip, que em muitas máquinas de entrada ainda é um 8-bit.

O Klipper faz diferente: ele divide o trabalho em duas metades. A documentação oficial do projeto descreve o uso de "an application processor (such as a low-cost Raspberry Pi)" para calcular os movimentos, enquanto a placa da impressora vira o braço que executa os passos na hora exata.

Essa divisão tem consequência prática. O Klipper agenda cada evento de motor "with a precision of 25 micro-seconds or better", e a mesma página afirma que até microcontroladores 8-bit antigos alcançam "rates over 175K steps per second" — em MCUs mais recentes, "several million steps per second are possible".

Traduzindo para o chão de oficina: com o Klipper, o gargalo deixa de ser a CPU da sua placa. Quem faz a conta pesada é o computador de fora.

Vale desfazer uma confusão comum antes de seguir: firmware não é fatiador. O firmware vive dentro da máquina; o fatiador vive no seu PC e gera o G-code. Se a sua dúvida é qual programa usar para fatiar, o caminho é outro — veja o comparativo entre OrcaSlicer, Cura e PrusaSlicer.

O que você ganha com o Klipper na prática

Na disputa Klipper ou Marlin, três recursos concentram quase todo o ganho que pesa a favor do Klipper.

1. Input shaping. O Klipper "supports 'Input Shaping' to reduce the impact of vibrations on print quality", com o objetivo declarado de reduzir ou eliminar o ringing das peças. Se as suas paredes têm aquele eco fantasma depois de cada canto, é disso que estamos falando — o mesmo defeito que detalhamos no guia sobre ghosting na impressão 3D.

E existe mais de um jeito de aplicar. A documentação de Resonance Compensation lista os shapers ZV, MZV, ZVD, EI, 2HUMP_EI e 3HUMP_EI, ordenados por quanto suavizam a superfície: ZV < MZV < ZVD ≈ EI < 2HUMP_EI < 3HUMP_EI. Quanto mais agressivo o shaper, mais ele mata a vibração — e mais ele arredonda detalhes finos.

Um detalhe importante contra o hype: a própria documentação responde que "no, input_shaper feature has pretty much no impact on the print times by itself". Ele não acelera a impressão sozinho. Ele permite que você acelere sem que a peça fique feia — que é diferente.

2. Pressure advance. O Klipper implementa o "Smooth Pressure Advance" para compensar a pressão dentro do extrusor e reduzir o ooze. A documentação de Pressure Advance informa que "typical pressure advance values are between 0.050 and 1.000 (the high end usually only with bowden extruders)".

A calibração é feita com uma torre de teste via comando TUNING_TOWER, e os valores de partida sugeridos mudam conforme o extrusor: FACTOR=.005 para direct drive e FACTOR=.020 para bowden. Faz sentido — bowden tem muito mais tubo pressurizado, então a diferença entre direct drive e bowden reaparece aqui. Se você quer o passo a passo do conceito, já cobrimos como calibrar o pressure advance.

3. Interface web e macros. Com Klipper vem o ecossistema Moonraker + Mainsail ou Fluidd: você controla e monitora a impressora pelo navegador, e escreve macros próprias em texto. Nada de cartão SD indo e voltando. Isso também abre porta para monitoramento por câmera, assunto que discutimos em detecção de falhas na impressão 3D.

Marlin 2.1.2 mudou a conta: input shaping nativo

Aqui está o ponto que a maioria dos conteúdos em português ainda não atualizou.

O Marlin passou a oferecer ZV Input Shaping a partir da versão 2.1.2. O ajuste é feito pelo G-code M593, que define o fator de amortecimento e a frequência em Hertz dos eixos suportados — e reporta os valores atuais quando chamado sem parâmetros. A All3DP cobriu o lançamento na época, destacando a abertura para imprimir mais rápido mantendo qualidade.

Duas ressalvas honestas, porque elas mudam a decisão:

• A implementação do Marlin é o shaper ZV, aplicado aos eixos X e Y. O Klipper oferece a família inteira de shapers, incluindo os de duplo e triplo corcovado.
• Ativar exige recompilar e regravar o firmware. Não é uma opção de menu no display — é abrir o Marlin no ambiente de compilação, habilitar a feature e subir o binário.

Ou seja: o Marlin fechou boa parte da distância no recurso mais vendido do Klipper, mas fez isso dentro do modelo dele — firmware compilado, sem computador auxiliar. Na prática, isso tira a discussão Klipper ou Marlin do terreno "quem tem o recurso" e joga para o terreno "quanta infraestrutura você quer manter".

O que é preciso para instalar o Klipper

Essa é a parte que costuma ser subestimada. O Klipper não é um arquivo que você joga no cartão SD e pronto.

Segundo a documentação de instalação, você precisa de um sistema baseado em Debian — o Raspberry Pi OS Lite, em 32 ou 64 bits, é a imagem recomendada para Raspberry Pi — com acesso SSH e conexão de internet para baixar os pacotes.

O caminho típico é:

1. Gravar o Raspberry Pi OS Lite em um cartão e habilitar SSH.
2. Instalar Klipper, Moonraker e a interface (Mainsail ou Fluidd). O KIAUH é o instalador de terceiros mais usado para isso, e automatiza a maior parte do processo.
3. Compilar o firmware Klipper para o MCU da sua placa e gravá-lo.
4. Escrever o printer.cfg com os pinos, a cinemática e os limites da sua máquina.

O passo 4 é o que assusta e é onde o tempo vai. Os dois firmwares descrevem a máquina de formas incompatíveis — o Marlin em arquivos de cabeçalho que entram na compilação, o Klipper no printer.cfg lido em tempo de execução —, então a configuração é reconstruída do zero, e não convertida. Quem já mexeu em Linux tende a resolver rápido; quem nunca abriu um terminal deve reservar bem mais tempo.

Custo de hardware: além da impressora, você vai precisar de um computador host (Raspberry Pi ou equivalente), fonte e cartão. Preço varia demais por loja e câmbio — confira o valor atual no varejo brasileiro antes de fechar a conta, porque esse item costuma decidir a migração.

Klipper ou Marlin: comparativo direto

A leitura da tabela é essa: o Klipper ganha em flexibilidade e em ferramentas de calibração; o Marlin ganha em simplicidade e em não depender de nada além da própria máquina.

Quando NÃO vale a pena migrar

Vale dizer o que quase nenhum comparativo de Klipper ou Marlin diz.

Sua impressora já sai de fábrica com Klipper. Vários fabricantes adotaram o firmware. A Creality mantém o código da série K1 publicado no GitHub oficial, e a Sovol abriu estrutura, hardware e firmware da SV08 — uma CoreXY de 350×350×345 mm derivada da Voron 2.4, conforme o repositório oficial. Se é o seu caso, você já tem Klipper. A pergunta vira outra: migrar para o Klipper mainline em vez do fork do fabricante.

Você imprime pouco e sem reclamar. Se as peças saem boas na velocidade atual, migrar resolve um problema que você não tem. O ganho real do Klipper aparece quando você empurra a velocidade — e aí entram também os limites mecânicos da máquina, que nenhum firmware conserta. Se a meta é só ganhar tempo, comece pelas formas de imprimir mais rápido sem perder qualidade.

Você não tem paciência com terminal. Não é demérito. Se editar arquivo de configuração por SSH parece castigo, o Marlin 2.1.2 com input shaping entrega a maior parte do benefício de qualidade sem esse custo.

Sua placa é 8-bit e velha. O Klipper funciona nela — a documentação cita taxas acima de 175K steps/s até em 8-bit — mas você continua limitado por drivers, correias e estrutura. Firmware não vira máquina nova.

Perguntas frequentes sobre firmware de impressora 3D

Klipper deixa a impressão mais rápida?

Não sozinho. A documentação do Klipper afirma que o input shaping "has pretty much no impact on the print times by itself". O que ele faz é reduzir vibração, permitindo que você suba aceleração e velocidade sem o ringing que apareceria antes. O ganho vem do ajuste que você faz depois.

Preciso de acelerômetro para calibrar o input shaping?

Não é obrigatório. O Klipper oferece uma ringing test tower e um método manual: você mede a distância e a contagem das ondulações na peça e calcula a frequência pela fórmula V·N/D em Hz. A documentação afirma que essa precisão "is sufficient for most purposes".

Dá para voltar do Klipper para o Marlin?

Dá. Como o firmware do MCU é regravado nos dois casos, basta compilar e gravar o Marlin novamente na placa. Guarde a configuração original antes de migrar. O trabalho perdido é o do printer.cfg, não o hardware — nada na impressora é alterado fisicamente.

Klipper funciona sem Raspberry Pi?

Funciona, desde que exista um host rodando Linux baseado em Debian, com SSH. A documentação oficial recomenda o Raspberry Pi OS Lite para Raspberry Pi, mas descreve o projeto como agnóstico de hardware. Mini PCs e outras placas single-board são usados pela comunidade com o mesmo papel.

Marlin ainda vale a pena em 2026?

Vale, principalmente depois da 2.1.2 trazer o ZV Input Shaping via M593. Para quem tem uma máquina de entrada, imprime em velocidade moderada e não quer manter um computador ligado junto da impressora, o Marlin atualizado resolve com muito menos infraestrutura.

Klipper ou Marlin: o veredito por perfil

Iniciante com a primeira impressora: fique no Marlin, atualizado. Sua energia rende mais em nivelamento, primeira camada e calibração de material do que em migrar firmware.

Intermediário que quer velocidade e controle: Klipper. Você vai usar os shapers, o pressure advance com tuning tower e as macros — é exatamente o perfil que extrai o benefício inteiro.

Quem já tem Klipper de fábrica: não migre por migrar. Avalie ir para o mainline só se o fork do fabricante estiver travando um recurso que você realmente usa.

Quem imprime para vender: pesa o tempo parado. A migração custa horas e a máquina fica fora do ar; em compensação, a interface web e as macros ajudam na operação diária. Migre em janela de baixa demanda, nunca com pedido na fila.

Escolher entre Klipper ou Marlin não é escolher o firmware "melhor" — é escolher quanto de complexidade você aceita administrar em troca de controle.

Antes de decidir, faça um teste barato: imprima uma torre de ringing na sua máquina hoje e veja o tamanho real do problema. Se as ondulações mal aparecem na velocidade que você usa, o firmware não é o seu gargalo. Se aparecem, você acabou de encontrar o argumento que faltava. Rode o teste e conte nos comentários qual foi o seu resultado.