Guia de uso

Tudo o que dá pra fazer no telinha, do primeiro convite às configurações. Se você só quer começar logo, os três primeiros tópicos bastam.

Criar uma sala#

Abra o telinha e clique em Criar sala. A porta padrão é 7777 e a senha é opcional. Quem cria a sala ganha a coroa e é o admin dela.

A sala fica no seu computador enquanto o telinha estiver aberto. Pra ter uma sala sempre ligada, mesmo com o seu PC desligado, use um servidor dedicado.

Chamar a galera#

No card Chamando a galera de fora:

1. Clique em Abrir porta no roteador. É o caminho direto, com o menor atraso. Funciona na maioria dos roteadores (UPnP, NAT-PMP ou PCP).
2. Se a operadora usa CGNAT, a porta não abre. Aí clique em Criar link público: a sala ganha um endereço que funciona em qualquer rede, sem configurar nada.
3. Clique em Copiar convite e mande pra galera. O botão Convidar, na barra de cima, copia o mesmo convite a qualquer hora.

Quem entra numa sala sem ninguém ao vivo vê no palco os três passos: chamar a galera (com o botão de copiar o convite), compartilhar a tela e, do outro lado, a galera clica em Assistir.

O botão Convidar copia um link da página de convite do site (https://…/telinha/j/#i=…): ele é clicável no Discord e no navegador, abre o app de quem já tem e mostra como instalar pra quem não tem. Dentro dele vai o convite em si (telinha://…), e o que vem depois do # nunca é enviado pro site.

O convite (telinha://…) leva todos os caminhos até a sala: rede local, porta aberta, IPv6 e link público. Cada pessoa entra pelo mais rápido que funcionar pra ela. Ele também leva a impressão digital do servidor, então o app confere que está falando mesmo com a sua sala antes de mandar qualquer coisa.

Não deu certo? O guia de conexão tem todos os outros jeitos: abrir a porta na mão, IPv6, VPN de jogo, túnel por SSH.

Entrar numa sala#

Cole o convite (o link https ou o telinha://) na tela inicial e clique em Entrar. Se o convite já estiver copiado quando você abrir o telinha, ele cola sozinho. Clicar num link telinha:// abre o app: no Windows ele se registra sozinho ao abrir pela primeira vez, no Linux o install.sh registra. Com o telinha já aberto, o link vai pra janela aberta.

Dá pra entrar direto num canal: escreva o nome dele no campo de canal da tela inicial.

Transmitir#

Clique em Compartilhar tela e escolha:

Clique em Ao vivo. Dá pra mudar tudo com a transmissão rolando, sem ninguém perder a imagem.

Várias pessoas podem transmitir ao mesmo tempo. Se todo mundo está vendo você num quadradinho da grade, o telinha manda a transmissão menor (menos placa, menos rede pra todos) e volta a subir na hora em que alguém amplia.

Assistir#

Clique em quem está ao vivo. Várias transmissões ficam numa grade que deixa cada vídeo o maior possível. Se ninguém da sua call está transmitindo mas tem gente ao vivo em outro canal, aparece o botão Tem gente ao vivo no #canal: ir e assistir: um clique e você já está lá, assistindo.

Um bot de tela (como o Telão) se assiste do mesmo jeito. Se ele tem um painel, o painel fica encaixado embaixo do vídeo, com os botões dele (pausar, pular...), enquanto a transmissão dele está sozinha ou em destaque. Bot em outro canal aparece no painel da sala, em Bots em outros canais: clique direito → Chamar pra minha call.

A bolinha do lado do nome de quem transmite diz como a transmissão está chegando: verde flui bem, amarela engasgando, vermelha ruim, e o porquê (sua internet, seu PC, o PC ou a internet de Fulano).

Por cima de qualquer transmissão:

• Ponteiro "olha aqui": aparece pra todo mundo que está vendo.
• Desenhar: 15 cores e 4 espessuras, com marca-texto. Dá pra esconder os desenhos dos outros, e o admin pode tirar o pincel de alguém.
• Clipe: salva os últimos segundos (de 5 s a 10 min, você escolhe) num clique ou num atalho global, em MP4.
• Gravação: MP4 sem recodificar, com o som. Sobrevive a mudança de resolução.
• Print: PNG na resolução da transmissão.

Os clipes e gravações vão pra pasta de vídeos (Vídeos/telinha).

Falar#

Em Configurações → Voz: ativação por voz (com sensibilidade) ou apertar pra falar, que vale até com o jogo em foco; supressão de ruído (tira ventilador, teclado e chiado); cancelamento de eco (caixa de som funciona tão bem quanto fone); ganho automático pra microfone baixo e o volume do microfone.

Chat#

• Enter manda, Shift+Enter quebra a linha.
• Markdown: **negrito**, *itálico*, `código`, blocos de código com botão de copiar e links clicáveis. Emoji colorido.
• Imagens: cole (Ctrl+V, em qualquer lugar da sala) ou arraste pra janela. Uma prévia pergunta antes de mandar: Enter manda, Esc desiste.
• Reações, @menções (quem é mencionado é avisado) e histórico pra quem chega depois.
• Clique direito numa mensagem: copiar, responder citando ou mandar mensagem privada pra quem escreveu.
• Responder citando: a mensagem original aparece em cima da resposta, e quem foi respondido é avisado.
• Mensagem privada: só os dois veem, em qualquer canal. Pelo menu da mensagem, pelo menu da pessoa ou com /msg nome texto.
• Arquivos de até 256 MB: o botão do clipe, arrastar o arquivo pra janela ou /arquivo caminho. Ele sobe uma vez pro servidor e cada um baixa quando clicar, em segundo plano, sem atrapalhar vídeo e voz. No servidor fica cifrado e some depois de 2 horas.
• Cartões de bot: capa, campos, barra de progresso que anda sozinha e botões; clicar num botão manda o clique pro bot, que muda o cartão no lugar.
• Notificações do sistema quando o telinha está em segundo plano.

Canais#

Um servidor pode ter várias salas ao mesmo tempo, como no IRC. Cada canal tem o seu chat, e a call (voz e transmissões) é separada: dá pra ler um canal e continuar na call de outro.

• Clique num canal no painel pra ler o chat dele.
• Clique no ícone de fone do canal pra entrar na call dele. A sua transmissão vai junto.
• O + cria um canal. Ele continua na lista mesmo vazio (e se o servidor reiniciar); só some depois de 3 dias sem ninguém. Os fixados pelo admin ficam pra sempre.
• Quem cria o canal é OP dele, com uma coroa azul do lado do nome na lista (a amarela é do dono da sala). O OP manda no canal: pelo clique direito no canal, senha, trancar, tópico e deixar invisível (fora da lista; entra quem sabe o nome e a senha); pelo clique direito na pessoa, dar OP pra ela, levar ela pra outro canal (um aberto ou um em que você também é OP) e tirar ela do canal sem volta. Em quem criou o canal e em admin o OP não mexe; em outro OP, só quem criou.
• Só quem criou apaga o canal (pede confirmação; quem estava nele volta pro canal padrão) e tira o OP dos outros. O admin da sala pode tudo, em qualquer canal. O canal padrão não tem OP.
• A senha do canal vale pra todo mundo, inclusive pros OPs e pra quem criou: pra entrar, digita a senha (o app lembra dela e volta pro canal sozinho se a internet cair). Só o admin da sala entra sem, e também entra no trancado e vê os invisíveis. Testando com duas janelas no mesmo PC: as duas são a mesma pessoa pro servidor (e, com o token de admin em Opções avançadas, as duas são admin).

Comandos do chat#

Qualquer outra coisa começando com / vai pro chat como texto normal.

Atalhos#

Atalhos globais (funcionam com outro programa em foco, como um jogo): clipe, microfone, surdo, transmitir, print e um que liga e desliga todos. Em Configurações → Atalhos, qualquer tecla, combinação ou botão do mouse.

Para o admin#

Quem cria a sala (ou entra num servidor dedicado com o token de admin) pode, com o clique direito na pessoa: expulsar, banir, silenciar, parar a transmissão, tirar o pincel, dar ou tirar o admin. Também pode trancar a sala, cuidar dos canais e limpar o chat da sala (a borracha no topo, com dois cliques): o histórico de todos os canais e os arquivos somem pra todo mundo, sem reiniciar o servidor.

Num servidor dedicado, o admin vê as estatísticas do servidor: CPU, memória, banda chegando e saindo, gente por canal, quem está atrasando e um palpite em português claro de qual é o gargalo.

Assistir pelo navegador#

Num servidor dedicado com --web, aparece na sala um botão de TV que copia um link. Quem abrir o link assiste pelo navegador, sem instalar nada: vídeo, som da transmissão, voz da call e chat. O servidor só repassa os mesmos quadros, então quem transmite não gasta nada a mais.

Pelo navegador dá pra assistir e conversar no chat; transmitir e falar só pelo app.

Configurações#

O botão da engrenagem abre as configurações, na sala ou na tela inicial.

Atualizações#

O telinha (Windows e Linux) avisa quando sai versão nova, mostra o que muda e instala com um clique, depois de conferir a assinatura da release. Nas configurações dá pra deixar ele instalar sozinho ou pular uma versão. O histórico fica em Configurações → Sobre.

Onde ficam as coisas#

Pra deixar o telinha portátil (num pendrive, por exemplo), as variáveis TELINHA_PASTA_CONFIG e TELINHA_PASTA_CLIPES trocam essas pastas.