Use o Luxel desde a primeira inicialização até a exportação final.

Instalar o Luxel

1. Instale e abra o Luxel.
2. Mantenha o app em um local fixo antes de conceder permissões.
3. Abra o Luxel pelo Finder ou Launchpad.
4. Localize o item de status do Luxel na barra de menus do macOS.

O Luxel exige macOS 26.0 ou posterior. Ele funciona pela barra de menus, portanto esse item é o local principal para iniciar capturas e abrir os ajustes.

Primeira captura

1. Abra o Luxel pela barra de menus.
2. Escolha um alvo em Alvo ou use Área para desenhar uma região personalizada.
3. Ative Áudio do sistema, Microfone ou Câmera somente se a gravação precisar deles.
4. Clique em Gravar fonte, Gravar área ou Gravar áudio.
5. Pare a gravação pelos controles de status da barra de menus, pelos controles da gravação ativa ou pelo atalho.

Ativar avisos

1. Abra Definições > Gravação.
2. Ative Notificar ao Detetar Fala.
3. Leia a explicação e escolha Ativar para aceitar.
4. Permita primeiro as notificações e depois o acesso ao microfone.
5. Escolha Predefinição do Sistema ou um microfone específico.

Ative Abrir ao iniciar sessão se pretender que a funcionalidade fique disponível depois de iniciar sessão. A deteção só funciona enquanto o Luxel está aberto.

Escolha o que acontece

Quando o Luxel deteta um sinal, a notificação oferece Iniciar Gravação e Ignorar. Iniciar Gravação começa uma gravação apenas de áudio com o microfone selecionado. Ignorar não faz nada, e abrir a notificação ativa o Luxel sem gravar.

Os modos Concentração e outras definições de notificação do macOS podem atrasar ou ocultar o aviso. Um aviso é uma conveniência, não uma garantia de que o Luxel reconhecerá uma conversa.

Configurar o buffer de repetição

1. Abra Ajustes > Buffer de repetição.
2. Ative o buffer e aprove a solicitação de consentimento inicial.
3. Escolha a duração: 30 segundos, 1 minuto, 2 minutos ou 5 minutos.
4. Escolha 24 FPS ou 30 FPS.
5. Ative Incluir áudio do sistema somente se os clipes precisarem do áudio do Mac.
6. Escolha se os clipes abrem no editor ou usam o destino de exportação rápida.

Usar pelo menu

1. Inicie o buffer de repetição pelo controle na barra de menus.
2. Aguarde o status mudar de iniciando para armazenando.
3. Clique em Exportar para salvar a duração recente selecionada.
4. Use Iniciar e Parar para ativar ou desativar o buffer.
5. Use o atalho Criar clipe do buffer de repetição ou luxel clip para a mesma ação.

Desenhar uma seleção

Clique em Área para abrir a sobreposição de seleção em tela cheia. Arraste para desenhar uma região, redimensione-a pelas alças ou use Tela inteira. A seleção mínima é de 32 × 32 pixels.

Os tamanhos predefinidos incluem 1280 × 720, 1920 × 1080 e 800 × 600. As proporções incluem Livre, 16:9, 4:3, 1:1, 9:16 e 21:9.

Controles úteis

• Escolha os controles de contagem, parada, áudio, câmera, proporção e tamanho.
• Ative ou desative o microfone e a câmera quando as permissões permitirem.
• Use a lupa para obter bordas precisas.
• Escureça outras telas ou restaure a última seleção nos ajustes de Predefinições.
• Abra os ajustes de Foco pelo lembrete de notificação para reduzir interrupções.

No editor

1. Abra no editor uma gravação com áudio.
2. Use a prévia da transcrição para gerar ou revisar o texto.
3. Pesquise texto ou selecione trechos para avançar a reprodução.
4. Mantenha Segmentar turnos da transcrição ativo para agrupá-los automaticamente.
5. Desative em Ajustes > Transcrições para obter transcrições brutas mais rapidamente em gravações longas.

Identificar e gerenciar participantes

1. Ative Identificar participantes em Ajustes > Transcrições.
2. Gere uma transcrição para separar e rotular localmente cada voz detectada.
3. No cartão Participantes, use Detecção automática ou defina um número Exato ou um Intervalo e execute novamente.
4. Reproduza exemplos de voz, nomeie um participante, salve-o como Participante conhecido, associe-o a um perfil ou ignore-o.
5. Transcrições futuras podem reconhecer automaticamente os Participantes conhecidos salvos.

Perfis de voz e processamento de participantes permanecem no Mac.

Pela linha de comando

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

Por padrão, texto simples é escrito em stdout. Use --format json para obter todos os dados segmentados por turno, incluindo rótulos de participante quando --diarize estiver ativo.

Emparelhar com o Luxel

luxel pair
luxel doctor

O emparelhamento abre uma solicitação de aprovação visível no Luxel. O app e a CLI armazenam cópias separadas da credencial nas Chaves do macOS. Desative o controle por linha de comando ou revogue um cliente em Ajustes > Linha de comando.

Exemplos comuns

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

Exemplos de mídia

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

Instale o Luxel Skills para que agentes de programação compatíveis possam usar toda a CLI ou criar evidências WebM focadas para revisões.

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

Escolha luxel para consultar comandos e executar operações, ou luxel-evidence para um fluxo intencional de gravação e anexos.

Ver o Luxel Skills no GitHub.

Acesso a pastas

O Luxel pode usar a pasta Filmes, a pasta de gravações configurada e as pastas autorizadas no app. Um caminho do terminal nunca ignora o 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 o seletor de pastas do Luxel. A pasta escolhida ali é a que o app recebe permissão para usar.

Segurança e privacidade

Cada chamada usa uma conexão autenticada e de curta duração em127.0.0.1. O Luxel rejeita clientes não emparelhados, solicitações antigas, nonces repetidos, corpos alterados e endpoints que não sejam de loopback. A CLI nunca recebe os marcadores com escopo de segurança do Luxel nem processa mídia diretamente.

Esquema URL

O Luxel registra o esquema luxel:// . Iniciar capturas e criar clipes do buffer pode exigir confirmação quando o chamador não tem acesso; comandos como stop, preferences e latest são permitidos por padrão.

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

URLs x-callback

Comandos de automação aceitam x-success e x-error URLs de retorno. Comandos que produzem um arquivo com sucesso adicionam filePath, inícios de gravação adicionam recordingIDe falhas adicionam errorMessage.

Use o esquema URL diretamente para automação x-callback.

Predefinições rápidas

Predefinições de exportação podem ser adicionadas, duplicadas, excluídas, renomeadas e atribuídas à Gravação rápida. Oferecem formato, regra de tamanho, taxa, destino e ação posterior. Os destinos são a pasta Gravações ou a área de transferência. Oferecem GIF, MP4, HEVC MP4, ProRes 422 MOV, ProRes 4444 MOV e APNG; WebM e AV1 permanecem no editor e na CLI.

Memória de repetição

Os ajustes do buffer controlam ativação, duração, 24 ou 30 FPS, áudio do sistema, Retomar ao iniciar e se os clipes abrem no editor ou no destino rápido.

Linha de comando

Os ajustes de Linha de comando permitem controle externo, abrem o repositório, revogam clientes e gerenciam pastas que o app pode usar.

Comportamento do sistema

Os ajustes do sistema abrangem temporizador da barra de menus, lembretes, abertura ao iniciar sessão, atualizações e agradecimentos.

Localidades compatíveis

• Inglês
• alemão (Alemanha)
• espanhol europeu
• francês (França)
• italiano (Itália)
• japonês (Japão)
• coreano (Coreia do Sul)
• Vietnamita
• chinês simplificado
• português do Brasil
• Português (Portugal)

Solicitações de permissão

As solicitações de câmera, microfone, captura de tela e reconhecimento de fala aparecem no idioma escolhido. O Luxel só pede cada permissão quando a função correspondente é ativada ou uma gravação começa.

O Luxel segue automaticamente o idioma do macOS.