Saltar al contenido principal

Tutorial: configuración en macOS

Este tutorial te guía por toda la incorporación específica de macOS para Rephlo, desde la instalación hasta tu primer comando con selección por arrastre. Si ya completaste la guía general de Instalación y configuración, este tutorial profundiza en los detalles de macOS.

Propósito​

macOS tiene requisitos de seguridad y privacidad únicos que afectan cómo funciona Rephlo. A diferencia de Windows, donde los atajos globales funcionan de inmediato, macOS requiere el consentimiento explícito del usuario para Accesibilidad y Grabación de pantalla. Este tutorial se asegura de que configures todo correctamente para que el conjunto completo de funciones de Rephlo esté disponible desde el primer día.

Requisitos previos​

RequisitoDetalles
Versión de macOS10.15 Catalina o posterior
ArquitecturaApple Silicon (M1/M2/M3/M4) o Intel (x64)
Espacio en disco~250 MB para el paquete de la aplicación
Ollama (opcional)Si planeas usar modelos locales, instala Ollama por separado

Paso 1: descarga e instalación​

1.1 Descarga Rephlo​

Ve a https://rephlo.app/download y descarga el paquete más reciente para macOS:

  • Rephlo-macos-arm64.dmg para Mac con Apple Silicon (M1/M2/M3/M4)
  • Rephlo-macos-x64.dmg para Mac con Intel

1.2 Instala en Aplicaciones​

  1. Abre el archivo .dmg descargado.
  2. Arrastra Rephlo.app a la carpeta /Applications.
  3. Expulsa la imagen de disco.

1.3 Primer inicio — Gatekeeper​

La primera vez que abras Rephlo, es posible que Gatekeeper de macOS lo bloquee con un mensaje: "Rephlo.app no se puede abrir porque no se puede verificar el desarrollador."

Para continuar:

  1. No hagas doble clic en la aplicación. En su lugar, haz clic derecho (o Control-clic) en Rephlo.app dentro de /Applications.
  2. Selecciona "Open" en el menú contextual.
  3. En el cuadro de diálogo de confirmación, haz clic en "Open" de nuevo.

macOS recuerda esta elección. Los siguientes inicios funcionarán con normalidad haciendo doble clic.

¿Por qué ocurre esto? Gatekeeper de macOS advierte sobre aplicaciones descargadas fuera de la Mac App Store. El método de clic derecho > Open evita esta comprobación para la aplicación actual.

Paso 2: concede los permisos necesarios​

Por qué se necesitan los permisos​

Rephlo escucha atajos globales y lee tu selección de texto actual cuando activas un comando, lo cual en macOS requiere el permiso de Accesibilidad. El permiso de Grabación de pantalla se requiere por separado para la captura de pantallas.

Sin estos permisos, la integración de Rephlo con todo el sistema no funcionará.

2.1 El PermissionPreCheckDialog​

Inmediatamente después del primer inicio, Rephlo muestra el PermissionPreCheckDialog:

2.2 Concede el permiso de Accesibilidad​

  1. En el PermissionPreCheckDialog, haz clic en "Open System Settings" junto a Accessibility.
  2. macOS abre System Settings > Privacy & Security > Accessibility.
  3. Localiza Rephlo en la lista de aplicaciones.
  4. Activa el interruptor (ON).
  5. Si se te solicita, autentícate con tu contraseña de macOS o Touch ID.
  6. Vuelve al cuadro de diálogo de Rephlo.

2.3 Concede el permiso de Grabación de pantalla​

  1. En el PermissionPreCheckDialog, haz clic en "Open System Settings" junto a Screen Recording.
  2. macOS abre System Settings > Privacy & Security > Screen Recording.
  3. Localiza Rephlo en la lista de aplicaciones.
  4. Activa el interruptor (ON).
  5. Autentícate si se te solicita.
  6. Vuelve al cuadro de diálogo de Rephlo.

2.4 Verifica y reinicia​

  1. De vuelta en el cuadro de diálogo de Rephlo, haz clic en "Check Again".
  2. Ambos permisos ahora deberían mostrarse como Granted.
  3. Cierra Rephlo por completo (clic derecho en el icono de la barra de menú > Exit, o Cmd+Q).
  4. Vuelve a abrir Rephlo desde /Applications. Algunos cambios de permisos de macOS requieren un reinicio completo para surtir efecto.

Consejo: Si las casillas siguen mostrando "Not Granted" después de activar los permisos, prueba a cerrar Rephlo, esperar unos segundos y volver a abrirlo. A veces macOS almacena en caché el estado de permisos anterior.

Paso 3: configura tu primer proveedor​

Con los permisos concedidos, configura un proveedor de IA para que Rephlo pueda procesar tus comandos.

  1. Haz clic en el icono de Rephlo en la barra de menú y luego selecciona "Settings" (o abre el Dashboard y ve a Settings).
  2. Ve a Settings > LLM Providers.
  3. Elige un proveedor de la lista:
ProveedorQué necesitas
OpenAIClave de API desde platform.openai.com
AnthropicClave de API desde console.anthropic.com
GoogleClave de API desde aistudio.google.dev
GroqClave de API desde console.groq.com
xAI (Grok)Clave de API desde console.x.ai
OpenRouterClave de API desde openrouter.ai
Azure OpenAIURL del endpoint + clave de API desde tu portal de Azure
OllamaInstalación local, no necesitas clave (endpoint: http://localhost:11434)
OpenAI-CompatibleURL del endpoint + clave de API para cualquier servicio compatible
  1. Introduce tu API Key (y la URL del endpoint si corresponde).
  2. Haz clic en Test Connection para verificar.
  3. Haz clic en Save.

Recomendación para empezar rápido: Si eres nuevo en las API de IA, OpenAI o Anthropic son las más sencillas de configurar. Si prefieres privacidad total sin depender de la nube, instala Ollama y usa modelos locales.

Paso 4: aprende los atajos de macOS​

Rephlo usa atajos predeterminados específicos de cada plataforma. Aquí tienes los valores predeterminados de macOS comparados con Windows/Linux:

AcciónmacOSWindows / Linux
Context Menu OverlayShift+Cmd+CCtrl+Shift+Alt+C
Screenshot CaptureShift+Cmd+SCtrl+Shift+Alt+S
Drag-Select ModifierCmdCtrl
Zoom InCmd+PlusCtrl+Plus
Zoom OutCmd+MinusCtrl+Minus
Reset ZoomCmd+0Ctrl+0

Personalización de atajos​

Todos los atajos son totalmente personalizables:

  1. Abre Settings > Hotkeys.
  2. Haz clic en el campo del atajo que quieras cambiar.
  3. Pulsa la combinación de teclas deseada.
  4. Haz clic en Save.

Consejo: Si un atajo entra en conflicto con otra aplicación (por ejemplo, Spotlight, Alfred o Raycast), elige una combinación alternativa. Rephlo te avisará si el atajo elegido ya está en uso por el sistema.

Paso 5: prueba la selección por arrastre​

El flujo de selección por arrastre es la forma más rápida de usar Rephlo en macOS. Vamos a probarlo:

5.1 Abre cualquier aplicación de texto​

Abre TextEdit, Notes, Safari o cualquier aplicación con texto seleccionable.

5.2 Realiza la selección por arrastre​

  1. Mantén pulsada la tecla Cmd (el modificador de selección por arrastre predeterminado en macOS).
  2. Mientras mantienes pulsado Cmd, haz clic y arrastra el ratón sobre un texto para seleccionarlo.
  3. Cuando sueltes el botón del ratón, la superposición de Rephlo aparece de inmediato cerca de tu cursor.

5.3 Ejecuta un comando​

  1. En la superposición, haz clic en "Summarize" (o cualquier comando).
  2. Rephlo envía el texto seleccionado a tu proveedor de IA configurado.
  3. El resultado aparece en la superposición.
  4. Haz clic en Copy para colocar el resultado en tu portapapeles, o en Insert para reemplazar el texto original.

Nota: La tecla modificadora de selección por arrastre es personalizable. Ve a Settings > Hotkeys > Text Selection Trigger para cambiarla de Cmd a otra tecla si lo prefieres.

Solución de problemas específicos de macOS​

Los atajos no funcionan​

Síntoma: Pulsar Shift+Cmd+C no hace nada. La superposición no aparece.

Causa: El permiso de Accesibilidad no está concedido, o la aplicación no se reinició después de conceder el permiso.

Solución:

  1. Abre System Settings > Privacy & Security > Accessibility.
  2. Confirma que Rephlo está activado (ON).
  3. Si ya estaba activado, desactívalo (OFF) y vuelve a activarlo (ON).
  4. Cierra y vuelve a abrir Rephlo.

La captura de pantalla no funciona​

Síntoma: Los comandos de captura de pantalla fallan o producen una imagen en blanco.

Causa: El permiso de Grabación de pantalla no está concedido.

Solución:

  1. Abre System Settings > Privacy & Security > Screen Recording.
  2. Confirma que Rephlo está activado (ON).
  3. Cierra y vuelve a abrir Rephlo.

La superposición no aparece​

Síntoma: Pulsas el atajo o haces una selección por arrastre, pero no aparece ninguna ventana de superposición.

Posibles causas y soluciones:

Posible causaSolución
Accesibilidad no concedidaConcede el permiso de Accesibilidad y reinicia
La app no se ejecuta como paquete .appÁbrela desde /Applications/Rephlo.app, no mediante dotnet run
Conflicto de atajos con otra appRevisa Settings > Hotkeys por conflictos; cambia la combinación
La app está pausadaHaz clic derecho en el icono de la barra de menú; si aparece "Resume Rephlo", haz clic en él

Gatekeeper bloquea la app en cada inicio​

Síntoma: macOS sigue mostrando la advertencia "no se puede verificar el desarrollador".

Solución: Asegúrate de haber hecho clic derecho y seleccionado "Open" en el primer inicio. Si el problema persiste:

  1. Abre System Settings > Privacy & Security.
  2. Desplázate hacia abajo hasta la sección de seguridad.
  3. Deberías ver un mensaje sobre que Rephlo está bloqueado. Haz clic en "Open Anyway".

Rephlo no aparece en las listas de permisos​

Síntoma: Abres System Settings > Accessibility pero Rephlo no aparece en la lista.

Solución: Abre Rephlo al menos una vez. macOS añade aplicaciones a las listas de permisos solo después de que la app intenta usar por primera vez la función protegida. Tras abrirla, vuelve a comprobar la lista de permisos.

Próximos pasos​

Ya tienes todo configurado en macOS. Estos son los próximos pasos recomendados: