Vamos conectar seus dispositivos.

Primeiros passos

Baixe o app para Mac 2.1 (macOS 14 ou posterior) e obtenha o MeowDisplay para iPhone e iPad na App Store (iOS ou iPadOS 16.4 ou posterior). O guia de configuração explica a instalação, as permissões e a primeira conexão.

Mantenha o receptor aberto e verifique se os dois apps são compatíveis. Os apps 2.1 para Mac e iOS são versões públicas; o app para Android 2.0 está em teste fechado no Google Play e funciona com o app para Mac 2.0 ou posterior.

Beta do Android

O receptor para Android 2.0 está disponível para testadores do teste fechado do Google Play e funciona com o app para Mac 2.0 ou posterior. Com o app para Mac 2.1, a tela do Android escurece enquanto o Mac está bloqueado e volta quando você desbloqueia o Mac no próprio Mac. Entre no programa de acesso antecipado para Android, inscreva-se no Google Play com a mesma conta e instale o beta privado. É preciso um emissor no Mac para as sessões ao vivo; o “Try the Demo” funciona offline.

No Android, não há suporte a USB. Conecte-se pelo Wi-Fi local ou por uma rede privada (como o Tailscale). O dispositivo precisa estar pareado antes de iniciar uma sessão confiável. Em um relatório de bug, informe a versão do Android, o modelo do celular/tablet e se o teste foi feito em um dispositivo real ou em um emulador.

Pareamento

Compare o código nos dois dispositivos e aceite somente se for igual. Se um dispositivo já confiável mostrar “Pair” inesperadamente, reinicie primeiro os dois apps. Se o problema continuar, esqueça o dispositivo de propósito e pareie de novo.

Nunca aceite uma solicitação de pareamento inesperada sem conferir as duas telas.

macOS 15: se o app para Mac fechar sozinho logo depois que você aprova o pareamento, é um problema conhecido (#219). O MeowDisplay 2.1 inclui uma correção proposta que ainda não foi verificada no macOS 15; se puder testá-la, adicione à issue o que você observar. Uma falha pelo Tailscale ainda está sendo investigada.

Espelhar e estender

Tela preta: verifique a permissão de Gravação do Áudio do Sistema e da Tela no Mac e confirme se a transmissão está conectada e não está pausada.

Mirror indisponível: é necessária uma tela física ativa. Um notebook fechado sem uma tela externa ativa pode não oferecer uma. Escolha Extend; ele cria a própria tela e não precisa de emulador de monitor.

A sessão para quando a tampa é fechada: para usar com a tampa fechada, mantenha o MacBook conectado à energia e use Extend no iPhone ou iPad.

Extend indisponível: ative a captura de vídeo. Abra Displays, escolha Extend e use Arrange Displays… para conferir onde a tela extra está posicionada.

Áudio

Confirme se a sessão está conectada e em reprodução e, em seguida, verifique o volume do receptor e a saída de áudio do Mac. Quem inicia o áudio é o dispositivo receptor; os ajustes de Streaming do Mac informam o estado. Reconecte se o receptor estiver mostrando um quadro antigo em vez de uma sessão ao vivo.

Entrada e gestos

Conceda a permissão de Acessibilidade no Mac, ative Allow Input e retome qualquer transmissão pausada. Tocar e arrastar usam um dedo; rolar usa dois. Um toque com três dedos abre o Spotlight.

Se a entrada ainda falhar, abra os apps de novo depois de alterar as permissões. Anote também se você usou Natural Touch, Classic, Trackpad ou Window view. Conectar-se, por si só, nunca libera a entrada; use Request Control no receptor. Informe o gesto ou a ação de teclado e se você estava em Mirror, Extend ou Window view.

Window view e janelas flutuantes

Sem opções de Float: as janelas flutuantes exigem o MeowDisplay 2.1 tanto no Mac quanto no iPhone ou iPad, e Enable Floating Windows ativado em Settings ▸ Controls ▸ Window Switcher. Elas não estão disponíveis no Android nem no Mac Receiver.

Uma janela flutuante sumiu: procure uma faixa fina em uma das bordas da tela e toque nela. Várias janelas flutuantes em uma borda cheia compartilham uma única alça; toque nela para ver um menu que lista essas janelas. Se você estiver conectado a um Mac sem janelas flutuantes, elas ficam guardadas na borda até você se conectar a um Mac que tenha o recurso.

Redimensionar a janela flutuante não mudou a janela do Mac: isso é esperado. A alça do canto só muda a visualização no dispositivo. Use Fill Window on Mac para redimensionar a janela real; isso exige o controle do Mac e o MeowDisplay 2.1 no Mac. Restore Previous Size on Mac aparece quando há um tamanho anterior para restaurar.

Uma caixa de diálogo Abrir ou Salvar em um painel não responde: com o MeowDisplay 2.1 no Mac, essas caixas de diálogo recebem os toques onde são desenhadas. Se os botões da caixa de diálogo ficarem escondidos atrás dos controles do MeowDisplay, pressione Esc para cancelar ou Return para confirmar.

“No … Window to Show”: o app está aberto no Mac, mas não tem nenhuma janela. Escolha Show a Window on Mac para trazê-lo para a frente no Mac e fazê-lo abrir uma janela, ou Choose a Window.

“This pane’s window was closed on the Mac.” Escolha Choose Window para mostrar outra janela nesse painel, ou Remove Pane.

Os painéis dizem que estão pausados por causa do Mission Control: o Mission Control está aberto no Mac. Escolha Exit Mission Control ou pressione Esc no Mac.

Como fazer: Window view e janelas flutuantes.

Teclado

O que você digita não chega ao Mac: primeiro, o controle precisa ser permitido; use Request Control no receptor. No Window view, toque primeiro na janela em que você quer digitar, para que ela fique na frente.

O Zoom While Typing não está onde você espera: ele segue a posição de digitação informada pelo Mac, então pode ficar deslocado em alguns apps. Feche e abra o teclado de novo, afaste ou junte dois dedos para ajustar a visualização ou desative Zoom While Typing em Settings ▸ Input ▸ Keyboard.

Os ⇧ ⌥ ⌘ do teclado de setas estão esmaecidos: com um Mac em uma versão mais antiga, eles só funcionam quando nenhum modificador está fixado no Control Tray. Desative o modificador fixado no Control Tray ou atualize o MeowDisplay no Mac.

Quando o Mac está bloqueado

Enquanto o Mac está bloqueado, o conteúdo normal da sessão não é mostrado nem enviado, e o dispositivo avisa que o Mac está bloqueado. Um iPhone ou iPad autorizado ainda pode solicitar a visualização da tela bloqueada. O layout volta quando o Mac é desbloqueado.

Não aparece o botão Show Lock Screen: o dispositivo não tem permissão para usar a tela bloqueada do Mac e explica o motivo. Desbloqueie o Mac no próprio Mac. Para poder usar da próxima vez, o dispositivo precisa de Always Allow Requests no Mac, Allow Input ativado, Allow Lock Screen Control ativado para esse dispositivo e o MeowDisplay 2.1 nos dois lados. Com Ask, só funciona se o dispositivo já tinha o controle antes de o Mac ser bloqueado.

A visualização da tela bloqueada fechou: ela é encerrada após dois minutos sem entrada, ao desconectar e quando o Mac é desbloqueado. Toque em Show Lock Screen novamente.

Como funciona: Bloquear e desbloquear o Mac.

USB e rede local

USB no iPhone/iPad: tente outro cabo que transfira dados e outra porta. Desbloqueie o dispositivo e toque em Confiar no alerta “Confiar Neste Computador”. O USB no Android não está implementado.

Wi-Fi: permita o acesso à Rede Local nos dois dispositivos, mantenha o receptor aberto e confirme se os dois estão na mesma rede. O isolamento de redes de convidados ou regras de firewall podem impedir a descoberta ou a conexão.

O rótulo de caminho descreve a conexão ativa: USB, LAN ou AWDL ponto a ponto entre dispositivos próximos. Anote-o ao relatar um problema.

O app para Mac fecha sozinho logo depois que você aprova um novo dispositivo: no macOS 15, esse é um problema conhecido (#219). O MeowDisplay 2.1 inclui uma correção proposta para uma das causas, quando a conexão usa QUIC. A correção ainda não foi verificada no macOS 15. Se o problema continuar, adicione o registro do Mac à issue.

Remote Access e despertar

Verifique se a rede privada mostra os dois dispositivos online e se o endpoint remoto salvo está atualizado. Um endereço acessível não substitui o pareamento confiável.

O Wake & Connect exige hardware compatível e “Despertar para o acesso de rede”. O Wake-on-LAN local não consegue passar pela conexão Tailscale do próprio Mac quando ele está em repouso e inacessível. O despertar remoto precisa de outro dispositivo ou de um roteador na LAN desse Mac.

A inicialização a frio e um Mac sem nenhuma sessão iniciada não fazem parte dos cenários compatíveis no momento. Consulte a configuração do Remote Access.

Relatar um problema

No Mac, use Logs para mostrar os arquivos de diagnóstico. No iOS, abra Settings & Help → Connection log ou agite o dispositivo.

Antes de compartilhar, remova endpoints privados, identificadores, nomes de dispositivos e conteúdo pessoal. No Android, use Settings & Help → Share Connection Log. Indique quais testes foram feitos em dispositivos físicos e quais foram automatizados ou em emulador.

Abrir uma issue no GitHub ↗

• As versões dos apps (download, App Store, teste fechado do Google Play ou compilação a partir do código-fonte) e a versão do macOS/iOS/Android.
• Os modelos do Mac e do receptor, o modo e o caminho ativo.
• O que você fez, o que esperava e o que realmente aconteceu.
• Se reiniciar ou reconectar muda o resultado.

Relatar falhas de segurança

Encontrou uma vulnerabilidade de segurança ou privacidade? Não abra uma issue pública no GitHub. Em vez disso, use o fluxo privado Report a vulnerability do GitHub no repositório do MeowDisplay.

Abra a página Security do repositório do MeowDisplay e escolha Report a vulnerability. Somente os mantenedores podem ver o que você enviar. A política de segurança explica o que incluir.

Para onde ir

• Bugs e pedidos de recursos: uma issue pública no GitHub.
• Ajuda geral: esta página e a página Configuração.
• Vulnerabilidades de segurança ou privacidade: o relato privado de vulnerabilidades do GitHub, como descrito acima.

Para saber como o MeowDisplay armazena e envia dados, leia Privacidade.