INSTALAÇÃO NO LINUX

Instale o Voxis no Linux com snap

O Voxis é publicado no canal stable do snap, então instalar no Linux é um comando e uma permissão. Esta página cobre a instalação, a permissão que decide se o aplicativo vai conseguir ouvir alguma coisa, como funciona a captura no PipeWire e o que a versão para Linux deliberadamente não faz.

Instale pela Snap Store

O Voxis é publicado no canal stable do snap. Em qualquer distribuição em que o snapd esteja disponível, a instalação é um único comando:

sudo snap install voxis

A instalação é só isso. Não há repositório para adicionar, nenhum .deb para baixar e nenhuma etapa de compilação — o snap já traz o motor, o runtime Python e a pilha GTK/WebKit com que a janela é desenhada, então nada do que já existe na sua máquina precisa bater com alguma versão escolhida por nós.

Nós deliberadamente não escrevemos um número de versão nesta página. O canal stable avança, e um número gravado na documentação envelhece no dia seguinte ao lançamento. Para ver exatamente o que o canal está servindo agora, rode snap info voxis e leia a linha stable:; para ver o que você realmente tem instalado, rode snap list voxis. Os dois são verdadeiros no momento em que você digita, o que já é mais do que uma página consegue prometer.

As atualizações chegam como em qualquer snap — o snapd atualiza o pacote em segundo plano, e sudo snap refresh voxis puxa uma na hora se você não quiser esperar. Não há atualizador dentro do aplicativo neste canal; a loja é o mecanismo de atualização.

Conecte a permissão de áudio — sem ela a instalação fica surda

Esta é a etapa fácil de pular e impossível de contornar. Snaps rodam sob confinamento estrito: o pacote declara quais interfaces quer, e o sistema decide quais delas ficam de fato conectadas. O Voxis precisa da interface audio-record, porque ler o que a sua máquina está tocando passa pelo mesmo caminho de gravação que ler um microfone.

Uma instalação com a permissão de áudio desconectada fica surda. O aplicativo abre, a janela aparece, os seletores de idioma funcionam, a sessão parece rodar — e nenhum áudio chega ao motor, então nenhuma tradução volta. Isso não se apresenta como um erro de permissão; se apresenta como silêncio. Conecte a permissão explicitamente:

sudo snap connect voxis:audio-record

Dá para confirmar o resultado antes de iniciar uma sessão. snap connections voxis lista as interfaces do pacote; na linha audio-record, a coluna de conexão deve mostrar um plug e um slot em vez de um traço. Se aparecer um traço, o comando acima não rodou, ou rodou em outra instalação.

  1. Rode sudo snap install voxis.
  2. Rode sudo snap connect voxis:audio-record.
  3. Rode snap connections voxis e verifique se a linha audio-record está conectada.
  4. Abra o Voxis, entre na sua conta e rode o teste de som embutido antes de contar com uma sessão de verdade.

Se você instalou o pacote à mão, a partir de um arquivo local em vez da loja, nada é concedido por você — ali o comando de conexão não é um extra opcional, é parte da instalação. Rode o comando e abra o aplicativo de novo.

Como funciona a captura no Linux: PipeWire e o sink do próprio Voxis

O lado Linux roda sobre o PipeWire. Em vez de tentar grampear as suas caixas de som, o Voxis cria um sink próprio, move para ele o áudio dos aplicativos que você quer traduzir e lê o monitor desse sink. A voz traduzida que ele reproduz vai para a sua saída normal, então nunca cai no sink que o Voxis está escutando.

A consequência prática é a que importa: o Voxis não retraduz a própria voz. A separação é estrutural — a fala traduzida simplesmente não está no fluxo que está sendo capturado — e não um filtro que precisa adivinhar depois qual som é qual.

Isso também significa que o Voxis nunca assume a sua saída padrão do sistema nem o seu dispositivo de entrada padrão. Sua área de trabalho continua se comportando como antes da instalação, e sair do aplicativo não deixa nada para você desfazer.

Escolher a fonte no aplicativo de reunião: "Monitor of Voxis_Virtual_Mic"

O modo reunião de duas vias tem uma segunda metade: a sua própria fala é traduzida e precisa chegar ao outro lado. No Windows, isso passa por um driver de cabo virtual. No Linux, o Voxis cria um sink separado para a perna de saída, publicado com o nome Voxis_Virtual_Mic, e toca nele a versão traduzida da sua voz.

Depois é preciso apontar o seu aplicativo de conferência para ele. No Zoom, no Teams, no Meet ou no que você estiver usando, abra o seletor de microfone do próprio aplicativo e escolha “Monitor of Voxis_Virtual_Mic” em vez do seu microfone físico. O que os outros aplicativos conseguem gravar é o monitor de um sink, e é por isso que você escolhe o monitor e não o sink em si.

O que ele não faz: o Voxis não entra no seu aplicativo de conferência para mudar essa configuração por você, e não troca a sua entrada padrão do sistema para te rotear até lá automaticamente. Você seleciona o monitor por conta própria, dentro do aplicativo de reunião, e volta para o seu microfone real quando a chamada termina. Se esquecer, o outro lado ouve a sua voz sem tradução — e é por isso que o aplicativo exibe um lembrete no início e no fim de uma sessão de duas vias.

Onde as transcrições são gravadas

As transcrições são salvas na sua própria máquina, no seu diretório home real e não dentro do armazenamento privado do snap, então você pode abrir, mover e apagar os arquivos com qualquer gerenciador de arquivos:

~/Documents/Voxis/Transcripts

Se a sua área de trabalho usa uma pasta Documentos traduzida ou movida para outro lugar, o Voxis segue a configuração XDG em vez de supor um caminho em inglês, então a pasta cai onde o seu sistema diz que fica Documentos. Cada sessão ganha a sua própria subpasta, e qualquer exportação gerada na tela de Histórico é gravada ao lado do registro daquela sessão.

Chegar ao seu home real exige a interface home do snap, que normalmente já vem conectada numa instalação pela loja. Se as transcrições não estiverem onde você espera, confira a linha home em snap connections voxis, do mesmo jeito que você conferiu audio-record.

Sua conta e seus minutos funcionam igual aqui

O snap para Linux não é um produto separado com cobrança separada. Você entra com a mesma conta Voxis, e os minutos comprados e a franquia diária gratuita valem também no snap para Linux — um pacote comprado no Windows pode ser gasto no Linux, e a franquia diária gratuita é a mesma franquia, não uma segunda rodando em paralelo. Planos e saldos estão em Preços.

Não há chave de API para colar nem gerenciamento de chaves para fazer neste canal: os minutos de tradução vêm com a conta, e o aplicativo busca o que precisa quando uma sessão começa.

Limites conhecidos da versão para Linux

A lista honesta, para você decidir antes de instalar e não depois:

  • Não existe pacote AppImage. Snap é o empacotamento Linux que publicamos; não estamos distribuindo um AppImage ao lado dele.
  • Sem roteamento automático para o aplicativo de conferência. A perna de saída de uma reunião não é ligada ao seu aplicativo de conferência por você — é você que escolhe “Monitor of Voxis_Virtual_Mic” no seletor de microfone daquele aplicativo, e é você que desfaz isso depois.
  • Seus padrões do sistema ficam intactos. Isso é uma decisão de projeto, não um recurso faltando, mas a consequência é real: o aplicativo não vai consertar uma configuração mal roteada assumindo os seus dispositivos padrão.
  • Um pacote local instalado à mão começa sem nada conectado. As interfaces que vêm concedidas numa instalação pela loja precisam ser conectadas manualmente ali.

Se a sessão continuar em silêncio

No Linux, o silêncio quase sempre se resume a um pequeno conjunto de causas, e elas são rápidas de separar umas das outras:

  1. Verifique a permissão primeiro: snap connections voxis, a linha audio-record. Uma interface desconectada produz exatamente esse sintoma, e nada mais resolve.
  2. Rode o teste de som embutido no aplicativo. Reprodução e captura são verificadas de forma independente, então ele diz qual das duas metades está muda.
  3. Confirme que algo está realmente tocando. O Voxis traduz o que a sua máquina está tocando — um vídeo pausado ou uma aba no mudo não dão nada para ele trabalhar.
  4. Numa reunião de duas vias, olhe o seletor de microfone do próprio aplicativo de reunião. Se ele ainda mostrar o seu microfone físico, o outro lado está te ouvindo sem tradução.
  5. Se ainda assim ficar em silêncio, envie um relato de dentro do aplicativo. O relato leva um log higienizado que nomeia qual caminho de captura foi usado, e essa é a parte que ninguém consegue reconstruir a partir de uma descrição.

Ajuda sintoma a sintoma para as duas plataformas está em Solução de problemas, e o resto da documentação está indexado em Documentação.

FAQ

Perguntas frequentes

01Qual comando instala o Voxis no Linux?
sudo snap install voxis. O Voxis é publicado no canal stable do snap, então esse único comando é a instalação inteira — não há repositório para adicionar nem nada para compilar.
02Instalei e nada é traduzido. O que eu deixei passar?
Quase com certeza a permissão de áudio. Snaps rodam confinados, e uma instalação com a permissão de áudio desconectada fica surda: o aplicativo roda normalmente, mas nenhum som chega ao motor. Rode sudo snap connect voxis:audio-record e confirme com snap connections voxis antes de iniciar uma sessão.
03Qual fonte eu seleciono no Zoom, no Teams ou no Meet?
Escolha "Monitor of Voxis_Virtual_Mic" como microfone nas configurações de áudio do próprio aplicativo. O Voxis toca a versão traduzida da sua voz num sink que ele publica com esse nome, e o que os outros aplicativos conseguem gravar é o monitor de um sink. O Voxis não muda essa configuração por você, então volte para o seu microfone real depois da chamada.
04Onde ficam salvas as minhas transcrições?
Em ~/Documents/Voxis/Transcripts, no seu diretório home real e não dentro do armazenamento privado do snap, com uma subpasta por sessão. Se a sua área de trabalho usa uma pasta Documentos traduzida ou movida, o Voxis segue a configuração XDG em vez de supor um caminho em inglês.
05Meus minutos funcionam no Linux ou preciso comprar de novo?
Funcionam do jeito que estão. Os minutos comprados e a franquia diária gratuita valem também no snap para Linux — mesma conta, mesmo saldo, sem compra separada para Linux. Veja os planos atuais em Preços.
06Existe AppImage ou outro pacote para Linux?
Não, não existe pacote AppImage; snap é o empacotamento Linux que publicamos. E como o canal segue avançando, confira com snap info voxis o que o stable está servindo em vez de confiar num número de versão escrito numa página.