Converter HTML para JPG via Linha de Comando — Conversor em Lote para Servidores

Você precisa renderizar páginas HTML como imagens JPG em um servidor — para miniaturas, arquivos, pré-visualizações de e-mail ou screenshots de produtos em um pipeline de e-commerce. Subir um navegador headless para cada conversão é pesado, lento e frágil entre atualizações do navegador. O Total HTML Converter X renderiza arquivos HTML e URLs ao vivo para JPG pela linha de comando, em lote, sem instalação de navegador. Instale-o em um servidor Windows, chame-o a partir de um script ou via ActiveX e deixe-o rodar sem supervisão.

O que o Total HTML Converter X faz

• Saída JPG em lote — passe um curinga (*.html) e o conversor renderiza todos os arquivos correspondentes para JPG em uma única execução
• Controle de qualidade — defina a qualidade JPEG de 1 a 100 para equilibrar tamanho do arquivo com fidelidade da imagem
• Dimensões da imagem — limite a largura ou altura de saída; o conversor escala a renderização para se ajustar
• Renderização de URL ao vivo — passe uma URL em vez de um caminho de arquivo e o conversor busca a página e a renderiza para JPG
• Renderização CSS — reconhece todas as tags HTML, estilos CSS 1 e CSS 2, imagens inline e tabelas
• Combinar páginas — renderize a saída HTML multi-página como um único JPG alto em vez de imagens separadas
• Sem interface gráfica — executa silenciosamente pela linha de comando, sem janelas pop-up ou caixas de diálogo de confirmação
• ActiveX / COM — chame o conversor a partir de .NET, VBScript, PHP, Python ou qualquer ambiente compatível com COM para incorporar a conversão em sua própria aplicação
• Scripts .bat — salve comandos em arquivos de lote e agende-os com o Agendador de Tarefas do Windows para conversão totalmente automatizada

Windows 7/8/10/11 • Server 2008/2012/2016/2019/2022

HTML vs JPG: por que converter?

HTML é uma linguagem de marcação projetada para navegadores. Uma página HTML é construída a partir de texto, regras CSS, imagens incorporadas e recursos externos. A renderização depende do motor do navegador, das fontes instaladas e do tamanho da tela. O mesmo HTML pode parecer diferente no Chrome, Firefox e Edge, e pode quebrar completamente quando recursos externos estão indisponíveis.

JPG é um formato de imagem raster fixo. Captura a página renderizada exatamente como ela apareceu no momento da conversão, não incorpora nada externo e abre em qualquer visualizador de imagens, navegador e plataforma de mídia social. Arquivos JPG são pequenos, fáceis de incorporar e ideais para miniaturas, pré-visualizações e snapshots de arquivamento.

Como converter HTML para JPG pela linha de comando

Passo 1. Instale o Total HTML Converter X

Baixe o instalador pelo link acima e execute-o no seu servidor ou estação de trabalho Windows. A instalação leva menos de um minuto. Sem navegador, sem Microsoft Office, sem pré-requisito .NET — o conversor já vem com seu próprio motor de renderização que processa tags HTML, estilos CSS 1/2 e imagens incorporadas.

Passo 2. Abra o prompt de comando

Abra o cmd.exe ou PowerShell. O executável do conversor é HTMLConverter.exe, localizado na pasta de instalação (normalmente C:\Program Files\CoolUtils\TotalHTMLConverterX\). Adicione-o ao PATH do sistema ou use o caminho completo nos seus comandos.

Passo 3. Execute a conversão JPG básica

O comando mais simples converte todos os arquivos HTML de uma pasta para JPG:

HTMLConverter.exe C:\Pages\*.html C:\Output\ -c JPEG

Isso processa cada arquivo .html em C:\Pages\ e salva um .jpg com o mesmo nome base em C:\Output\. Um arquivo HTML entra, um JPG sai.

Passo 4. Defina qualidade e dimensões

Controle a saída JPG com flags adicionais:

HTMLConverter.exe C:\Pages\*.html C:\Output\ -c JPEG -ImgQuality 90 -ImgWidth 1024

• -ImgQuality 90 — qualidade JPEG de 1 (menor, com blocos visíveis) a 100 (maior fidelidade, maior arquivo). 85–92 é o ponto ideal típico.
• -ImgWidth 1024 — largura de saída em pixels; o conversor escala a renderização para se ajustar
• -ImgHeight 768 — altura de saída em pixels; combine com a largura ou use uma ou outra
• -combine — renderiza o documento HTML inteiro como um único JPG alto em vez de paginar
• -log C:\Logs\html2jpg.log — grava um log de conversão para verificação

Passo 5. Converta uma URL ao vivo

Passe uma URL em vez de um caminho de arquivo:

HTMLConverter.exe https://example.com/report C:\Output\report.jpg -c JPEG -ImgQuality 90

O conversor busca a página (incluindo folhas de estilo e imagens remotas) e renderiza o resultado para JPG. Isso é útil para arquivar páginas web ao vivo, tirar screenshots automatizados e gerar imagens de pré-visualização sob demanda.

Passo 6. Automatize com um arquivo .bat

Salve seu comando em um arquivo .bat e agende-o com o Agendador de Tarefas do Windows:

@echo off
"C:\Program Files\CoolUtils\TotalHTMLConverterX\HTMLConverter.exe" C:\Incoming\*.html C:\Archive\JPG\ -c JPEG -ImgQuality 90 -ImgWidth 1280 -log C:\Logs\html2jpg.log

Isso roda em qualquer intervalo que você definir (por hora, todas as noites, na chegada do arquivo via um watcher) e grava um arquivo de log para que você possa verificar os resultados sem assistir ao console.

Integração ActiveX / COM

O Total HTML Converter X inclui uma interface ActiveX completa. Você pode chamar o conversor a partir de qualquer ambiente compatível com COM — .NET, VBScript, PHP, Python, Ruby ou ASP. Isso permite incorporar a renderização de HTML para JPG em sua própria aplicação web, portal de intranet ou fluxo de documentos sem executar um processo de linha de comando separado.

Exemplo (C#/.NET):

HTMLConverterX Cnv = new HTMLConverterX();
Cnv.Convert("C:\\Pages\\report.html", "C:\\Output\\report.jpg", "-c JPEG -ImgQuality 90 -ImgWidth 1024");

Exemplo (PHP):

$c = new COM("HTMLConverter.HTMLConverterX");
$c->convert("C:\\Pages\\report.html", "C:\\Output\\report.jpg", "-c JPEG -ImgQuality 90");

A mesma chamada funciona a partir de ASP.NET, VBScript, Python, Ruby, Perl e JavaScript (Windows Script Host). Sua aplicação web pode aceitar um HTML enviado ou uma URL e retornar um JPG renderizado ao usuário em tempo real.

Conversores online vs Total HTML Converter X

For a one-off page, our free online convert HTML to JPG tool runs in the browser with no install. For server pipelines and bulk batches, Total HTML Converter X is the right choice.

Quando você precisa de conversão HTML para JPG por linha de comando

• Geração de miniaturas. Um sistema de gerenciamento de conteúdo armazena artigos como HTML. O CMS chama o Total HTML Converter X via ActiveX para produzir miniaturas JPG para a página inicial, pré-visualizações de mídia social e listagens de categoria.
• Screenshots de produtos de e-commerce. Uma loja online renderiza páginas de detalhes de produtos (templates HTML) para JPG para incorporação em e-mails de marketing, folhas de vendas e feeds de parceiros. O conversor roda todas as noites no catálogo.
• Arquivamento de páginas web. Equipes de conformidade precisam preservar o estado visual de uma página web em um determinado momento. A linha de comando recebe uma lista de URLs e produz uma pasta de snapshots JPG, um por página, com timestamps nos nomes dos arquivos.
• Renderização segura para e-mail. Clientes de e-mail bloqueiam imagens remotas e quebram HTML complexo. Pré-renderizar uma newsletter ou fatura HTML para JPG dá a cada destinatário uma visão idêntica, independentemente do cliente de e-mail.
• Geração de pré-visualizações no servidor. Um portal de documentos permite que usuários enviem arquivos HTML. O portal chama o conversor para produzir uma pré-visualização JPG mostrada ao lado de cada upload, sem subir um navegador headless.
• Substituindo pipelines de navegador headless. Chrome headless e Puppeteer são pesados, frágeis entre atualizações de versão e exigem sandboxing cuidadoso. O Total HTML Converter X é um único executável com uso previsível de recursos e sem a esteira de atualizações do navegador.

Por que escolher o Total HTML Converter X

Sem necessidade de navegador

O conversor usa seu próprio motor de renderização para analisar HTML e CSS. Você não precisa ter Chrome, Firefox ou qualquer navegador instalado no servidor. Isso elimina problemas de atualização do navegador, reduz o uso de recursos do servidor e evita a instabilidade da automação de navegadores headless.

Aplicação verdadeira para servidores

O Total HTML Converter X foi projetado para uso autônomo. Sem janelas de interface, sem caixas de diálogo, sem solicitações de confirmação. Ele executa silenciosamente pela linha de comando ou como parte de um serviço — exatamente o que um servidor de produção precisa.

Saída de imagem previsível

Defina qualidade, defina dimensões, defina se deve combinar a saída multi-página. Cada chamada produz um resultado idêntico para entrada idêntica. Sem deriva de versão, sem surpresas de renderização após uma atualização do Chrome.

Uma ferramenta, muitos destinos

A mesma ferramenta de linha de comando converte HTML para PDF, DOC, XLS, TIFF, JPG, RTF, TXT e mais. Uma instalação cobre todas as necessidades de conversão HTML. Altere -c JPEG para -c PDF ou -c TIFF e você obtém a saída alternativa com os mesmos recursos de lote e automação.

Windows 7/8/10/11 • Server 2008/2012/2016/2019/2022

string src  = @"C:\test\Source.html";
string dest = @"C:\test\Dest.pdf";

var cnv = new HTMLConverterX();
cnv.Convert(src, dest, "-cPDF -log c:\\test\\HTML.log");

if (!string.IsNullOrEmpty(cnv.ErrorMessage))
    throw new Exception(cnv.ErrorMessage);

public static class Function1
    {
        [FunctionName("Function1")]
        public static async Task Run(
            [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
            ILogger log)
        {
            StringBuilder sbLogs = new StringBuilder();
            sbLogs.AppendLine("started...");
            try
            {
                ProcessStartInfo startInfo = new ProcessStartInfo();
                startInfo.CreateNoWindow = true;
                startInfo.UseShellExecute = false;
                var assemblyDirectoryPath = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
                assemblyDirectoryPath = assemblyDirectoryPath.Substring(0, assemblyDirectoryPath.Length - 4);

                var executablePath = $@"{assemblyDirectoryPath}\Converter\HTMLConverterX.exe";
                sbLogs.AppendLine(executablePath + "...");
                var srcPath = $@"{assemblyDirectoryPath}\src\sample.html";
                var outPath = Path.GetTempFileName() + ".pdf";
                startInfo.FileName = executablePath;

                if (File.Exists(outPath))
                {
                    File.Delete(outPath);
                }

                if (File.Exists(executablePath) && File.Exists(srcPath))
                {
                    sbLogs.AppendLine("files exists...");
                }
                else
                    sbLogs.AppendLine("EXE & source files NOT exists...");
                startInfo.WindowStyle = ProcessWindowStyle.Hidden;
                startInfo.Arguments = $"\"{srcPath}\" \"{outPath}\" -cPDF";
                using (Process exeProcess = Process.Start(startInfo))
                {
                    sbLogs.AppendLine($"wait...{DateTime.Now.ToString()}");
                    exeProcess.WaitForExit();
                    sbLogs.AppendLine($"complete...{DateTime.Now.ToString()}");
                }
                sbLogs.AppendLine("Conversion complete.");
            }
            catch (Exception ex)
            {
                sbLogs.AppendLine(ex.ToString());
            }

            return new OkObjectResult(sbLogs);
        }
    }

dim C
Set C=CreateObject("HTMLConverter.HTMLConverterX")
C.Convert "c:\source.html", "c:\dest.jpg", "-cJPG -log c:\html.log"
C.Convert "https://www.coolutils.com/", "c:\URL Page.pdf", "-cPDF -log c:\html.log"
Response.Write C.ErrorMessage
set C = nothing

dim C
Set C=CreateObject("HTMLConverter.HTMLConverterX")
Response.Clear
Response.AddHeader "Content-Type", "binary/octet-stream"
Response.AddHeader "Content-Disposition", "attachment; filename=test.pdf"
Response.BinaryWrite C.ConvertToStream("C:\www\ASP\Source.html", "C:\www\ASP", "-cpdf -log c:\html.log")
set C = nothing

$src="C:\\test\\test.html";
$dest="C:\\test\\test.pdf";
if (file_exists($dest)) unlink($dest);
$c= new COM("HTMLConverter.HTMLConverterX");
$c->convert($src,$dest, "-cPDF -log c:\\HTML.log");
if (file_exists($dest)) echo "OK"; else echo "fail:".$c->ErrorMessage;

require 'win32ole'
c = WIN32OLE.new('HTMLConverter.HTMLConverterX')

src = "C:\\test\\test.html"
dest = "C:\\test\\test.pdf"

c.convert(src, dest, "-cPDF -log c:\\test\\HTML.log")

if not File.exist?(dest)
  puts c.ErrorMessage
end

import win32com.client
import os.path

c = win32com.client.Dispatch("HTMLConverter.HTMLConverterX")

src  = "C:\\test\\test.html"
dest = "C:\\test\\test.pdf"

c.convert(src, dest, "-cPDF -log c:\\test\\HTML.log")

if not os.path.exists(dest):
    print(c.ErrorMessage)

uses Dialogs, Vcl.OleAuto;

var
  c: OleVariant;
begin
  c := CreateOleObject('HTMLConverter.HTMLConverterX');
  c.Convert('c:\test\source.html', 'c:\test\dest.pdf', '-cPDF -log c:\test\HTML.log');
  if c.ErrorMessage <> '' then
    ShowMessage(c.ErrorMessage);
end;

var c = new ActiveXObject("HTMLConverter.HTMLConverterX");
c.Convert("C:\\test\\source.html", "C:\\test\\dest.pdf", "-cPDF");
if (c.ErrorMessage != "")
  alert(c.ErrorMessage)

use Win32::OLE;

my $src  = "C:\\test\\test.html";
my $dest = "C:\\test\\test.pdf";

my $c = CreateObject Win32::OLE 'HTMLConverter.HTMLConverterX';
$c->convert($src, $dest, "-cPDF -log c:\\test\\HTML.log");
print $c->ErrorMessage if -e $dest;