← Volver a la documentacion

Guia de instalacion en macOS

Esta guia le ayudara a instalar Sokuji en sistemas macOS. Sokuji esta disponible como instalador .pkg sin firmar que incluye un controlador de audio virtual para capacidades mejoradas de procesamiento de audio.

Descargar para macOS

Requisitos del sistema

  • macOS 13 (Ventura) o posterior (desde v0.42.2; en macOS 12, siga usando v0.42.1)
  • Procesador Apple Silicon (M1/M2/M3/M4) o Intel (x86_64)
  • 4GB de RAM minimo (8GB recomendado)
  • 200MB de espacio en disco disponible
  • Privilegios de administrador (necesarios para la instalacion del controlador de audio virtual)
  • Conexion a internet para servicios de traduccion con IA
  • Microfono y altavoces/auriculares

Pasos de instalacion

Paso 1: Descargar Sokuji

Visite la pagina oficial de lanzamientos en GitHub para descargar la ultima version de Sokuji para macOS.

Descargar el instalador PKG

  • Sokuji-x.x.x-arm64.pkg - Para Mac con Apple Silicon (M1/M2/M3/M4)
  • Sokuji-x.x.x-x64.pkg - Para Mac con Intel
  • Cada instalador incluye la aplicacion Sokuji y el controlador de audio virtual
  • El tamano del archivo es de aproximadamente 150-200MB

Consejo: ¿No esta seguro de cual descargar? Haga clic en el menu Apple () → "Acerca de este Mac" para verificar el tipo de chip. Si ve "Apple M1/M2/M3/M4", elija la version arm64. Si ve "Intel", elija la version x64.

El instalador PKG no esta firmado, lo que significa que necesitara seguir pasos especiales para instalarlo (se explica en el siguiente paso).

Paso 2: Preparar la instalacion

Dado que el instalador PKG no esta firmado, macOS lo bloqueara de forma predeterminada. Necesita eliminar el atributo de cuarentena antes de la instalacion.

Eliminar el atributo de cuarentena (obligatorio)

  1. Abra Terminal (Aplicaciones → Utilidades → Terminal)
  2. Escriba o pegue el siguiente comando (reemplace x.x.x con su numero de version):

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

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

  3. Presione Enter e ingrese su contrasena de administrador cuando se le solicite
  4. El comando se completara en silencio (sin salida significa exito)

¿Que hace esto? Este comando elimina la bandera de cuarentena que macOS agrega a los archivos descargados. Es seguro y necesario para los instaladores PKG sin firmar.

¡Este paso es critico! Sin eliminar el atributo de cuarentena, el instalador PKG no podra abrirse ni instalarse.

Paso 3: Instalar PKG

Ahora que ha preparado el instalador, puede instalar Sokuji y su controlador de audio virtual.

Proceso de instalacion

  1. Localice el archivo .pkg descargado en su carpeta de Descargas (por ejemplo, Sokuji-x.x.x-arm64.pkg o Sokuji-x.x.x-x64.pkg)
  2. Haga doble clic en el archivo PKG para iniciar la instalacion
  3. El instalador de macOS se abrira - haga clic en "Continuar" para proceder
  4. Revise los detalles de la instalacion y haga clic en "Instalar"
  5. Ingrese su contrasena de administrador cuando se le solicite (necesaria para la instalacion del controlador)
  6. Espere a que se complete la instalacion (normalmente 1-2 minutos)
  7. Haga clic en "Cerrar" cuando la instalacion haya finalizado

Que se instala

  • Sokuji.app - Instalado en /Applications
  • SokujiVirtualAudio.driver - Controlador de audio virtual instalado en /Library/Audio/Plug-Ins/HAL
  • El instalador reiniciara automaticamente CoreAudio para cargar el controlador
Se requiere la contrasena de administrador porque el instalador necesita instalar un controlador de audio a nivel del sistema. El controlador de audio virtual habilita funciones avanzadas de procesamiento de audio.

Paso 4: Primer lanzamiento

Despues de la instalacion, es posible que necesite otorgar permiso a Sokuji para ejecutarse, ya que fue descargado fuera de la App Store.

Abrir Sokuji por primera vez

  1. Navegue a su carpeta de Aplicaciones
  2. Encuentre Sokuji en la lista
  3. Haga clic derecho (o Control-clic) en Sokuji
  4. Seleccione "Abrir" del menu contextual
  5. Cuando aparezca el dialogo de seguridad, haga clic en "Abrir" para confirmar

Nota: Si completo correctamente el Paso 2, es posible que no vea ninguna advertencia de seguridad.

Metodo alternativo

Si macOS sigue bloqueando Sokuji:
  1. Abra Preferencias del Sistema → Seguridad y Privacidad
  2. Vaya a la pestana General
  3. Deberia ver un mensaje sobre Sokuji siendo bloqueado
  4. Haga clic en "Abrir de todas formas"
Esta advertencia de seguridad solo aparece en el primer lanzamiento. Despues de eso, puede abrir Sokuji normalmente desde el Launchpad o Aplicaciones.

Paso 5: Configurar Sokuji

Ahora que Sokuji esta ejecutandose, configuremoslo para el primer uso:

Configuracion inicial

  1. Otorgue permisos de microfono cuando macOS se lo solicite
  2. Seleccione su idioma de interfaz preferido
  3. Elija su proveedor de IA (OpenAI, Google Gemini, etc.)
  4. Ingrese su clave API para el proveedor seleccionado
  5. Seleccione los idiomas de origen y destino para la traduccion
  6. Seleccione su micrófono y, en el bloque Voz, elija sus altavoces o auriculares como Dispositivo de reproducción predeterminado. Sokuji no muestra ahí su propio dispositivo de audio virtual: Traducción que oye la otra parte envía su traducción a él, como el micrófono virtual que elige en su aplicación de reuniones
  7. Pruebe la configuracion de su microfono y altavoces
¡Felicidades! Sokuji esta listo para usar. El controlador de audio virtual ha sido instalado y esta disponible en su lista de dispositivos de audio. Haga clic en el boton del microfono para iniciar la traduccion en tiempo real.

Solucion de problemas

"El paquete esta danado y no se puede abrir" o el PKG no se instala

Esto sucede cuando no se ha eliminado el atributo de cuarentena del archivo PKG:
  1. Abra Terminal (Aplicaciones → Utilidades → Terminal)
  2. Ejecute: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
  3. Ingrese su contrasena cuando se le solicite
  4. Intente instalar el PKG nuevamente
Este es el problema de instalacion mas comun con instaladores PKG sin firmar.

"Sokuji no se puede abrir porque es de un desarrollador no identificado"

Esto sucede si no ejecuto el comando xattr antes de instalar:
  1. Haga clic derecho en la aplicacion Sokuji en Aplicaciones
  2. Seleccione "Abrir" del menu
  3. Haga clic en "Abrir" en el dialogo que aparece
Solo necesita hacer esto una vez. Mejor enfoque: desinstale y reinstale despues de eliminar el atributo de cuarentena.

El microfono no funciona

Si Sokuji no puede acceder a su microfono:
  1. Abra Preferencias del Sistema → Seguridad y Privacidad → Privacidad
  2. Seleccione Microfono en la barra lateral izquierda
  3. Asegurese de que Sokuji este marcado en la lista
  4. Si no esta en la lista, reinicie Sokuji y otorgue permiso cuando se le solicite

Sin salida de audio

Si no puede escuchar el audio traducido:
  1. Abra Preferencias del Sistema → Sonido → Salida
  2. Seleccione su dispositivo de salida preferido
  3. Verifique que el volumen de salida no este silenciado
  4. En el bloque Voz de Sokuji, revise el dispositivo de la fila que espera oír: Yo también la oigo para su propia traducción (desactivada por defecto), Traducción que yo oigo para la de la otra parte y Dispositivo de reproducción predeterminado para todo lo demás

La aplicacion se bloquea en Mac Intel o problemas de rendimiento

Asegurese de haber descargado el instalador correcto para su Mac:
  • Apple Silicon (M1/M2/M3/M4): Use Sokuji-x.x.x-arm64.pkg
  • Intel: Use Sokuji-x.x.x-x64.pkg
  • Verifique su tipo de chip: menu Apple () → "Acerca de este Mac"
  • Si uso el instalador incorrecto, descargue la version correcta de la pagina de lanzamientos
  • Si los bloqueos persisten con el instalador correcto, revise Console.app para los registros de bloqueo y reportelos en GitHub

El controlador de audio virtual no aparece

Si no ve "SokujiVirtualAudio" en sus dispositivos de audio:
  1. Deje primero que Sokuji lo repare: cuando el controlador esta instalado pero macOS no lo ha cargado, Sokuji lo indica al iniciar y ofrece Reparar. Ingrese su contrasena de administrador y Sokuji reiniciara Core Audio para cargar el controlador, sin necesidad de reiniciar Sokuji
  2. Verifique si el controlador esta instalado: ls /Library/Audio/Plug-Ins/HAL/
  3. Si no esta presente, es posible que necesite reinstalar Sokuji
  4. Si esta presente y Reparar no ayudo, intente reiniciar CoreAudio: sudo killall coreaudiod, o reinicie el Mac
  5. Revise Ajustes del Sistema → Sonido para ver si el dispositivo aparece

La instalacion requiere contrasena de administrador

Esto es normal y necesario:
  • El instalador PKG necesita instalar un controlador de audio a nivel del sistema
  • Los controladores de audio del sistema requieren privilegios de administrador para instalarse
  • Ingrese su contrasena cuando se le solicite - esto es seguro y esperado
  • Si no tiene acceso de administrador, contacte a su administrador del sistema