← 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 nao assinado que inclui um driver de audio virtual para recursos aprimorados de processamento de audio.

Baixar para macOS

Requisitos do Sistema

  • macOS 10.15 (Catalina) ou posterior
  • 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.

O instalador PKG nao e assinado, o que significa que voce precisara seguir etapas especiais para instala-lo (abordado no proximo passo).

Passo 2: Preparar para a instalacao

Como o instalador PKG nao e assinado, o macOS o bloqueara por padrao. Voce precisa remover o atributo de quarentena antes da instalacao.

Remover atributo de quarentena (obrigatorio)

  1. Abra o Terminal (Aplicativos → Utilitarios → Terminal)
  2. Digite ou cole o seguinte comando (substitua x.x.x pelo numero da versao):

    sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg

    Para Macs Intel, use: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg

  3. Pressione Enter e digite sua senha de administrador quando solicitado
  4. O comando sera concluido silenciosamente (nenhuma saida significa sucesso)

O que isso faz? Este comando remove o sinalizador de quarentena que o macOS adiciona aos arquivos baixados. E seguro e necessario para instaladores PKG nao assinados.

Este passo e critico! Sem remover o atributo de quarentena, o instalador PKG nao conseguira abrir ou instalar.

Passo 3: Instalar o PKG

Agora que voce preparou o instalador, pode instalar o Sokuji e seu driver de audio 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 4: Primeiro lançamento

Apos a instalacao, voce pode precisar conceder permissao ao Sokuji para executar, pois foi baixado fora da App Store.

Abrindo o Sokuji pela primeira vez

  1. Navegue ate a pasta Aplicativos
  2. Encontre o Sokuji na lista
  3. Clique com o botao direito (ou Control-clique) no Sokuji
  4. Selecione "Abrir" no menu de contexto
  5. Quando o dialogo de seguranca aparecer, clique em "Abrir" para confirmar

Nota: Se voce completou o Passo 2 corretamente, pode nao ver avisos de seguranca.

Metodo alternativo

Se o macOS ainda bloquear o Sokuji:
  1. Abra Preferencias do Sistema → Seguranca e Privacidade
  2. Va para a aba Geral
  3. Voce deve ver uma mensagem sobre o Sokuji sendo bloqueado
  4. Clique em "Abrir Mesmo Assim"
Este aviso de seguranca aparece apenas no primeiro lancamento. Depois disso, voce pode abrir o Sokuji normalmente pelo Launchpad ou Aplicativos.

Passo 5: 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. Escolha seus dispositivos de audio (voce deve ver "Sokuji Virtual Audio" na lista)
  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

"O pacote esta danificado e nao pode ser aberto" ou o PKG nao instala

Isso acontece quando o atributo de quarentena nao foi removido do arquivo PKG:
  1. Abra o Terminal (Aplicativos → Utilitarios → Terminal)
  2. Execute: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
  3. Digite sua senha quando solicitado
  4. Tente instalar o PKG novamente
Este e o problema de instalacao mais comum com instaladores PKG nao assinados.

"O Sokuji nao pode ser aberto porque e de um desenvolvedor nao identificado"

Isso acontece se voce nao executou o comando xattr antes de instalar:
  1. Clique com o botao direito no aplicativo Sokuji em Aplicativos
  2. Selecione "Abrir" no menu
  3. Clique em "Abrir" no dialogo que aparece
Voce so precisa fazer isso uma vez. Melhor abordagem: desinstale e reinstale apos remover o atributo de quarentena.

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 Sokuji, verifique se o dispositivo de saida correto esta selecionado

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 "Sokuji Virtual Audio" nos seus dispositivos de audio:
  1. Verifique se o driver esta instalado: ls /Library/Audio/Plug-Ins/HAL/
  2. Se nao estiver presente, voce pode precisar reinstalar o Sokuji
  3. Se estiver presente, tente reiniciar o CoreAudio: sudo killall coreaudiod
  4. Verifique Preferencias 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