Manual de utilização

Do primeiro ecrã ligado até ao que fazer quando alguma coisa corre mal.

1. A ideia em duas linhas

Um projeto é um sítio — uma loja, um congresso, um edifício. Dentro dele há canais (pastas de conteúdo) e players (os ecrãs). Cada ecrã aponta a um canal e mostra o que lá estiver.

O ecrã guarda uma cópia local do que lhe mandas. É por isso que continua a tocar se a rede cair, ou se o servidor for desligado — e é a diferença que mais se nota quando alguma coisa corre mal.

↑ topo

2. Começar — o caminho curto

Do zero a um ecrã a mostrar conteúdo, sem desvios:

Cria um projeto. Na página inicial, em "Novo projeto de trabalho". Dá-lhe o nome do sítio.
Liga o ecrã. Instala o player, ou abre /player_web no browser do próprio ecrã. Aparece um código — algo como WIN_04AA23BC.
Vincula o ecrã ao projeto. No separador ➕ Gerir Players, escreve o código, dá-lhe um nome ("Tablet Entrada") e carrega em Vincular ao projeto.
Cria um canal e envia conteúdo. No separador 📁 Canais, cria uma pasta e arrasta para lá os vídeos ou imagens.
Aponta o ecrã ao canal. No separador 🖥️ Players, escolhe o canal na caixa CANAL.
Carrega em 🔄 Enviar para Player. O ecrã descarrega e começa a tocar.

O passo que toda a gente salta

Mudar o canal no painel não envia os ficheiros. Enquanto não carregares em 🔄 Enviar para Player, o ecrã continua a mostrar o que já tinha. Se um ecrã aparecer com ⚠️ POR PUBLICAR, é exatamente isto.

↑ topo

3. Pôr um ecrã a funcionar

Há quatro formas, e todas acabam no mesmo sítio: um código para vincular.

Ecrã	Como	A saber
Windows	Instalador da página de transferências.	Código começa por `WIN_`.
Android	APK da página de transferências.	Código começa por `AND_`. Serve TV box e tablet.
Mac	.dmg — Apple Silicon (M1 ou mais recente).	O macOS bloqueia à primeira abertura. Ver abaixo.
Web	Abre `/player_web` no browser do ecrã.	Sem instalar nada. Smart TV, Chromebook, PC, iPad e iPhone.

Como o ecrã encontra o servidor

Se o servidor está na mesma rede, o player encontra-o sozinho — não é preciso escrever endereço nenhum.

No Windows, o instalador pergunta (desde a versão 1.5.1): a caixa vem preenchida com o painel na nuvem, e quem tem servidor próprio escreve o endereço dele. Apagar o campo deixa só a procura na rede local.

Para o apontar à mão a um servidor na internet — no Mac, ou para mudar depois de instalado — cria um ficheiro de texto chamado servidor_manual.txt ao lado da aplicação, com o endereço lá dentro (por exemplo https://mysignage.mike-app.com). A procura na rede local continua a correr por trás, e um servidor local encontrado substitui o manual — é de propósito, para levar um ecrã para uma sala fechada sem lhe mexer na configuração.

🍎 "Não pode ser aberto" no Mac

É o macOS, não o ficheiro. A aplicação não está assinada com conta Apple Developer, por isso fica em quarentena ao ser descarregada. Autoriza-se uma vez.

Arrasta para Aplicações, tenta abrir (vai ser recusada), e vai a Definições do Sistema → Privacidade e Segurança → botão "Abrir mesmo assim".

Se disser que "está danificada", a mensagem é enganadora — o ficheiro está bom. No Terminal:

xattr -dr com.apple.quarantine /Applications/MySignage.app

Clique direito → Abrir deixou de funcionar no macOS 15 (Sequoia). Se seguiste essa instrução e não resultou, é por isso — não é o build.

📱 iPad ou iPhone como ecrã

Não há app, e é mesmo assim que se faz. Abre o player web no Safari e usa Partilhar → Adicionar ao ecrã principal — passa a abrir sem as barras do Safari.

Depois: Definições → Ecrã e Brilho → Bloqueio automático: Nunca, senão adormece. Para prender o aparelho só nisto, usa o Acesso Guiado (Definições → Acessibilidade).

O vídeo arranca sem som — é o que o iOS exige para tocar sozinho. Dois toques no ecrã ligam o som.

↑ topo

4. Canais e conteúdo

No separador 📁 Canais. Um canal é uma pasta; o que lá estiver toca em ciclo, por ordem alfabética.

Enviar ficheiros

Arrasta para a zona de envio, ou clica para escolher. Aceita vídeo e imagem — .mp4, .mov, .jpg, .png.

Tudo é convertido automaticamente para um formato que todos os ecrãs tocam sem falhar. Uma imagem passa a ser um vídeo curto — é por isso que aparece como .mp4 depois de enviada. Ficheiros grandes demoram; o painel mostra o progresso.

Ver antes de publicar

O 👁️ ao lado de cada ficheiro abre-o. O 👁️ espelho, no separador Players, mostra a sequência inteira de um canal tal como vai passar — sem ter de ir ao ecrã.

↑ topo

5. O separador Players

Um cartão por ecrã. É aqui que se controla o dia a dia.

Controlo	O que faz
Nome	Clica no título e escreve. Guarda ao sair da caixa.
Canal	Que conteúdo este ecrã mostra.
Rotação	0°, 90°, 180° ou 270° — para ecrãs montados ao alto.
🕐 Relógio	Hora sobreposta, em qualquer canto. Cor, tamanho, e fundo opcional. Funciona por cima de ficheiros e de canais ao vivo.
🔄 Enviar para Player	Manda o ecrã descarregar e aplicar. É este que publica.
🗑️ Esvaziar Player	Apaga a cópia local no aparelho. Não mexe no servidor — volta tudo no próximo envio.
👁️ espelho	A sequência do canal, no teu browser.
📸 ecrã real	Pede ao aparelho uma captura do que ele está mesmo a mostrar.

Espelho ou ecrã real?

O espelho mostra o que devia estar a passar. O ecrã real mostra o que está. Quando os dois não batem certo, encontraste o problema — normalmente um envio que faltou.

Remover, desvincular, esvaziar

Ação	Efeito	Quando
Esvaziar	Limpa os ficheiros no aparelho.	O ecrã mostra coisa antiga ou a mais.
Remover	Tira o ecrã do projeto.	O ecrã mudou de sítio ou de função.
🔓 Desvincular	Solta o ecrã do servidor, e ele volta a procurar sozinho.	Mudar um ecrã do servidor web para um local, sem lhe tocar fisicamente.

↑ topo

6. Agendamentos

Um ecrã tem um canal normal. Um agendamento diz "entre estas horas, mostra outro". Fora dessas horas, volta sozinho ao normal.

🌍 O fuso horário é o dos ecrãs

Não o teu. Podes estar a gerir de outro país — as horas dos agendamentos seguem o sítio onde os ecrãs estão. Define-o no topo do separador, uma vez por projeto.

A faixa de 24 horas em cada ecrã mostra o dia inteiro de relance: os blocos de cor são agendamentos, o cinzento é o canal normal, e a linha vermelha é agora. O cartão ▶️ Agendamentos em execução agora diz o que está a passar neste momento e até que horas.

↑ topo

7. Sincronismo de grupo

Vários ecrãs a arrancar no mesmo instante — para uma parede de ecrãs, ou salas que têm de bater certo.

Cria um grupo e dá-lhe um nome.
Põe os ecrãs no grupo, na lista de baixo.
📁 Aplicar canal — todos passam a mostrar o mesmo.
Espera uns segundos, para acabarem de descarregar.
▶ Sincronizar — todos arrancam juntos.

A ordem importa

Sincronizar antes de aplicar o canal — ou sem dar tempo ao descarregamento — dá ecrãs a arrancar desalinhados. Não é avaria: é o passo 4 que faltou.

↑ topo

8. Parede de ecrãs só Android

Uma imagem repartida por vários ecrãs. Há duas maneiras de a fazer, e são alternativas — não se somam. A primeira é a normal; a segunda existe para quando a resolução por ecrã fizer falta.

Maneira 1 — um ficheiro para todos

Envias um vídeo. Todos os ecrãs recebem o ficheiro inteiro, e o servidor diz a cada um «mostra este retângulo». O corte acontece no ecrã, no momento de mostrar — o servidor nunca corta vídeo nenhum.

A favor: um ficheiro só; a ordem dos pedaços é impossível de baralhar; mudar a montagem é arrastar retângulos, sem reconverter nada.
Contra: a resolução divide-se. Um master UHD repartido por quatro ecrãs dá 960×540 a cada um.

Os três elementos do desenho

Na aba Parede há sempre estas três coisas, e vale a pena não as confundir:

Tela — a área de trabalho, com a forma que escolheres (16:9, 21:9, à medida em pixéis…). É o palco, e não tem de ser do tamanho do vídeo.
Media — o teu ficheiro: o retângulo tracejado azul, no sítio onde assenta na tela. Escreves-lhe o tamanho e arrastas para a posição.
Peças — os ecrãs, a verde, por cima. Cada um mostra o que estiver debaixo dele: imagem onde a media está, preto onde não está.

Podes escrever as medidas em percentagem da tela ou em pixéis dela, escolher a peça pelo seletor (útil quando uma está por baixo de outra), e ligar ou desligar o mapeamento sem perder o desenho.

Um master grande de mais fica preto — não fica pequeno

Um descodificador não abre «só um bocado» de um vídeo: ou lê o frame inteiro ou recusa. Uma Chromecast declara 4096 px de largura; um master de 5376 deixa-a preta, e só se descobre no sítio. Por isso, quando o ficheiro for para uma parede, envia-o com a caixa «parede ou ecrã ao alto»: o conversor reduz até caber num UHD mantendo a forma, em vez de o assentar numa tela de 1920×1080 com o preto gravado nos pixéis.

A mesma caixa serve para um ecrã ao alto

Um vídeo vertical enviado sem ela sai deitado numa tela de 1920×1080, com duas barras pretas gravadas nos próprios pixéis. Depois disso nenhuma rotação o salva: roda o conjunto todo, barras incluídas, e o ecrã ao alto fica com uma faixa ao meio.

São dois casos com a mesma razão — parede e ecrã ao alto: sempre que o vídeo não vai ocupar uma tela deitada inteira, o preto não pode ser gravado no ficheiro.

Maneira 2 — um ficheiro por ecrã

Cortas tu os pedaços no editor: quatro ficheiros, cada um em Full HD. Cada ecrã fica no seu canal, com o seu ficheiro, e o sincronismo continua a ser o que os junta — ele alinha o instante de arranque, e isso não exige que estejam a tocar o mesmo.

Liga-se no cartão do grupo, em 🧩 cada ecrã com o seu ficheiro. Sem isso, canais diferentes travam o disparo de propósito — porque quase sempre são engano.

A favor: Full HD por ecrã. Numa tira de quatro, quatro vezes mais pixéis do que um master único repartido.
Contra: quatro ficheiros para gerir; a mesma duração e o mesmo ritmo em todos (se divergirem, o ciclo de cada um acaba noutra altura e nenhum realinhamento resolve — o painel avisa); e a ordem é tua, o servidor não sabe qual pedaço é qual.

Rotação e ecrãs em falta

Numa parede a rotação fica fixa — rodar um ecrã sozinho desalinhava a imagem toda. E um ecrã desligado não faz os outros recalcularem nada: fica como se lá estivesse, mas sem corrente. A norma é a de um ledwall: o que não está mapeado não se vê.

↑ topo

9. Canais ao vivo

Um canal ao vivo não guarda ficheiros: os ecrãs ligam-se a um sinal em direto. A primeira pergunta é sempre de onde vem o vídeo.

🎥 Vou transmitir eu (OBS, vMix, Streamlabs…)

Escolhe só um nome. O endereço e a chave são gerados aqui, e aparecem prontos a copiar. No OBS: Definições → Transmissão → Serviço «Personalizado», e cola nos campos Servidor e Chave de transmissão. No vMix, o mesmo em RTMP Server.

Cola a chave inteira

A chave acaba em ?user=…&pass=…. Não são campos separados — se cortares a partir do ?, a ligação é recusada e não é óbvio porquê.

🔗 O sinal já existe noutro lado

Para uma câmara, outro servidor, ou um canal público de que já tenhas o endereço (normalmente acaba em .m3u8). Aqui não é gerado nada — os ecrãs ligam-se ao endereço que colares.

Mostrar a alguém sem dar acesso ao painel

🔗 Criar link para ver este canal gera um endereço que abre o direto numa página, e mais nada. Podes gerar um novo link (o anterior deixa de funcionar) ou desativá-lo a qualquer momento.

O nome do canal

É só uma etiqueta para te orientares na lista. Não vai para o software de streaming, não aparece a quem vê, e podes pôr o que quiseres.

As emissões fecham sozinhas

Uma emissão esquecida a consumir banda a um fim de semana inteiro é dinheiro a arder. Ao fim de 24 horas fecha sozinha, com avisos por email antes — o último a 2 minutos do fim. Basta responder ao aviso para a prolongar.

↑ topo

10. Truques que salvam o dia

🔌 Conteúdo por pen USB

Espeta uma pen com ficheiros .mp4 na raiz e o ecrã passa a tocá-los. Tira a pen e volta ao normal. Não precisa de rede, nem de servidor, nem do painel — serve para a véspera de um evento em que nada mais funciona.

🏠 Servidor na tua própria rede

Há uma versão do servidor para correr na tua máquina, grátis, na página de transferências. Os ecrãs encontram-no sozinhos e o vídeo nunca sai do edifício. É a opção certa para uma sala sem internet fiável.

🎛️ Botão físico (Companion / Stream Deck)

Em Gerir Players podes gerar um token e usar os endereços que aparecem num botão HTTP do Bitfocus Companion — trocar de canal ou rodar um ecrã sem abrir o painel. Regenerar o token invalida os botões já configurados.

↑ topo

11. Quando corre mal

O que vês	Quase sempre é	O que fazer
Ecrã ⚠️ POR PUBLICAR	Mudaste alguma coisa e não enviaste.	🔄 Enviar para Player.
Ecrã a mostrar conteúdo antigo	O envio não chegou, ou sobrou ficheiro velho.	Esvaziar Player, depois Enviar.
Bola cinzenta (offline)	Sem rede, ou aparelho desligado.	O ecrã continua a tocar o que tinha. Vê rede e corrente.
"Sem conteúdo ainda"	Canal vazio, ou nunca houve envio.	Confirma que o canal tem ficheiros e envia.
Direto não aparece	O software de streaming não está a publicar, ou a chave foi cortada.	Confirma que está a transmitir e que colaste a chave inteira.
Ecrãs do grupo desalinhados	Sincronizaste cedo demais.	Aplicar canal → esperar → Sincronizar.
Mac: "não pode ser aberto"	Quarentena do macOS.	Privacidade e Segurança → "Abrir mesmo assim".
Envio recusado	Sem espaço no servidor.	Apaga conteúdo que já não usas. O painel avisa antes de chegar lá.

🐞 Continua sem fazer sentido?

Há um Reportar um problema na página dos projetos. Diz o que estavas a fazer e o que aconteceu — chega com a página onde estavas, o que poupa metade das perguntas.

↑ topo

12. O que convém saber

Isto não é um arquivo

Guarda sempre os teus ficheiros originais. O conteúdo fica no servidor e dentro de cada ecrã, mas as cópias de segurança levam contas, projetos e definições — os vídeos não vão nelas.

Os ecrãs sobrevivem ao servidor

Se o servidor for abaixo, os ecrãs continuam a tocar o que já têm. O que para é o painel e os canais ao vivo. Um ecrã com conteúdo em ficheiros pode passar dias sem dar por nada.

Espaço

O painel avisa quando o disco começa a encher e recusa envios antes de partir alguma coisa. Apagar conteúdo que já não usas é a manutenção normal — e nada disso afeta o que os ecrãs já descarregaram.

Privacidade

De quem vê os canais ao vivo não é guardado o endereço — fica só uma marca irreversível, que serve para contar pessoas diferentes e não para saber quem são. Os registos técnicos do servidor guardam endereços 14 dias, por segurança, e depois desaparecem.

↑ topo