Usa Luxel dal primo avvio all’esportazione finale.

Installa Luxel

1. Installa e avvia Luxel.
2. Mantieni l’app in una posizione stabile prima di concedere le autorizzazioni.
3. Apri Luxel dal Finder o dal Launchpad.
4. Cerca l’elemento di stato Luxel nella barra dei menu di macOS.

Luxel richiede macOS 26.0 o versioni successive. Funziona dalla barra dei menu, quindi il relativo elemento è il punto principale da cui avviare acquisizioni e aprire le impostazioni.

Prima acquisizione

1. Apri Luxel dalla barra dei menu.
2. Scegli una sorgente in Sorgente oppure usa Area per disegnare una regione personalizzata.
3. Abilita Audio di sistema, Microfono o Fotocamera solo se necessari alla registrazione.
4. Fai clic su Registra sorgente, Registra area o Registra audio.
5. Interrompi la registrazione dai controlli di stato nella barra dei menu, dai controlli della registrazione attiva o dalla scorciatoia.

Attivare gli avvisi

1. Apri Impostazioni > Registrazione.
2. Attiva Avvisa quando viene rilevata la voce.
3. Leggi l’informativa, poi scegli Abilita per accettare.
4. Consenti prima le notifiche, poi l’accesso al microfono.
5. Scegli Default di sistema o un microfono specifico.

Attiva Apri al login se vuoi che la funzione sia disponibile dopo l’accesso. Il rilevamento funziona solo mentre Luxel è aperto.

Scegli cosa succede

Quando Luxel rileva un segnale, la notifica propone Avvia registrazione e Ignora. Avvia registrazione avvia una registrazione solo audio con il microfono selezionato. Ignora non esegue alcuna azione e l’apertura della notifica attiva Luxel senza registrare.

Le modalità Full immersion e altre impostazioni delle notifiche di macOS possono ritardare o nascondere l’avviso. Un avviso è un aiuto, non una garanzia che Luxel riconosca una conversazione.

Configura il buffer replay

1. Apri Impostazioni > Buffer replay.
2. Abilita il buffer replay e approva la richiesta di consenso al primo utilizzo.
3. Scegli una durata: 30 secondi, 1 minuto, 2 minuti o 5 minuti.
4. Scegli 24 FPS o 30 FPS.
5. Attiva Includi audio di sistema solo se i clip richiedono l’audio del Mac.
6. Scegli se aprire i clip nell’editor o usare la destinazione di esportazione rapida.

Usalo dal menu

1. Avvia il buffer replay dal controllo nella barra dei menu.
2. Attendi che lo stato passi da avvio a bufferizzazione.
3. Fai clic su Esporta per salvare la durata recente selezionata.
4. Usa Avvia e Interrompi per attivare o disattivare il buffer.
5. Usa la scorciatoia Crea clip dal buffer replay o luxel clip per la stessa azione.

Disegna una selezione

Fai clic su Area per aprire la sovrapposizione di selezione a schermo intero. Trascina per disegnare una regione, ridimensionala con le maniglie oppure usa Schermo intero. La selezione minima è 32 × 32 pixel.

Le dimensioni predefinite includono 1280 × 720, 1920 × 1080 e 800 × 600. Le proporzioni includono Libera, 16:9, 4:3, 1:1, 9:16 e 21:9.

Controlli utili

• Scegli i controlli per conto alla rovescia, interruzione, audio, fotocamera, proporzioni e dimensioni.
• Attiva o disattiva microfono e fotocamera quando le autorizzazioni lo consentono.
• Usa la lente per bordi precisi.
• Oscura gli altri schermi o ripristina l’ultima selezione dalle impostazioni Preimpostazioni.
• Apri le impostazioni Full immersion dal promemoria di notifica per ridurre le interruzioni.

Nell’editor

1. Apri nell’editor una registrazione con audio.
2. Usa l’anteprima della trascrizione per generare o rivedere il testo.
3. Cerca nel testo o seleziona intervalli per spostare la riproduzione.
4. Lascia attivo Segmenta turni della trascrizione per raggrupparli automaticamente.
5. Disattivalo in Impostazioni > Trascrizioni per ottenere più rapidamente trascrizioni grezze di registrazioni lunghe.

Identifica e gestisci i parlanti

1. Abilita Identifica parlanti in Impostazioni > Trascrizioni.
2. Genera una trascrizione per separare ed etichettare localmente ogni voce rilevata.
3. Nella scheda Parlanti, usa Rilevamento automatico o imposta un numero Esatto o un Intervallo, poi ripeti il rilevamento.
4. Riproduci esempi vocali, assegna un nome a un parlante, salvalo come Parlante noto, collegalo a un profilo o ignoralo.
5. Le trascrizioni future possono riconoscere automaticamente i Parlanti noti salvati.

I profili vocali e l’elaborazione dei parlanti restano sul Mac.

Dalla riga di 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

Per impostazione predefinita, il testo semplice viene scritto su stdout. Usa --format json per i dati completi segmentati per turni, incluse le etichette dei parlanti quando --diarize è abilitato.

Abbina a Luxel

luxel pair
luxel doctor

L’abbinamento apre una richiesta di approvazione visibile in Luxel. L’app e la CLI memorizzano copie separate della credenziale nel Portachiavi di macOS. Puoi disabilitare il controllo da riga di comando o revocare un client in Impostazioni > Riga di comando.

Esempi comuni

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

Esempi multimediali

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

Skill per agenti

Installa Luxel Skills per consentire agli agenti di programmazione compatibili di usare l’intera CLI o creare prove WebM mirate per le revisioni.

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

Scegli luxel per il riferimento dei comandi e le operazioni, oppure luxel-evidence per un flusso intenzionale di registrazione e allegati.

Visualizza Luxel Skills su GitHub.

Accesso alle cartelle

Luxel può usare la cartella Filmati, la cartella registrazioni configurata e le cartelle autorizzate nell’app. Un percorso del terminale non aggira mai l’App Sandbox.

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

access add apre il selettore cartelle di Luxel. La cartella selezionata è quella che l’app ottiene il permesso di usare.

Sicurezza e privacy

Ogni invocazione usa una connessione autenticata e di breve durata su127.0.0.1. Luxel rifiuta client non abbinati, richieste obsolete, nonce riutilizzati, corpi modificati ed endpoint non loopback. La CLI non riceve mai i segnalibri con ambito di sicurezza di Luxel e non elabora direttamente i media.

Schema URL

Luxel registra lo schema luxel:// . L’avvio delle acquisizioni e la creazione di clip dal buffer possono richiedere conferma se il chiamante non è autorizzato; comandi come stop, preferences e latest sono consentiti per impostazione predefinita.

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

I comandi di automazione accettano x-success e x-error URL di callback. I comandi che producono correttamente un file aggiungono filePath, gli avvii di registrazione aggiungono recordingIDe gli errori aggiungono errorMessage.

Usa direttamente lo schema URL per l’automazione x-callback.

Preimpostazioni rapide

Le preimpostazioni di esportazione possono essere aggiunte, duplicate, eliminate, rinominate e assegnate alla Registrazione rapida. Supportano formato, regola di dimensione, frequenza, destinazione e azione successiva. Le destinazioni sono la cartella Registrazioni o gli appunti. Offrono GIF, MP4, HEVC MP4, ProRes 422 MOV, ProRes 4444 MOV e APNG; WebM e AV1 restano disponibili nell’editor e nella CLI.

Buffer replay

Le impostazioni del buffer controllano abilitazione, durata, 24 o 30 FPS, audio di sistema, Riprendi all’avvio e apertura dei clip nell’editor o nella destinazione rapida.

Riga di comando

Le impostazioni Riga di comando abilitano il controllo esterno, aprono il repository, revocano i client e gestiscono le cartelle utilizzabili dall’app.

Comportamento di sistema

Le impostazioni Sistema includono timer della barra dei menu, promemoria, avvio al login, aggiornamenti e riconoscimenti.

Impostazioni locali supportate

• Inglese
• tedesco (Germania)
• spagnolo europeo
• francese (Francia)
• italiano (Italia)
• giapponese (Giappone)
• coreano (Corea del Sud)
• Vietnamita
• cinese semplificato
• portoghese brasiliano
• Portoghese (Portogallo)

Richieste di autorizzazione

Le richieste per fotocamera, microfono, acquisizione dello schermo e riconoscimento vocale appaiono nella lingua selezionata. Luxel chiede ogni autorizzazione solo quando la relativa funzione viene abilitata o inizia una registrazione.

Luxel segue automaticamente la lingua di macOS.