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 requer o macOS 26.0 ou posterior. Funciona na barra de menus, que é o principal local para iniciar capturas e abrir as definições.

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âmara apenas se forem necessários para a gravação.
4. Clique em Gravar fonte, Gravar área ou Gravar áudio.
5. Pare a gravação pelos controlos de estado na barra de menus, pelos controlos 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 a memória intermédia de repetição

1. Abra Definições > Memória intermédia de repetição.
2. Ative a memória intermédia e aprove o pedido 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 apenas se os clips precisarem do áudio do Mac.
6. Escolha se os clips abrem no editor ou utilizam o destino de exportação rápida.

Usar pelo menu

1. Inicie a memória intermédia de repetição pelo controlo na barra de menus.
2. Aguarde o status mudar de iniciando para armazenando.
3. Clique em Exportar para guardar a duração recente selecionada.
4. Utilize Iniciar e Parar para ativar ou desativar a memória intermédia.
5. Utilize o atalho Criar clipe da memória intermédia 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 ecrã completo. Arraste para desenhar uma região, redimensione-a pelas pegas ou utilize Ecrã inteiro. A seleção mínima é de 32 × 32 píxeis.

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.

Controlos úteis

• Escolha os controlos de contagem decrescente, paragem, áudio, câmara, proporção e tamanho.
• Ative ou desative o microfone e a câmara quando as permissões o permitirem.
• Use a lupa para obter bordas precisas.
• Escureça os outros ecrãs ou restaure a última seleção nas definições de Predefinições.
• Abra as definições de Concentração pelo lembrete de notificações para reduzir as interrupções.

No editor

1. Abra no editor uma gravação com áudio.
2. Utilize a pré-visualização da transcrição para gerar ou rever 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 esta opção em Definições > Transcrições para obter transcrições simples mais rapidamente em gravações longas.

Identificar e gerir oradores

1. Ative Identificar oradores em Definições > Transcrições antes de transcrever.
2. Gere uma transcrição para separar e rotular localmente cada voz detectada.
3. Se a contagem de oradores estiver errada, utilize Deteção automática ou defina um número Exato ou um Intervalo e execute novamente.
4. Reproduza exemplos de voz, dê um nome a um orador, guarde-o como Orador conhecido, associe-o a um perfil ou ignore-o.
5. As transcrições futuras podem reconhecer automaticamente os Oradores conhecidos guardados.

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 um pedido de aprovação visível no Luxel. A aplicação e a CLI guardam cópias separadas da credencial no Porta-chaves do macOS. Desative o controlo pela linha de comandos ou revogue um cliente em Definições > Linha de comandos.

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 multimé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, pedidos antigos, nonces repetidos, corpos alterados e pontos de acesso que não sejam locais. A CLI nunca recebe os marcadores de acesso do Luxel nem processa conteúdos multimédia diretamente.

Esquema URL

O Luxel registra o esquema luxel:// . Iniciar capturas e criar clips da memória intermédia pode exigir confirmação quando a aplicação que faz o pedido não tem acesso; comandos como stop, preferences e latest são permitidos por predefiniçã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. Os comandos que criam um ficheiro com êxito acrescentam 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

As definições da memória intermédia controlam a ativação, a duração, 24 ou 30 FPS, o áudio do sistema, Retomar ao iniciar e se os clips abrem no editor ou no destino rápido.

Linha de comando

As definições de Linha de comandos permitem controlo externo, abrem o repositório, revogam clientes e gerem as pastas que a aplicação pode utilizar.

Comportamento do sistema

As definições do sistema abrangem o 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

Os pedidos de acesso à câmara, ao microfone, à captura do ecrã e ao 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.