Enregistrement d'écran natif pour Node.js & Electron
Un enregistrement d'écran open source simple à livrer : pas de configuration fragile, pas de surprises à l'installation et pas de dépendance à un SDK payant.
Enregistrez l'écran, le son système et le microphone en MP4 sur macOS et Windows grâce aux API natives du système, avec des binaires précompilés fournis dès le départ.
Construit sur la pile de capture native de chaque plateforme, avec ScreenCaptureKit sur macOS et un pont Windows NativeAOT pour la capture vidéo et audio.
mic
Audio inclus
Capturez ensemble le son système et l'entrée du microphone, ou désactivez l'un ou l'autre avec les simples options audio et microphone.
settings_power
Zéro configuration
Installez le paquet et lancez l'enregistrement. Ni Xcode, ni SDK .NET, ni node-gyp ne sont requis sur la machine de l'utilisateur.
movie
Un seul fichier MP4
Produit des fichiers MP4 standard H.264/AAC directement sur le disque, prêts pour une lecture ou un partage immédiats.
code
API Promise et callback
S'intègre proprement aux flux asynchrones modernes comme au code plus ancien à base de callbacks, sans wrappers supplémentaires.
data_object
Surface réduite
Une petite API CommonJS qui s'intègre aux projets Node.js ou Electron sans travail supplémentaire sur le bundler.
Plateformes prises en charge
Plateforme
Vidéo
Son système
Microphone
Statut
macOS 13+ (Apple Silicon)
H.264 MP4
✓
macOS 15+
Stable
Windows 10/11 (x64)
H.264 MP4
✓
✓
Stable
Linux
—
—
—
Pas encore
Sur macOS, l'autorisation d'enregistrement de l'écran est requise et le système la demande à la première utilisation. La capture du microphone sur macOS nécessite macOS 15 ou une version plus récente.
Sous Windows, la vidéo de l'écran est capturée via GDI et ffmpeg, le son système utilise l'interopérabilité COM directe avec le loopback WASAPI, et l'entrée du microphone passe par NAudio lorsqu'un périphérique est disponible.
Démarre l'enregistrement vers le chemin .mp4 indiqué et se résout dès que l'enregistrement est actif.
recorder.stopAsync() → Promise<string>
Arrête l'enregistrement, finalise le fichier et se résout avec la chaîne d'état finale une fois celui-ci enregistré.
recorder.start(outputPath[, options], onStatus)
Version callback de startAsync. Le callback onStatus(message) reçoit des chaînes de progression pendant le démarrage et le déroulement de l'enregistrement.
recorder.stop(onStatus)
Version callback de stopAsync. Le callback onStatus(message) reçoit la chaîne d'état finale.
recorder.isRecording()
Renvoie true tant qu'une capture est en cours.
Chaînes d'état
Chaîne
Signification
Checking permissions...
Vérification de l'autorisation d'enregistrement de l'écran sous macOS
Preparing screen capture...
Mise en place du pipeline de capture avant le début de l'enregistrement
Recording to /path/file.mp4
L'enregistrement est actif et écrit dans le fichier cible
Stopping recording...
Stop a été appelé et le fichier MP4 est en cours de finalisation
Saved recording to /path/file.mp4
Le fichier d'enregistrement a été écrit avec succès
Pourquoi nous l'avons créé
Nous avons créé Screenwire parce que nous avions besoin, chez BreakingPoint, d'un enregistrement d'écran fiable dans une application Electron, et que les solutions existantes étaient pénibles à livrer : wrappers lourds basés sur ffmpeg, modules natifs abandonnés ou SDK payants aux licences contraignantes. Nous avons donc fait un paquet qui s'installe proprement, utilise les API natives que chaque plateforme fournit déjà et reste simple de la première installation au premier enregistrement.
Questions fréquentes
Screenwire fonctionne-t-il à la fois avec Node.js et avec Electron ?
Oui. Le paquet est conçu à la fois pour les projets Node.js classiques et pour les applications Electron, avec une petite API CommonJS et sans configuration particulière du bundler.
Peut-il enregistrer le son système et le son du microphone ?
Oui. Les deux sont activés par défaut, et vous pouvez désactiver l'un ou l'autre avec l'option audio ou microphone.
Ai-je besoin de ffmpeg ou d'outils natifs supplémentaires ?
Non. Screenwire est livré avec des binaires précompilés et utilise les API natives de la plateforme, si bien que les développeurs peuvent se passer des installations de ffmpeg, de la configuration de Xcode, des SDK .NET et des problèmes avec node-gyp.
Quelles plateformes sont prises en charge actuellement ?
Aujourd'hui, Screenwire prend en charge macOS 13+ sur Apple Silicon et Windows 10/11 sur x64. Sous macOS, la capture du microphone nécessite macOS 15+. La prise en charge de Linux est prévue, mais pas encore disponible.