← Voltar a documentacao

Guia de Instalacao no macOS

Este guia orientara voce na instalacao do Sokuji em sistemas macOS. O Sokuji esta disponivel como instalador .pkg assinado e notarizado que inclui um driver de audio virtual para recursos aprimorados de processamento de audio.

Baixar para macOS

Requisitos do Sistema

  • macOS 13 (Ventura) ou posterior (desde a v0.42.2; no macOS 12, continue usando a v0.42.1)
  • Processador Apple Silicon (M1/M2/M3/M4) ou Intel (x86_64)
  • 4GB de RAM minimo (8GB recomendado)
  • 200MB de espaco em disco disponivel
  • Privilegios de administrador (necessarios para instalacao do driver de audio virtual)
  • Conexao com a internet para servicos de traducao com IA
  • Microfone e alto-falantes/fones de ouvido

Etapas de instalacao

Passo 1: Baixar o Sokuji

Visite a pagina oficial de lancamentos no GitHub para baixar a versao mais recente do Sokuji para macOS.

Baixar o instalador PKG

  • Sokuji-x.x.x-arm64.pkg - Para Macs com Apple Silicon (M1/M2/M3/M4)
  • Sokuji-x.x.x-x64.pkg - Para Macs com Intel
  • Cada instalador inclui o aplicativo Sokuji e o driver de audio virtual
  • O tamanho do arquivo e de aproximadamente 150-200MB

Dica: Nao sabe qual baixar? Clique no menu Apple () → "Sobre Este Mac" para verificar o tipo do chip. Se voce vir "Apple M1/M2/M3/M4", escolha a versao arm64. Se vir "Intel", escolha a versao x64.

Desde a versão 0.46.5 o instalador PKG é assinado e notarizado, então o macOS o abre sem etapas adicionais.

Passo 2: Instalar o PKG

Instale o Sokuji e seu driver de áudio virtual.

Processo de instalacao

  1. Localize o arquivo .pkg baixado na pasta Downloads (ex.: Sokuji-x.x.x-arm64.pkg ou Sokuji-x.x.x-x64.pkg)
  2. Clique duas vezes no arquivo PKG para iniciar a instalacao
  3. O instalador do macOS sera aberto - clique em "Continuar" para prosseguir
  4. Revise os detalhes da instalacao e clique em "Instalar"
  5. Digite sua senha de administrador quando solicitado (necessaria para a instalacao do driver)
  6. Aguarde a conclusao da instalacao (geralmente 1-2 minutos)
  7. Clique em "Fechar" quando a instalacao estiver concluida

O que e instalado

  • Sokuji.app - Instalado em /Applications
  • SokujiVirtualAudio.driver - Driver de audio virtual instalado em /Library/Audio/Plug-Ins/HAL
  • O instalador reiniciara automaticamente o CoreAudio para carregar o driver
A senha de administrador e necessaria porque o instalador precisa instalar um driver de audio no nivel do sistema. O driver de audio virtual habilita recursos avancados de processamento de audio.

Passo 3: Primeiro lançamento

Abra o Sokuji pela pasta Aplicativos. Nenhuma etapa de segurança adicional é necessária.

Passo 4: Configurar o Sokuji

Agora que o Sokuji esta em execucao, vamos configura-lo para o primeiro uso:

Configuracao inicial

  1. Conceda permissoes de microfone quando o macOS solicitar
  2. Selecione seu idioma de interface preferido
  3. Escolha seu provedor de IA (OpenAI, Google Gemini, etc.)
  4. Insira sua chave API para o provedor selecionado
  5. Selecione os idiomas de origem e destino para traducao
  6. Selecione seu microfone e, no bloco Voz, escolha seus alto-falantes ou fones de ouvido como Dispositivo de reprodução padrão. O Sokuji não lista ali o próprio dispositivo de áudio virtual: Tradução que o outro lado ouve envia sua tradução para ele, o microfone virtual que você escolhe no aplicativo de reunião
  7. Teste a configuracao do microfone e alto-falantes
Parabens! O Sokuji esta pronto para uso. O driver de audio virtual foi instalado e esta disponivel na sua lista de dispositivos de audio. Clique no botao do microfone para iniciar a traducao em tempo real.

Solucao de Problemas

Microfone nao funciona

Se o Sokuji nao consegue acessar seu microfone:
  1. Abra Preferencias do Sistema → Seguranca e Privacidade → Privacidade
  2. Selecione Microfone na barra lateral esquerda
  3. Certifique-se de que o Sokuji esteja marcado na lista
  4. Se nao estiver listado, reinicie o Sokuji e conceda permissao quando solicitado

Sem saida de audio

Se voce nao consegue ouvir o audio traduzido:
  1. Abra Preferencias do Sistema → Som → Saida
  2. Selecione seu dispositivo de saida preferido
  3. Verifique se o volume de saida nao esta mudo
  4. No bloco Voz do Sokuji, confira o dispositivo da linha que você espera ouvir: Eu também ouço para a sua própria tradução (desativado por padrão), Tradução que eu ouço para a do outro lado e Dispositivo de reprodução padrão para todo o resto

Aplicativo trava em Macs Intel ou problemas de desempenho

Certifique-se de ter baixado o instalador correto para seu Mac:
  • Apple Silicon (M1/M2/M3/M4): Use Sokuji-x.x.x-arm64.pkg
  • Intel: Use Sokuji-x.x.x-x64.pkg
  • Verifique o tipo do chip: menu Apple () → "Sobre Este Mac"
  • Se usou o instalador errado, baixe a versao correta da pagina de lancamentos
  • Se os travamentos persistirem com o instalador correto, verifique o Console.app para logs de travamento e reporte-os no GitHub

Driver de audio virtual nao aparece

Se voce nao ve "SokujiVirtualAudio" nos seus dispositivos de audio:
  1. Deixe o Sokuji reparar primeiro: quando o driver está instalado mas o macOS não o carregou, o Sokuji avisa ao iniciar e oferece Reparar. Digite sua senha de administrador e o Sokuji reinicia o Core Audio para carregar o driver, sem precisar reiniciar o Sokuji
  2. Verifique se o driver esta instalado: ls /Library/Audio/Plug-Ins/HAL/
  3. Se nao estiver presente, voce pode precisar reinstalar o Sokuji
  4. Se estiver presente e Reparar não ajudou, tente reiniciar o CoreAudio: sudo killall coreaudiod, ou reinicie o Mac
  5. Verifique Ajustes do Sistema → Som para ver se o dispositivo aparece

Instalacao requer senha de administrador

Isso e normal e necessario:
  • O instalador PKG precisa instalar um driver de audio no nivel do sistema
  • Drivers de audio do sistema requerem privilegios de administrador para instalacao
  • Digite sua senha quando solicitado - isso e seguro e esperado
  • Se voce nao tem acesso de administrador, entre em contato com seu administrador do sistema