macOS 13+ Windows 10/11 x64 Node 18+ Licence MIT

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.

npm install screenwire
Voir sur npm GitHub

Lancez l'enregistrement en quelques lignes.

const recorder = require('screenwire')
const path = require('path')
const os = require('os')

const outputPath = path.join(os.homedir(), 'Desktop', 'recording.mp4')
const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms))

async function main() {
  await recorder.startAsync(outputPath)
  console.log('Recording started...')

  await sleep(5000)

  const status = await recorder.stopAsync()
  console.log(status)
}

main()

Choisissez ce qu'il faut capturer

// Écran + son système + microphone (par défaut)
await recorder.startAsync(outputPath)

// Écran + microphone uniquement
await recorder.startAsync(outputPath, {
  audio: false
})

// Écran + son système uniquement
await recorder.startAsync(outputPath, {
  microphone: false
})

// Écran uniquement
await recorder.startAsync(outputPath, {
  audio: false,
  microphone: false
})

Options

audio contrôle la capture du son système. microphone contrôle l'entrée du microphone. Les deux valent true par défaut.

Option Type Par défaut Description
audio boolean true Capture le son système diffusé par les haut-parleurs
microphone boolean true Capture l'entrée du microphone lorsqu'elle est disponible

Vous préférez les callbacks ? Ça marche aussi.

const recorder = require('screenwire')
const path = require('path')
const os = require('os')

const outputPath = path.join(os.homedir(), 'Desktop', 'recording.mp4')

recorder.start(outputPath, { microphone: false }, (status) => {
  console.log('[status]', status)
})

setTimeout(() => {
  recorder.stop((status) => {
    console.log('[done]', status)
  })
}, 5000)

Pourquoi les développeurs choisissent Screenwire

speed

Performances natives

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.

API

recorder.startAsync(outputPath[, options]) → Promise<string>

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.

Essayez-le maintenant

npm install screenwire

Licence MIT · Conçu et maintenu par BreakingPoint