# eTotem Printer

O eTotem Printer é o programa instalado no computador Windows ligado à impressora de senhas. Ele faz duas coisas:
- abre a tela do totem para o tablet, pela rede local;
- imprime as senhas na impressora térmica ligada a esse computador.
Todos os tablets da empresa usam o mesmo computador.
Não precisa de Java
Diferente da versão anterior, o eTotem Printer não precisa de Java nem de nenhum outro programa instalado. Basta o arquivo .zip.
# 1 - Instale a impressora
Instale a impressora que vai imprimir as senhas e confirme que ela aparece em Configurações > Dispositivos > Impressoras e scanners.
O nome da impressora não importa: o eTotem Printer encontra a impressora térmica sozinho. Ele reconhece as famílias Epson TM, Zebra, Bematech, Elgin e Daruma, e também as impressoras com Receipt no nome. Nas impressoras Zebra, a etiqueta sai em ZPL. Nas demais, sai em ESC/POS.
ATENÇÃO
Se nenhuma impressora térmica for reconhecida, a senha sai na impressora padrão do Windows, que pode ser um gerador de PDF. Veja como escolher a impressora.
# 2 - Instalação do eTotem Printer
Download - eTotemPrinter.zip
ATENÇÃO
Se o computador já tem a versão anterior do servidor de impressão (a que pedia Java), desinstale-a antes em Configurações > Aplicativos > Adicionar ou remover programas. As duas versões usam a porta 80 e não funcionam ao mesmo tempo.
ATENÇÃO
Confira se outro programa não está usando a porta 80, como o IIS ou o Skype.
- Baixe o eTotemPrinter.zip, ou pegue-o na seção de downloads.
- Descompacte o arquivo: clique com o botão direito nele e escolha Extrair tudo.
- Abra a pasta totem que foi extraída. Ela tem os arquivos
etotem-printer.exe,instalar.bat,desinstalar.bat,printer.jsoneLEIA-ME.txt.- Clique com o botão direito em instalar.bat e escolha Executar como administrador.
- Aguarde a mensagem Pronto e pressione qualquer tecla para fechar a janela.
ATENÇÃO
Não execute o instalar.bat de dentro do .zip, sem descompactar: ele precisa dos outros arquivos da pasta totem ao lado dele.
OBS
O Windows pode avisar que protegeu o computador, porque o programa não tem assinatura digital. Clique em Mais informações e depois em Executar assim mesmo.
Se algo der errado, a janela mostra Falhou, e o motivo fica no arquivo printer.log, em C:\Program Files\eTotem Printer.
# Confira se o serviço subiu
No navegador do próprio computador, abra:
http://localhost/status
Deve aparecer um texto com a versão e a impressora escolhida, parecido com este:
{
"versao": "0.1.0",
"porta": 80,
"colunas": 42,
"linguagem": "escpos",
"configurada": "",
"destino": "EPSON TM-T88V Receipt",
"origemDestino": "termica",
"motivoDestino": "única térmica entre as 2 impressoras físicas de um total de 4",
"ultimaImpressao": null
}
O campo destino diz em qual impressora as senhas vão sair, e origemDestino diz como ela foi escolhida:
| origemDestino | Significado |
|---|---|
configurada | o nome escrito no printer.json |
termica | a impressora térmica foi reconhecida sozinha |
padrao-do-sistema | nenhuma térmica foi reconhecida, e está usando a padrão do Windows |
# 3 - Abra o eTotem no Tablet
Descubra o IP fixo do computador onde o eTotem Printer foi instalado. No Prompt de Comando, rode
ipconfig. Depois, no navegador do tablet (de preferência o Google Chrome), abra esse endereço.
Exemplo:
http://192.168.0.100
Deve aparecer a seguinte tela:

OBS
Faça os testes de impressão de senha.

ATENÇÃO
A tela abre em http://localhost/ no computador mas não abre no tablet? É o firewall.
Execute o instalar.bat de novo, como administrador, para recriar a regra da porta 80.
# 4 - Monitorando a comunicação
# Pelo navegador
No computador do eTotem Printer, abra http://localhost/status. O campo ultimaImpressao mostra a última senha que chegou, quando chegou, em qual impressora e se deu certo:
"ultimaImpressao": {
"quando": "2026-09-16T10:42:07.512-03:00",
"senha": "A001",
"fila": "Atendimento Geral",
"impressora": "EPSON TM-T88V Receipt",
"sucesso": true
}
Quando a impressão falha, sucesso vem
falsee o campo erro explica o motivo. Se oprinter.jsontiver algum erro, o campo configInvalida aparece: o serviço continua funcionando, mas com as configurações padrão.
# Pelo arquivo de log
O eTotem Printer é instalado em C:\Program Files\eTotem Printer. Nessa pasta, abra o arquivo printer.log. Cada senha impressa gera uma linha:
time=2026-09-16T10:40:01.203-03:00 level=INFO msg="eTotem Printer no ar" versao=0.1.0 porta=80 colunas=42 front=true
time=2026-09-16T10:42:07.512-03:00 level=INFO msg="senha impressa" senha=A001 fila="Atendimento Geral"
Falhas aparecem com
level=ERROR msg="falha ao imprimir". Se o serviço nem chega a iniciar, o motivo fica registrado no Visualizador de Eventos do Windows, com a origem eTotemPrinter.
# Trocar a impressora
Para escolher a impressora manualmente, abra http://localhost/impressoras no computador do eTotem Printer. Ele lista os nomes exatos das impressoras, do jeito que o Windows os escreve.
Depois edite o arquivo printer.json, em C:\Program Files\eTotem Printer, e escreva o nome no campo impressora:
{
"porta": 80,
"impressora": "EPSON TM-T88V Receipt",
"linguagem": "escpos",
"colunas": 42
}
| Campo | Padrão | O que é |
|---|---|---|
impressora | "" | nome exato da impressora; vazio = encontrar a térmica sozinho |
linguagem | escpos | escpos para as impressoras de recibo, zpl para as Zebra. Só vale quando impressora está preenchida |
colunas | 42 | largura da bobina de 80mm |
porta | 80 | não altere: o tablet espera a porta 80 |
Salve o arquivo e reinicie o serviço eTotem Printer no Gerenciador de Tarefas, aba Serviços.
ATENÇÃO
Um nome que não existe no Windows é tratado como erro: o eTotem Printer não troca para outra impressora por conta própria.
Para voltar à escolha automática, deixe o campo vazio: "impressora": "".
ATENÇÃO
Ao escrever o nome de uma impressora Zebra, escreva também "linguagem": "zpl". Com escpos, a impressão parece dar certo, mas nenhum papel sai.
# Atualizar
Baixe o
.zipnovo e repita a instalação. Oinstalar.batpara e remove a versão instalada antes de copiar a nova, e não sobrescreve oprinter.jsonque já está no computador.
# Desinstalar
Use um dos dois caminhos:
- Configurações > Aplicativos > Adicionar ou remover programas, procure por eTotem Printer e clique em Desinstalar. O Windows vai pedir a confirmação de administrador.
- Ou clique com o botão direito em desinstalar.bat e escolha Executar como administrador. Esse arquivo fica na pasta totem do
.zipe também em C:\Program Files\eTotem Printer.
A desinstalação para e remove o serviço, a regra da porta 80 no firewall e o programa.
OBS
O printer.json e o printer.log são mantidos em C:\Program Files\eTotem Printer, tanto na desinstalação quanto na atualização.