Usa Luxel desde el primer inicio hasta la exportación final.

Instalar Luxel

1. Instala y abre Luxel.
2. Mantén la app en una ubicación estable antes de conceder permisos.
3. Abre Luxel desde Finder o Launchpad.
4. Busca el elemento de estado de Luxel en la barra de menús de macOS.

Luxel requiere macOS 26.0 o posterior. Funciona desde la barra de menús, por lo que su icono es el lugar principal para iniciar capturas y abrir los ajustes.

Primera captura

1. Abre Luxel desde la barra de menús.
2. Elige un objetivo en Objetivo o usa Área para dibujar una región personalizada.
3. Activa Audio del sistema, Micrófono o Cámara solo si la grabación los necesita.
4. Haz clic en Grabar fuente, Grabar área o Grabar audio.
5. Detén la grabación desde los controles de estado de la barra de menús, los controles de grabación activa o el atajo.

Activar los avisos

1. Abre Ajustes > Grabación.
2. Activa Notificar al detectar voz.
3. Lee la explicación y selecciona Activar para aceptar.
4. Permite primero las notificaciones y después el acceso al micrófono.
5. Elige Predeterminado del sistema o un micrófono concreto.

Activa Abrir al iniciar sesión si quieres que la función esté disponible después de entrar. La detección solo funciona mientras Luxel está abierto.

Elige qué ocurre

Cuando Luxel detecta una señal, la notificación ofrece Iniciar grabación y Descartar. Iniciar grabación comienza una grabación de solo audio con el micrófono seleccionado. Descartar no hace nada, y abrir la notificación activa Luxel sin grabar.

Los modos de concentración y otros ajustes de notificaciones de macOS pueden retrasar u ocultar el aviso. El aviso es una ayuda, no una garantía de que Luxel reconozca una conversación.

Configurar el búfer de repetición

1. Abre Ajustes > Búfer de repetición.
2. Activa el búfer de repetición y aprueba el aviso de consentimiento inicial.
3. Elige una duración: 30 segundos, 1 minuto, 2 minutos o 5 minutos.
4. Elige 24 FPS o 30 FPS.
5. Activa Incluir audio del sistema solo si los clips necesitan el audio del Mac.
6. Elige si los clips se abren en el editor o usan el destino de exportación rápida.

Usarlo desde el menú

1. Inicia el búfer de repetición desde el control de la barra de menús.
2. Espera a que el estado pase de iniciando a almacenando.
3. Haz clic en Exportar para guardar la duración reciente seleccionada.
4. Usa Iniciar y Detener para activar o desactivar el búfer.
5. Usa el atajo Crear clip del búfer de repetición o luxel clip para realizar la misma acción.

Dibujar una selección

Haz clic en Área para abrir la superposición de selección a pantalla completa. Arrastra para dibujar una región, redimensiónala con los tiradores o usa Pantalla completa. La selección mínima es de 32 × 32 píxeles.

Los tamaños predefinidos incluyen 1280 × 720, 1920 × 1080 y 800 × 600. Las proporciones incluyen Libre, 16:9, 4:3, 1:1, 9:16 y 21:9.

Controles útiles

• Elige los controles de cuenta atrás, detener tras, audio, cámara, proporción y tamaño.
• Activa o desactiva el micrófono y la cámara cuando los permisos lo permitan.
• Usa la lupa para precisar los bordes.
• Atenúa otras pantallas o restaura la última selección desde los ajustes de Preajustes.
• Abre los ajustes de Concentración desde el recordatorio de notificación si quieres menos interrupciones.

En el editor

1. Abre en el editor una grabación con audio.
2. Usa la vista previa para generar o revisar el texto de la transcripción.
3. Busca texto o selecciona fragmentos de la transcripción para saltar en la reproducción.
4. Mantén activado Segmentar turnos para agruparlos automáticamente.
5. Desactívalo en Ajustes > Transcripciones para obtener antes transcripciones sin procesar de grabaciones largas.

Identificar y gestionar hablantes

1. Activa Identificar hablantes en Ajustes > Transcripciones.
2. Genera una transcripción para separar y etiquetar localmente cada voz detectada.
3. En la tarjeta Hablantes, usa Detección automática o define un número Exacto o un Intervalo y repite la detección.
4. Reproduce ejemplos de voz, asigna nombre a un hablante, guárdalo como Hablante conocido, vincúlalo a un perfil o ignóralo.
5. Las transcripciones futuras pueden reconocer automáticamente a los hablantes conocidos guardados.

Los perfiles de voz y el procesamiento de hablantes permanecen en tu Mac.

Desde la línea de comandos

luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --overwrite
luxel transcribe demo.mp4 --locale en_US --semantic-turns --diarize

De forma predeterminada, el texto sin formato se imprime en stdout. Usa --format json para obtener los datos completos segmentados por turnos, incluidas las etiquetas de hablante cuando --diarize está activado.

Enlazar con Luxel

luxel pair
luxel doctor

El enlace abre una solicitud de aprobación visible en Luxel. La app y la CLI guardan copias separadas de la credencial en el llavero de macOS. Puedes desactivar el control por línea de comandos o revocar un cliente en Ajustes > Línea de comandos.

Ejemplos comunes

luxel record --display main --fps display --countdown 3
luxel record --active-window --fps 120
luxel toggle --last-area
luxel stop
luxel clip --seconds 30
luxel latest --reveal
luxel preferences

Ejemplos multimedia

luxel record --active-window --preset "Default" --save-to ~/Movies/Luxel
luxel editor ~/Movies/demo.mp4
luxel convert demo.mp4 demo.webm
luxel convert demo.mp4 demo-av1.mp4 --format av1
luxel convert demo.mp4 demo.gif --start 2 --duration 5 --fps 15 --width 800 --height 450
luxel convert demo.mp4 demo.mov --format prores422 --quality high
luxel export request.json output.webm --overwrite --json
luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --diarize --overwrite

Skills para agentes

Instala Luxel Skills para que los agentes de programación compatibles sepan usar toda la CLI o crear pruebas WebM específicas para las revisiones.

npx skills add https://github.com/rawcontext/luxel-skills
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel-evidence

Elige luxel para consultar comandos y realizar operaciones, o luxel-evidence para un flujo deliberado de grabación y adjuntos.

Ver Luxel Skills en GitHub.

Acceso a carpetas

Luxel puede usar tu carpeta Películas, la carpeta de grabaciones configurada y las carpetas que autorices en la app. Una ruta del terminal nunca elude el App Sandbox.

luxel access add ~/Desktop/Exports
luxel access check ~/Desktop/Exports/demo.mp4
luxel access list
luxel access revoke <grant-id>

access add abre el selector de carpetas de Luxel. La carpeta que elijas allí será la que la app podrá usar.

Seguridad y privacidad

Cada invocación usa una conexión autenticada y de corta duración en127.0.0.1. Luxel rechaza clientes sin enlazar, solicitudes antiguas, nonces repetidos, cuerpos modificados y extremos que no sean de bucle local. La CLI nunca recibe los marcadores con ámbito de seguridad de Luxel ni procesa medios por sí misma.

Esquema URL

Luxel registra el esquema luxel:// . Iniciar capturas y crear clips del búfer puede requerir confirmación salvo que quien llama tenga acceso; los comandos stop, preferences y latest están permitidos de forma predeterminada.

luxel://record?target=display&display=main&fps=display&countdown=3
luxel://record?target=activeWindow&preset=Default
luxel://toggle
luxel://stop
luxel://clip?seconds=30
luxel://preferences
luxel://latest?reveal=true

URL x-callback

Los comandos de automatización aceptan x-success y x-error URL de devolución. Los comandos que crean un archivo correctamente añaden filePath, los inicios de grabación añaden recordingIDy los errores añaden errorMessage.

Usa directamente el esquema URL para la automatización x-callback.

Preajustes rápidos

Los preajustes de exportación se pueden añadir, duplicar, eliminar, renombrar y asignar como preajuste de Grabación rápida. Admiten formato, regla de tamaño, frecuencia, destino y acción posterior. Los destinos son la carpeta Grabaciones o el portapapeles. Los preajustes rápidos ofrecen GIF, MP4, HEVC MP4, ProRes 422 MOV, ProRes 4444 MOV y APNG; WebM y AV1 siguen disponibles en el editor y la CLI.

Búfer de reproducción

Los ajustes del búfer controlan la activación, duración, 24 o 30 FPS, audio del sistema, Reanudar al abrir y si los clips se abren en el editor o en el destino rápido.

Línea de comandos

Los ajustes de Línea de comandos permiten el control externo, abren el repositorio, revocan clientes y gestionan las carpetas que la app puede usar.

Comportamiento del sistema

Los ajustes del sistema incluyen el temporizador de la barra de menús, recordatorios, abrir al iniciar sesión, actualizaciones y agradecimientos.

Configuraciones regionales compatibles

• Inglés
• alemán (Alemania)
• español de España
• francés (Francia)
• italiano (Italia)
• japonés (Japón)
• coreano (Corea del Sur)
• Vietnamita
• chino simplificado
• portugués de Brasil
• Portugués (Portugal)

Avisos de permisos

Los avisos de cámara, micrófono, captura de pantalla y reconocimiento de voz aparecen en el idioma elegido. Luxel solo solicita cada permiso al activar la función correspondiente o iniciar una grabación.

Luxel sigue automáticamente el idioma de macOS.