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 10.15 (Catalina) o posterior
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)

Abra Terminal (Aplicaciones → Utilidades → Terminal)
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
Presione Enter e ingrese su contrasena de administrador cuando se le solicite
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

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)
Haga doble clic en el archivo PKG para iniciar la instalacion
El instalador de macOS se abrira - haga clic en "Continuar" para proceder
Revise los detalles de la instalacion y haga clic en "Instalar"
Ingrese su contrasena de administrador cuando se le solicite (necesaria para la instalacion del controlador)
Espere a que se complete la instalacion (normalmente 1-2 minutos)
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

Navegue a su carpeta de Aplicaciones
Encuentre Sokuji en la lista
Haga clic derecho (o Control-clic) en Sokuji
Seleccione "Abrir" del menu contextual
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:

Abra Preferencias del Sistema → Seguridad y Privacidad
Vaya a la pestana General
Deberia ver un mensaje sobre Sokuji siendo bloqueado
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

Otorgue permisos de microfono cuando macOS se lo solicite
Seleccione su idioma de interfaz preferido
Elija su proveedor de IA (OpenAI, Google Gemini, etc.)
Ingrese su clave API para el proveedor seleccionado
Seleccione los idiomas de origen y destino para la traduccion
Elija sus dispositivos de audio (deberia ver "Sokuji Virtual Audio" en la lista)
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:

Abra Terminal (Aplicaciones → Utilidades → Terminal)
Ejecute: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
Ingrese su contrasena cuando se le solicite
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:

Haga clic derecho en la aplicacion Sokuji en Aplicaciones
Seleccione "Abrir" del menu
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:

Abra Preferencias del Sistema → Seguridad y Privacidad → Privacidad
Seleccione Microfono en la barra lateral izquierda
Asegurese de que Sokuji este marcado en la lista
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:

Abra Preferencias del Sistema → Sonido → Salida
Seleccione su dispositivo de salida preferido
Verifique que el volumen de salida no este silenciado
En Sokuji, verifique que el dispositivo de salida correcto este seleccionado

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 "Sokuji Virtual Audio" en sus dispositivos de audio:

Verifique si el controlador esta instalado: ls /Library/Audio/Plug-Ins/HAL/
Si no esta presente, es posible que necesite reinstalar Sokuji
Si esta presente, intente reiniciar CoreAudio: sudo killall coreaudiod
Revise Preferencias 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