Essaie-moi !
Enregistrer l’écran 1Enregistrement 0:00 · cliquer pour arrêter
Luxel 2026-08-24
00:22 · 10.8 MB · MP4

Documentation de Luxel

Utilisez Luxel du premier lancement à l’exportation finale.

Luxel est un enregistreur de barre des menus pour Mac qui prend en charge la capture d’écran et de zone, les clips du tampon de relecture, l’enregistrement audio seul, les aperçus de caméra superposés, les transcriptions locales, l’automatisation en ligne de commande, les exportations rapides et celles effectuées dans l’éditeur.

Démarrer en trois étapes

  1. Lancez Luxel et repérez-le dans la barre des menus.
  2. N’accordez que les autorisations nécessaires à la capture que vous allez effectuer.
  3. Choisissez une cible, enregistrez, puis ouvrez le résultat dans l’éditeur ou le Finder.

Capturer depuis l’app, le tampon ou des scripts

Utilisez la barre des menus pour les enregistrements interactifs, les raccourcis globaux pour les actions répétées, le tampon de relecture pour les moments déjà passés et la commande luxel pour les captures scriptées.

Configuration

Installation et premier lancement

Installer Luxel

  1. Installez et lancez Luxel.
  2. Conservez l’app dans un emplacement stable avant d’accorder les autorisations.
  3. Ouvrez Luxel depuis le Finder ou le Launchpad.
  4. Repérez l’élément d’état Luxel dans la barre des menus de macOS.

Luxel nécessite macOS 26.0 ou une version ultérieure. Luxel fonctionne depuis la barre des menus : son élément est donc le point de départ principal pour les captures et les réglages.

Première capture

  1. Ouvrez Luxel depuis la barre des menus.
  2. Choisissez une cible dans Cible, ou utilisez Zone pour tracer une région personnalisée.
  3. N’activez Audio système, Microphone ou Caméra que si l’enregistrement en a besoin.
  4. Cliquez sur Enregistrer la source, Enregistrer la zone ou Enregistrer l’audio.
  5. Arrêtez l’enregistrement depuis les commandes d’état de la barre des menus, les commandes actives ou le raccourci.

Confidentialité

Autorisations

Luxel ne demande une autorisation que lorsqu’une fonctionnalité en a besoin. Des indicateurs apparaissent dans le menu lorsqu’une autorisation requise manque.

Enregistrement de l’écran et de l’audio système

Requis pour capturer un écran, une fenêtre, une zone ou l’audio système. macOS peut l’intituler « Enregistrement de l’écran et de l’audio système » dans Réglages Système > Confidentialité et sécurité.

Après avoir accordé l’accès, quittez puis rouvrez Luxel.

Microphone

Requis lorsque Enregistrer le microphone est activé, lorsque le bouton du microphone du sélecteur de zone est activé, lorsque vous démarrez un enregistrement audio uniquement ou tant que les invites facultatives de détection de parole sont activées.

Vous pouvez choisir Réglage système par défaut ou un périphérique d’entrée précis.

Notifications

Requises uniquement lorsque les invites de détection de parole sont activées. Luxel utilise les notifications pour vous demander si vous souhaitez démarrer un enregistrement audio après un signal de détection.

Une notification ne démarre jamais un enregistrement toute seule.

Caméra

Requise lorsque l’aperçu caméra est activé. Luxel utilise la caméra choisie pour afficher un aperçu flottant superposé aux enregistrements.

Les commandes de caméra apparaissent après le choix d’un périphérique.

Reconnaissance vocale

Requise pour générer des transcriptions locales dans l’éditeur ou depuis la ligne de commande. Luxel utilise la reconnaissance vocale sur l’appareil.

Luxel ne la demande qu’au démarrage d’une transcription.

Conseil sur les autorisations

Après avoir modifié l’accès Enregistrement de l’écran et de l’audio système, quittez et rouvrez Luxel. Si macOS continue de vous interroger, vérifiez que vous ouvrez toujours la même copie de Luxel.

Modèle

Concepts fondamentaux

La barre des menus avant tout

Luxel réside dans la barre des menus. Le panneau contient la sélection de cible, les boutons de capture, les options audio, l’état des autorisations, les fichiers récents, les commandes de relecture et l’accès aux réglages.

Cibles

Une cible peut être un écran, une fenêtre d’app ou une zone sélectionnée. Les commandes de fenêtre active et de plein écran déterminent leur cible au démarrage de la capture.

Dossier des enregistrements

Les nouveaux enregistrements sont placés par défaut dans ~/Movies/Luxel. Vous pouvez choisir un autre dossier dans les réglages Sortie.

Éditeur

Les enregistrements vidéo standard s’ouvrent dans l’éditeur après la capture. Les enregistrements audio seuls peuvent y être lus, transcrits et exportés. Les exportations rapides peuvent produire directement un fichier ou déclencher une action finale.

Exportations rapides

Les préréglages d’exportation peuvent convertir une capture en GIF, MP4, HEVC MP4, ProRes MOV ou APNG sans ouvrir manuellement chaque commande d’exportation.

Tampon de relecture

Le tampon de relecture est un mode de capture continue à activer volontairement. Il conserve l’historique récent de l’écran afin d’exporter la durée choisie sous forme d’enregistrement MP4 normal.

Transcriptions locales

Luxel transcrit l’audio sur votre Mac. L’identification locale peut distinguer les intervenants, reconnaître des intervenants connus et étiqueter les tours de parole. Les transcriptions restent dans l’éditeur ou sont écrites par la CLI en texte ou JSON.

Fichiers récents

Le menu affiche le dernier enregistrement et un menu Récents permettant d’ouvrir les clips dans l’éditeur ou de les afficher dans le Finder.

Guide

Guide de capture

Enregistrer un écran, une fenêtre ou une zone

  1. Ouvrez Luxel depuis la barre des menus.
  2. Choisissez Cible, puis sélectionnez un écran ou une fenêtre.
  3. Activez Audio système ou Microphone si nécessaire.
  4. Cliquez sur Enregistrer la source ou utilisez Enregistrer la zone pour une région choisie.
  5. Utilisez Arrêter, Pause ou Reprendre dans les commandes d’enregistrement.

Les enregistrements audio seuls ne peuvent pas être mis en pause et repris.

Ajuster le comportement de capture

  • Choisissez une fréquence fixe de 1 à 120 IPS ou adaptez-la au taux de rafraîchissement de l’écran.
  • Choisissez si le pointeur est visible et si les clics sont mis en évidence.
  • Activez l’audio système, le microphone ou les deux avant l’enregistrement.
  • Utilisez le compte à rebours et l’arrêt automatique pour programmer le début ou la fin.

Enregistrer uniquement l’audio

  1. Accordez l’autorisation Microphone.
  2. Choisissez Réglage système par défaut ou une entrée précise dans les réglages Enregistrement.
  3. Choisissez AAC ou ALAC comme format audio seul.
  4. Cliquez sur Audio dans la barre des menus ou utilisez le raccourci Audio seul.

Les fichiers audio seuls utilisent l’extension .m4a .

Ajouter un aperçu caméra

  1. Ouvrez les réglages Enregistrement ou le menu caméra du sélecteur de zone.
  2. Choisissez une caméra et accordez l’autorisation Caméra.
  3. Choisissez la forme Superellipse, Arrondie ou Carrée.
  4. Activez éventuellement Détourage pour isoler la personne ou Fond vert pour supprimer un arrière-plan chromatique.
  5. Choisissez la taille de la superposition et l’effet miroir.
  6. Placez l’aperçu flottant avant ou pendant la configuration.

L’aperçu flottant apparaît dans l’enregistrement lorsqu’il chevauche la cible.

Utiliser le compte à rebours et l’arrêt automatique

Le sélecteur de zone propose les comptes à rebours Désactivé, 3 secondes, 5 secondes et 10 secondes. Les options Arrêter après comprennent Désactivé, 10 secondes, 30 secondes, 1 minute, 5 minutes et une durée personnalisée de 0:01 à 12:00:00.

Un arrêt pendant le compte à rebours annule celui-ci sans enregistrer.

Guide

Invites de détection de parole

Cette fonction facultative écoute un son continu ressemblant à de la parole sur le microphone sélectionné et vous demande si vous souhaitez démarrer un enregistrement audio uniquement. Elle est désactivée par défaut et n’identifie ni réunions, ni appels, ni locuteurs, ni mots, ni sens.

Activer les invites

  1. Ouvrez Réglages > Enregistrement.
  2. Activez Notifier quand de la parole est détectée.
  3. Lisez l’explication, puis choisissez Activer pour accepter.
  4. Autorisez d’abord les notifications, puis l’accès au microphone.
  5. Choisissez Réglage système ou un microphone précis.

Activez Ouvrir à la connexion si vous souhaitez que la fonction soit disponible après votre connexion. La détection ne fonctionne que tant que Luxel est ouvert.

Choisissez ce qui se passe

Lorsque Luxel détecte un signal, la notification propose Démarrer l’enregistrement et Ignorer. Démarrer l’enregistrement lance un enregistrement audio uniquement avec le microphone sélectionné. Ignorer ne fait rien, et l’ouverture de la notification active Luxel sans enregistrer.

Les modes Concentration et les autres réglages de notification de macOS peuvent retarder ou masquer l’invite. Une invite est une aide, pas une garantie que Luxel reconnaisse une conversation.

Ce que Luxel traite

Lorsque la fonction est activée, Luxel analyse en continu de courtes trames du microphone sur votre Mac. Avant que vous choisissiez explicitement Démarrer l’enregistrement, ces trames sont supprimées et Luxel ne crée aucun pré-enregistrement, fichier multimédia, élément d’historique, transcription, fichier annexe ou envoi vers le cloud.

Le détecteur recherche uniquement un son continu ressemblant à de la parole. Il n’examine pas l’état des apps et ne décide pas si vous participez à une réunion ou à un appel.

Pauses automatiques

Luxel met l’analyse du microphone en pause pendant un enregistrement actif et lorsque votre Mac est verrouillé ou que son écran est en veille. L’analyse reprend automatiquement à la fin de l’enregistrement ou lorsque votre Mac est de nouveau éveillé et déverrouillé.

Désactiver ou rétablir l’accès

Désactivez Notifier quand de la parole est détectée pour arrêter l’analyse et supprimer toute invite en attente. Si l’accès a été refusé, ouvrez Réglages Système > Confidentialité et sécurité > Microphone et Réglages Système > Notifications > Luxel. Choisissez une entrée disponible dans les réglages Enregistrement, puis réactivez la fonction.

Guide

Capturer ce qui vient de se passer

Le tampon de relecture conserve en continu l’historique récent de l’écran lorsqu’il est actif. Il est facultatif, visible dans la barre des menus et utilise la même autorisation Enregistrement de l’écran et de l’audio système qu’une capture normale.

Configurer le tampon de relecture

  1. Ouvrez Réglages > Tampon de relecture.
  2. Activez le tampon et acceptez la demande de consentement initiale.
  3. Choisissez une durée : 30 secondes, 1 minute, 2 minutes ou 5 minutes.
  4. Choisissez 24 IPS ou 30 IPS.
  5. N’activez Inclure l’audio système que si les clips ont besoin du son du Mac.
  6. Choisissez si les clips s’ouvrent dans l’éditeur ou utilisent la destination d’exportation rapide.

L’utiliser depuis le menu

  1. Démarrez le tampon de relecture depuis la commande de la barre des menus.
  2. Attendez que l’état passe de démarrage à mise en mémoire tampon.
  3. Cliquez sur Exporter pour enregistrer la durée récente choisie.
  4. Utilisez Démarrer et Arrêter pour activer ou désactiver le tampon.
  5. Utilisez le raccourci Créer un clip du tampon ou luxel clip pour la même action.

Comportement et confidentialité

  • Le tampon de relecture capture l’écran avec le pointeur et conserve des segments temporaires dans le cache de Luxel lorsqu’il est actif.
  • Les enregistrements normaux mettent le tampon en pause ; il reprend à leur arrêt.
  • Le tampon se met en pause pour des raisons système : mise en veille, verrouillage, batterie ou changement d’écran.
  • Reprendre au lancement reste désactivé sauf si vous l’activez dans les réglages du tampon.
  • Les clips sont des fichiers MP4 nommés comme Luxel Replay 2026-07-01 at 14.30.00.mp4.

Si vous créez un clip avant que l’historique soit suffisant, Luxel enregistre la partie disponible sans inventer le temps manquant.

Sélecteur de zone

Sélectionner et affiner une zone

Tracer une sélection

Cliquez sur Zone pour ouvrir la superposition de sélection en plein écran. Faites glisser pour tracer une région, redimensionnez-la avec les poignées ou utilisez Écran entier. La sélection minimale mesure 32 × 32 pixels.

Les tailles prédéfinies comprennent 1280 × 720, 1920 × 1080 et 800 × 600. Les proportions proposées sont Libre, 16:9, 4:3, 1:1, 9:16 et 21:9.

Commandes utiles

  • Choisissez les commandes de compte à rebours, arrêt après, audio, caméra, proportion et taille.
  • Activez ou désactivez le microphone et la caméra lorsque les autorisations le permettent.
  • Utilisez la loupe pour des bords précis.
  • Assombrissez les autres écrans ou restaurez la dernière sélection dans les réglages Préréglages.
  • Ouvrez les réglages Concentration depuis le rappel de notification pour limiter les interruptions.

Raccourcis et gestes du sélecteur de zone

EntréeAction
EscAnnuler la sélection de zone.
ZAnnuler une modification de sélection.
ZRétablir une modification de sélection.
clickUtiliser le préréglage d’enregistrement rapide actif lorsqu’il existe.

Guide

Modifier et exporter les enregistrements

Ouvrir et examiner

Après l’arrêt d’un enregistrement vidéo standard, Luxel ouvre l’éditeur avec un aperçu, le nom du fichier source, la durée, les dimensions, l’état de l’audio et de l’alpha, la taille estimée et les commandes Enregistrer l’original et Exporter.

Renommez le fichier source sur place et parcourez les enregistrements plus récents ou plus anciens du même dossier. La CLI peut également ouvrir un fichier multimédia autorisé avec luxel editor <file>.

Rogner, redimensionner et changer la vitesse

  • Utilisez les commandes de début et de fin de la chronologie pour rogner la plage de sortie.
  • Choisissez Original, un pourcentage prédéfini ou une largeur et une hauteur personnalisées.
  • Utilisez Recadrer pour remplir lors de l’ajustement de la taille de sortie.
  • Réglez la fréquence d’images et la vitesse de lecture de 0,1× à 10×.
  • La lecture de l’aperçu boucle dans la plage rognée.

Choisir les formats d’exportation

FormatRemarques
MP4 (H.264)Exportation vidéo la plus compatible en qualité Compacte, Équilibrée ou Élevée.
MP4 (HEVC)Exportation HEVC plus légère en qualité Compacte, Équilibrée ou Élevée.
MOV (ProRes 422)Exportation de montage et de mastering en qualité Élevée fixe avec audio LPCM.
MOV (ProRes 4444)Exportation ProRes haute fidélité en qualité Élevée fixe avec audio LPCM.
GIFExportation d’image animée. L’audio est supprimé. Prend en charge la boucle et le tramage.
APNGExportation PNG animée sans perte. L’audio est supprimé.
WebM (VP9)Exportation WebM en qualité Compacte, Équilibrée ou Élevée.
MP4 (AV1)Exportation AV1 MP4 avec audio AAC via l’encodeur SVT-AV1 inclus.

Le menu Format permet de sélectionner plusieurs formats et affiche une estimation de taille lorsque Luxel peut la calculer. Les exports MP4, MOV, WebM et AV1 utilisent des dimensions de pixels paires.

Ajuster l’audio

  • Utilisez Inclure l’audio pour le couper ou le conserver dans les formats compatibles.
  • Réglez le niveau audio de 0 % à 200 %.
  • Activez Normaliser l’audio pour équilibrer le volume pendant l’exportation.
  • Les sources audio seules s’exportent en M4A, ALAC M4A, WAV, CAF ou FLAC.

GIF et APNG suppriment toujours l’audio.

Actions d’exportation

Pendant l’exportation, Luxel affiche la progression et permet d’annuler. Ensuite, vous pouvez Ouvrir, Afficher dans le Finder, Enregistrer une copie, Ouvrir avec, Copier le fichier, Copier le chemin et Partager. Une exportation multiformat crée un dossier de lot portant le nom de l’enregistrement source.

Copier l’image et Enregistrer l’image sous utilisent l’image actuellement en pause et l’enregistrent en PNG.

Guide

Créer des transcriptions locales

Luxel transcrit localement les enregistrements qui contiennent de l’audio. Utilisez l’éditeur pour la révision ou la CLI lorsqu’un script a besoin de texte ou de données structurées.

Pour des transcriptions plus nettes

Utilisez un casque ou des AirPods lorsque vous enregistrez ensemble l’audio système et le microphone. Les haut-parleurs du Mac peuvent renvoyer le même son dans le micro, dupliquer le texte entre les sources et réduire la précision de la transcription et des étiquettes d’intervenant.

Dans l’éditeur

  1. Ouvrez dans l’éditeur un enregistrement avec audio.
  2. Utilisez l’aperçu de transcription pour générer ou relire le texte.
  3. Recherchez du texte ou sélectionnez des passages pour déplacer la lecture.
  4. Laissez Segmenter les tours de transcription activé pour les grouper automatiquement.
  5. Désactivez-le dans Réglages > Transcriptions pour obtenir plus vite des transcriptions brutes sur les longs enregistrements.

Identifier et gérer les intervenants

  1. Activez Identifier les intervenants dans Réglages > Transcriptions.
  2. Générez une transcription pour séparer et étiqueter localement chaque voix détectée.
  3. Dans la fiche Intervenants, utilisez Détection automatique ou définissez un nombre Exact ou une Plage, puis relancez la détection.
  4. Écoutez des exemples, nommez un intervenant détecté, enregistrez-le comme Intervenant connu, rattachez-le à un profil existant ou ignorez-le.
  5. Les futures transcriptions peuvent reconnaître automatiquement les intervenants connus enregistrés.

Les profils vocaux et le traitement des intervenants restent sur votre Mac.

Depuis la ligne de commande

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

Par défaut, le texte brut est écrit sur stdout. Utilisez --format json pour obtenir toutes les données segmentées par tours, avec les étiquettes d’intervenant lorsque --diarize est activé.

Flux de travail

Flux de travail composés

Capturer, affiner, exporter, partager

  1. Enregistrez un écran, une fenêtre ou une zone.
  2. Arrêtez pour ouvrir l’éditeur.
  3. Rognez la plage et choisissez la taille, la fréquence et la vitesse.
  4. Exportez en MP4, HEVC, ProRes MOV, GIF, APNG, WebM ou AV1.
  5. Utilisez Copier le chemin, Partager ou Afficher dans le Finder dans le menu du fichier exporté.

GIF rapide d’une zone sélectionnée

  1. Créez un préréglage d’exportation au format GIF avec la destination voulue.
  2. Définissez-le comme préréglage d’enregistrement rapide.
  3. Ouvrez Zone, tracez une sélection et appuyez surclickEnregistrer.
  4. Laissez le préréglage exécuter son action finale après la capture.

Répéter une capture précédente

  1. Activez Mémoriser la dernière capture dans les réglages Préréglages.
  2. Effectuez une capture normale une fois.
  3. Utilisez Enregistrer rapidement la dernière capture via le raccourci, la CLI, l’automatisation URL ou un raccourci d’app.
  4. Pour une nouvelle zone, utilisez l’action Enregistrement rapide du sélecteur avec le préréglage actif.

Revoir un problème après son apparition

  1. Activez le tampon de relecture avant le début de la session.
  2. Choisissez 1, 2 ou 5 minutes selon l’historique nécessaire.
  3. Lorsque le problème apparaît, cliquez sur Exporter ou exécutez luxel clip --seconds 30.
  4. Ouvrez le clip dans l’éditeur ou laissez la destination d’exportation rapide le traiter.

Transfert d’une image en pause

  1. Ouvrez un enregistrement dans l’éditeur.
  2. Mettez en pause sur l’image voulue.
  3. Utilisez Copier l’image ou Enregistrer l’image sous dans les actions de l’éditeur.
  4. Utilisez le PNG enregistré ou l’image du presse-papiers dans l’app de destination.

Exportation et transcription scriptées

  1. Installez la CLI depuis son dépôt GitHub, puis exécutez luxel pair.
  2. Exécutez luxel convert demo.mp4 demo.webm --width 1280 --height 720.
  3. Utilisez luxel convert demo.mp4 demo-av1.mp4 --format av1 si vous souhaitez du MP4 AV1.
  4. Exécutez luxel transcribe demo.mp4 --output demo.txt.
  5. Utilisez --format json pour les données de transcription ou, globalement, --json pour le résultat complet du terminal.

Référence

Raccourcis clavier

Ouvrez Réglages > Raccourcis pour activer, rechercher, modifier, réinitialiser ou effacer les raccourcis. Un raccourci personnalisé doit comporter une touche et au moins une touche de modification.

CommandeRaccourci par défautRésultat
Sélectionner une zoneROuvrir le sélecteur de zone pour enregistrer.
Basculer l’enregistrementTArrêter un enregistrement actif ou démarrer depuis la cible par défaut.
Enregistrer la fenêtre activeWEnregistrer la fenêtre actuellement active.
Enregistrer en plein écranFEnregistrer l’écran principal.
Audio seulADémarrer un enregistrement audio seul.
Enregistrer rapidement la dernière captureQUtiliser la dernière capture mémorisée avec le préréglage rapide.
Créer un clip du tampon de relectureCEnregistrer le contenu récent du tampon lorsqu’il est actif.

Avertissements de conflit

Luxel signale les raccourcis en double et les raccourcis de capture macOS connus.

345634

Référence

Outil de ligne de commande

Utilisez luxel pour les captures, les clips de relecture, la conversion, l’exportation et la transcription dans des scripts ou flux reproductibles. La CLI autonome envoie des requêtes authentifiées à l’app Luxel ; Luxel effectue tout le travail d’enregistrement et de traitement multimédia.

Installation

Installez la dernière version de luxel depuis Terminal :

curl -fsSL https://luxel.media/cli/install.sh | sh

Le programme d’installation vérifie la somme de contrôle, ajoute luxel à ~/.local/binet met à jour le chemin du shell. Ouvrez un nouveau terminal après l’installation.

Code source et README de la CLI

Jumeler avec Luxel

luxel pair
luxel doctor

Le jumelage ouvre une demande d’approbation visible dans Luxel. L’app et la CLI conservent des copies distinctes de l’identifiant dans le trousseau macOS. Désactivez le contrôle en ligne de commande ou révoquez un client à tout moment dans Réglages > Ligne de commande.

Exemples courants

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

Exemples multimédias

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 pour agents

Installez Luxel Skills pour permettre aux agents de codage compatibles d’utiliser l’ensemble de la CLI ou de créer des preuves WebM ciblées pour les revues.

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

Choisissez luxel pour la référence des commandes et les opérations, ou luxel-evidence pour un flux délibéré d’enregistrement et de pièces jointes.

Voir Luxel Skills sur GitHub.

Commandes

CommandeFonction
luxel --versionAfficher la version de Luxel CLI.
luxel pair [--name <name>]Jumeler cette CLI à Luxel par une approbation visible dans l’app.
luxel recordDémarrer un enregistrement depuis un écran, la fenêtre active ou la dernière zone sélectionnée.
luxel stopArrêter l’enregistrement actif.
luxel toggleArrêter l’enregistrement actif ou en démarrer un lorsqu’une cible est fournie.
luxel clipCréer un clip du tampon de relecture.
luxel latestOuvrir le dernier enregistrement ou l’afficher dans le Finder.
luxel editor <file>Ouvrir un fichier multimédia autorisé dans l’éditeur Luxel.
luxel convert <input> <output>Convertir ou modifier un média avec Luxel.
luxel export <request-json> <output>Exporter à partir d’un fichier JSON de requête d’exportation Luxel.
luxel transcribe <file>Transcrire localement un fichier multimédia ou audio avec Luxel.
luxel preferences [--pane <pane>]Ouvrir les réglages Luxel.
luxel access add <path>Demander à Luxel d’autoriser un dossier dans son sélecteur natif.
luxel access check <path>Vérifier si Luxel peut utiliser un chemin.
luxel access listRépertorier les autorisations de dossiers intégrés, d’enregistrements et supplémentaires.
luxel access revoke <grant-id>Supprimer une autorisation de dossier supplémentaire.
luxel doctorAfficher l’état de l’app, du jumelage, des autorisations et des dossiers.
luxel cancel <job-id>Annuler une tâche active de ligne de commande.

Détails des commandes

  • record nécessite exactement une cible : --display, --active-windowou --last-area.
  • record --fps et toggle --fps acceptent un nombre entier de 1 à 120 ou display pour suivre le taux de rafraîchissement de l’écran.
  • toggle arrête un enregistrement actif si aucune cible n’est transmise. Lors d’un démarrage, les options liées à la cible nécessitent une cible.
  • clip utilise la durée configurée du tampon sauf si --seconds est transmis.
  • latest --reveal affiche le dernier enregistrement dans le Finder au lieu de l’ouvrir.
  • preferences ouvre les réglages Luxel. --pane accepte general, presets, shortcuts, updatesou about comme indication d’URL, mais Luxel ouvre le panneau par défaut des Réglages.
  • convert déduit le format de l’extension de sortie, mais .mov nécessite --format prores422 ou --format prores4444, .m4a nécessite --format m4a ou --format alacet MP4 AV1 nécessite --format av1.
  • export accepte un document JSON de requête d’exportation Luxel pour les champs sans option dédiée.
  • Toutes les commandes attendent un résultat du terminal. Utilisez --timeout pour modifier la limite d’attente, --json pour une sortie structurée ou --quiet pour masquer les sorties réussies.

Accès aux dossiers

Luxel peut utiliser votre dossier Films, le dossier d’enregistrements configuré et les dossiers autorisés dans l’app. Un chemin du terminal ne contourne jamais 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 ouvre le sélecteur de dossiers de Luxel. Le dossier sélectionné est celui que l’app sera autorisée à utiliser.

Sécurité et confidentialité

Chaque invocation utilise une connexion authentifiée et éphémère sur127.0.0.1. Luxel rejette les clients non jumelés, les requêtes périmées, les nonces rejoués, les corps modifiés et les points de terminaison non locaux. La CLI ne reçoit jamais les signets à portée de sécurité de Luxel et ne traite elle-même aucun média.

Options de capture et de relecture

OptionSignification
--display <target>Enregistrer un écran. Utilisez main ou transmettez un identifiant d’écran.
--active-windowEnregistrer la fenêtre active.
--last-areaEnregistrer la dernière zone sélectionnée.
--preset <name>Utiliser un préréglage d’exportation Luxel pour l’enregistrement rapide.
--fps <1-120|display>Utiliser une fréquence fixe ou suivre le taux de rafraîchissement de l’écran.
--countdown <seconds>Attendre de 0 à 60 secondes avant le début de la capture.
--save-to <directory>Enregistrer dans un dossier accessible à Luxel.
--seconds <seconds>Créer un clip d’une durée précise du tampon avec luxel clip.

Options de conversion

OptionSignification
--format <format>Utilisez gif, hevc, mp4, av1, webm, apng, prores422, prores4444, m4a, alac, wav, caf ou flac.
--width <pixels> --height <pixels>Redimensionner l’exportation. Utilisez les deux options ensemble.
-s <width>x<height>Redimensionner avec une option de taille compacte.
--fps <frames>, -r <frames>Définir la fréquence d’images de sortie.
--start <seconds>, --ss <seconds>Définir le début de la plage exportée.
--end <seconds>, --to <seconds>Définir une heure de fin explicite.
--duration <seconds>, --t <seconds>Définir une durée à partir de l’heure de début.
--speed <value>Définir la vitesse de lecture entre 0,1 et 10.
--mute, -anExporter sans audio.
--crop-to-fillRemplir la taille de sortie par recadrage.
--crop <x,y,width,height>Utiliser un rectangle de recadrage explicite.
--quality <quality>Utiliser compact, balanced, high ou lossless lorsque le format le permet.
--overwrite, -yRemplacer un fichier de sortie existant.

Options de transcription

OptionSignification
--locale <identifier>Transcrire avec une langue précise. La langue actuelle est utilisée par défaut.
--output <file>Écrire la transcription dans un fichier plutôt que sur stdout.
--semantic-turnsUtiliser le regroupement automatique des tours de parole.
--diarizeIdentifier et étiqueter les intervenants avec le modèle local de diarisation inclus dans Luxel.
--format <text|json>Choisir du texte brut ou le JSON complet de transcription.
--overwrite, -yRemplacer le fichier de transcription s’il existe déjà.

Options globales

OptionSignification
--jsonAfficher l’événement de résultat du terminal en JSON.
--quietMasquer les sorties réussies.
--timeout <seconds>Définir la durée d’attente de Luxel. La valeur par défaut est 3600 secondes.
--helpAfficher l’aide de la commande actuelle.

Sortie et état de sortie

La sortie simple affiche le texte de transcription, un chemin, un identifiant d’enregistrement ou un court document d’état. --json affiche l’événement complet du terminal. L’état de sortie0 signifie réussite ; 2 indique une utilisation incorrecte ; 3 indique que la CLI n’est pas jumelée ; 4 signifie que Luxel n’a pas pu s’ouvrir ; 5 indique une erreur d’identifiant du trousseau ; 6 indique une erreur d’autorisation ou d’accès au dossier ;7 indique une erreur d’app, de protocole, d’E/S ou de JSON ; 8 indique un délai dépassé ; et 130 indique une annulation.

Référence

Formats d’exportation et de conversion

L’éditeur propose des formats vidéo et animés pour les captures d’écran, ainsi que des formats audio seuls lorsque la source est audio. La CLI propose les mêmes conversions aux scripts et demande à Luxel de les effectuer.

FormatCodec ou conteneurRemarques
MP4Vidéo H.264Exportation vidéo la plus compatible. Qualités Compacte, Équilibrée et Élevée.
HEVC MP4Vidéo HEVCExportation vidéo plus légère. Qualités Compacte, Équilibrée et Élevée.
ProRes 422 MOVApple ProRes 422Exportation de montage et de mastering en qualité Élevée fixe avec audio LPCM.
ProRes 4444 MOVApple ProRes 4444Exportation ProRes haute fidélité en qualité Élevée fixe avec audio LPCM.
GIFImage animéeSupprime l’audio. Prend en charge la boucle et les commandes dédiées à l’animation.
APNGPNG animéExportation d’image animée sans perte. Supprime l’audio.
WebMVP9 WebMExportation WebM. Qualités Compacte, Équilibrée et Élevée.
MP4 (AV1)Vidéo AV1 avec audio AACExportation AV1 MP4 via l’encodeur SVT-AV1 inclus.
M4AAudio AACFormat de conversion audio seul dans l’éditeur et en ligne de commande.
ALAC M4AAudio Apple LosslessFormat de conversion audio seul sans perte dans l’éditeur et en ligne de commande.
WAVAudio PCMFormat de conversion audio seul non compressé dans l’éditeur et en ligne de commande.
CAFCore Audio FormatFormat Apple de conversion audio seul dans l’éditeur et en ligne de commande.
FLACFree Lossless Audio CodecFormat de conversion audio seul sans perte dans l’éditeur et en ligne de commande.

Règles de format

GIF et APNG suppriment l’audio. Les exports MP4, MOV, WebM et AV1 utilisent des dimensions de pixels paires. ProRes produit du MOV, WebM utilise VP9 et AV1 produit du MP4.

Référence

Automatisation URL et raccourcis d’app

Schéma d’URL

Luxel enregistre le schéma luxel:// . Le démarrage des captures et la création de clips peuvent demander une confirmation sauf si l’appelant est autorisé ; stop, preferences et latest sont autorisés par défaut.

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

Les commandes d’automatisation acceptent des x-success et x-error URL de rappel. Les commandes qui produisent un fichier ajoutent filePath, les démarrages d’enregistrement ajoutent recordingIDet les échecs ajoutent errorMessage.

Utilisez directement le schéma d’URL pour l’automatisation x-callback.

Raccourcis d’app

Luxel propose des raccourcis d’app pour Démarrer l’enregistrement, Arrêter l’enregistrement, Basculer l’enregistrement, Créer un clip du tampon et Obtenir le dernier enregistrement. Démarrer et Basculer acceptent cible, préréglage et compte à rebours ; Créer un clip accepte des secondes ; Obtenir le dernier enregistrement peut afficher le fichier dans le Finder. Les phrases comprennent « Démarrer un enregistrement avec Luxel », « Arrêter Luxel », « Basculer Luxel », « Créer un clip du tampon avec Luxel » et « Afficher mon dernier enregistrement Luxel ».

Référence

Réglages et préférences

PanneauCe qu’il contrôle
EnregistrementVisibilité du curseur, surbrillance des clics, capture de 1 à 120 i/s ou adaptée à l’écran, audio système, audio du microphone, format audio uniquement, sélection du microphone, invites facultatives de détection de parole et commandes de l’incrustation caméra, notamment la forme, la suppression de l’arrière-plan, la taille et l’effet miroir.
SortieDossier d’enregistrements, exportations en boucle et demande de confirmation avant l’abandon d’un enregistrement.
PréréglagesPréréglages d’exportation rapide, tailles du sélecteur, comportement de la loupe, assombrissement et restauration de la dernière sélection.
RaccourcisActivation globale, recherche, modification personnalisée, réinitialisation/effacement et avertissements de conflit des raccourcis.
EncocheCommandes intégrées dans l’encoche, actions rapides au repos, forme d’onde d’enregistrement, délai de repli automatique et HUD flottant de secours.
Tampon de relectureActivation, durée du tampon, source écran avec pointeur, fréquence, audio système, reprise au lancement et destination des clips.
TranscriptionsLangue de transcription, segmentation des tours, identification locale et profils vocaux des intervenants connus.
Ligne de commandeActiver le contrôle, ouvrir le dépôt CLI, examiner les clients jumelés, révoquer l’accès et gérer les dossiers autorisés.
SystèmeMinuteur de barre des menus, rappels, lancement à l’ouverture de session, réglages de mise à jour et remerciements.

Préréglages rapides

Les préréglages d’exportation peuvent être ajoutés, dupliqués, supprimés, renommés et définis pour l’enregistrement rapide. Ils prennent en charge format, règle de taille, fréquence, destination et action finale. Les destinations sont le dossier Enregistrements ou le presse-papiers. Les préréglages rapides proposent GIF, MP4, HEVC MP4, ProRes 422 MOV, ProRes 4444 MOV et APNG ; WebM et AV1 restent disponibles dans l’éditeur et la CLI.

Tampon de relecture

Les réglages du tampon contrôlent l’activation, la durée, 24 ou 30 IPS, l’audio système, Reprendre au lancement et l’ouverture des clips dans l’éditeur ou leur destination rapide.

Ligne de commande

Les réglages Ligne de commande activent le contrôle externe, ouvrent le dépôt CLI, révoquent les clients et gèrent les dossiers utilisables par l’app.

Comportement système

Les réglages Système couvrent le minuteur de barre des menus, les rappels, le lancement à l’ouverture de session, les mises à jour et les remerciements.

Référence

Langues

Choisissez parmi 11 langues pour l’interface Luxel et les demandes d’autorisation système.

Langues prises en charge

  • Anglais
  • allemand (Allemagne)
  • espagnol d’Espagne
  • français (France)
  • italien (Italie)
  • japonais (Japon)
  • coréen (Corée du Sud)
  • Vietnamien
  • chinois simplifié
  • portugais brésilien
  • Portugais (Portugal)

Demandes d’autorisation

Les demandes pour la caméra, le microphone, la capture d’écran et la reconnaissance vocale apparaissent dans la langue choisie. Luxel ne demande chaque autorisation qu’à l’activation de la fonction correspondante ou au démarrage d’un enregistrement.

Luxel suit automatiquement la langue de macOS.

Aide

Dépannage

Luxel redemande sans cesse l’autorisation d’écran

Vérifiez que vous ouvrez toujours la même copie de Luxel. Après avoir modifié l’accès Enregistrement de l’écran et de l’audio système, quittez puis rouvrez Luxel.

Les boutons d’enregistrement sont désactivés

Choisissez une cible et résolvez les indicateurs d’autorisation visibles. La capture d’écran nécessite Enregistrement de l’écran et de l’audio système ; l’audio seul nécessite le microphone.

La capture d’écran échoue encore après l’autorisation

Quittez et rouvrez Luxel après avoir modifié l’accès. Si Luxel n’apparaît toujours pas, supprimez ses anciennes entrées de la liste des autorisations et rouvrez-le.

L’audio du microphone manque

Activez Enregistrer le microphone, choisissez un microphone valide ou Réglage système par défaut et accordez l’autorisation. Les exports GIF et APNG ne contiennent pas d’audio.

La détection de parole n’écoute pas

Ouvrez les réglages Enregistrement et vérifiez que Notifier quand de la parole est détectée est activé. Autorisez les notifications et l’accès au microphone, choisissez un microphone disponible et assurez-vous que Luxel est ouvert, qu’aucun enregistrement n’est actif et que votre Mac est éveillé et déverrouillé.

Aucune notification de détection de parole n’est apparue

Ouvrez Réglages Système > Notifications > Luxel et autorisez les notifications. Les modes Concentration et les autres réglages de notification de macOS peuvent retarder ou masquer les invites. La détection de parole n’est qu’un signal et ne garantit pas la reconnaissance de chaque conversation, réunion ou appel.

Le microphone sélectionné est indisponible

Ouvrez les réglages Enregistrement et choisissez Réglage système ou une autre entrée connectée. Luxel utilise le microphone sélectionné pour l’enregistrement comme pour la détection de parole.

L’enregistrement rapide est désactivé

Créez ou choisissez un préréglage rapide, puis une cible, ou activez Mémoriser la dernière capture afin que Luxel puisse la répéter.

Copier l’image ou Enregistrer l’image sous est désactivé

Mettez d’abord l’aperçu en pause. La capture utilise l’image en pause et l’enregistre en PNG.

Le raccourci ne réagit pas

Vérifiez que les raccourcis clavier sont activés, supprimez les doublons et évitez les raccourcis de capture macOS connus, notamment :

345634
Les commandes de l’encoche sont invisibles

Luxel utilise l’encoche intégrée si un écran avec encoche est détecté et que le réglage est activé. Sinon, il utilise le HUD flottant s’il est activé, ou uniquement l’état de la barre des menus.

Le tampon de relecture ne démarre pas

Activez le tampon, accordez l’autorisation Enregistrement de l’écran et de l’audio système et vérifiez qu’aucun enregistrement normal n’est actif. Luxel met le tampon en pause pendant les enregistrements normaux.

Les clips du tampon sont plus courts que demandé

Le tampon ne peut exporter que l’historique déjà capturé. Attendez que le menu indique qu’il est actif avant de créer un clip de toute la durée choisie.

La commande luxel est introuvable

Installez la CLI depuis le dépôt Luxel CLI sur GitHub et placez le binaire luxel dans un dossier de votre PATH.

La transcription par la CLI échoue

Exécutez luxel doctor, vérifiez que la transcription est disponible dans l’app et que Luxel peut accéder aux dossiers d’entrée et de sortie.

Aide

Questions fréquentes

Où sont enregistrés les enregistrements ?

Par défaut, les enregistrements sont placés dans ~/Movies/Luxel. Changez le dossier dans Réglages > Sortie.

Puis-je exporter de l’audio en GIF ou APNG ?

Non. GIF et APNG sont des formats d’image animée dans Luxel et suppriment l’audio. Utilisez MP4, HEVC MP4, ProRes MOV, WebM ou AV1 lorsque l’audio est nécessaire.

Comment fonctionne l’aperçu caméra ?

Choisissez une caméra dans les réglages Enregistrement ou le sélecteur de zone. Luxel affiche un aperçu flottant qui peut apparaître dans la zone capturée. Choisissez la forme Superellipse, Arrondie ou Carrée, une taille petite, moyenne ou grande et l’effet miroir. Détourage supprime l’arrière-plan autour de la personne ; Fond vert supprime un arrière-plan chromatique.

Puis-je exporter les enregistrements audio seuls ?

Oui. Ils sont enregistrés au format .m4a avec AAC ou ALAC. L’éditeur et la CLI peuvent exporter les sources audio seules en M4A, ALAC M4A, WAV, CAF ou FLAC.

Puis-je contrôler Luxel avec des scripts ?

Oui. Utilisez la commande luxel pour les flux shell, ou le schéma luxel:// depuis les apps capables d’ouvrir des URL.

Le tampon de relecture enregistre-t-il tout le temps ?

Non. Il reste désactivé jusqu’à ce que vous l’activiez. Lorsqu’il est actif, il est visible dans la barre des menus et peut être arrêté avec les mêmes commandes.

Puis-je utiliser Luxel sans ouvrir l’éditeur ?

Oui. Les exportations rapides, les destinations des clips, luxel convert, luxel exportet luxel transcribe peuvent se terminer directement.

Quelles langues sont localisées ?

Luxel comprend l’anglais, l’allemand, l’espagnol, le français, l’italien, le japonais, le coréen, le vietnamien, le chinois simplifié, le portugais (Brésil) et le portugais (Portugal).