macOS 13+ Windows 10/11 x64 Node 18+ MIT-Lizenz

Native Bildschirmaufnahme für
Node.js & Electron

Open-Source-Bildschirmaufnahme, die sich einfach ausliefern lässt: kein fragiles Setup, keine Überraschungen bei der Installation und keine Abhängigkeit von kostenpflichtigen SDKs.

Nehmen Sie Bildschirm, Systemton und Mikrofon unter macOS und Windows mit nativen Betriebssystem-APIs als MP4 auf, mit vorkompilierten Binärdateien von Anfang an.

npm install screenwire
Auf npm ansehen GitHub

Aufnahme in wenigen Zeilen starten.

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()

Wählen Sie, was aufgenommen wird

// Bildschirm + Systemton + Mikrofon (Standard)
await recorder.startAsync(outputPath)

// Nur Bildschirm + Mikrofon
await recorder.startAsync(outputPath, {
  audio: false
})

// Nur Bildschirm + Systemton
await recorder.startAsync(outputPath, {
  microphone: false
})

// Nur Bildschirm
await recorder.startAsync(outputPath, {
  audio: false,
  microphone: false
})

Optionen

audio steuert die Aufnahme des Systemtons. microphone steuert den Mikrofoneingang. Beide sind standardmäßig true.

Option Typ Standard Beschreibung
audio boolean true Systemton aufnehmen, der über die Lautsprecher wiedergegeben wird
microphone boolean true Mikrofoneingang aufnehmen, sofern verfügbar

Lieber Callbacks? Das geht auch.

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)

Warum Entwickler sich für Screenwire entscheiden

speed

Native Performance

Aufgebaut auf dem nativen Capture-Stack jeder Plattform: ScreenCaptureKit unter macOS und eine NativeAOT-Windows-Bridge für Video- und Audioaufnahme.

mic

Audio inklusive

Nehmen Sie Systemton und Mikrofoneingang gemeinsam auf oder deaktivieren Sie jeweils eine Quelle mit den einfachen Optionen audio und microphone.

settings_power

Keine Konfiguration

Paket installieren und aufnehmen. Weder Xcode noch .NET SDK noch node-gyp sind auf dem Rechner des Nutzers nötig.

movie

Eine einzige MP4-Datei

Gibt Standard-MP4-Dateien (H.264/AAC) direkt auf die Festplatte aus, bereit zur sofortigen Wiedergabe oder Weitergabe.

code

Promise- und Callback-APIs

Fügt sich ohne zusätzliche Wrapper sauber in moderne asynchrone Abläufe oder älteren Callback-Code ein.

data_object

Schlanke Schnittstelle

Eine kleine CommonJS-API, die sich ohne zusätzlichen Bundler-Aufwand in Node.js- oder Electron-Projekte einfügt.

Unterstützte Plattformen

Plattform Video Systemton Mikrofon Status
macOS 13+ (Apple Silicon) H.264 MP4 ✓ macOS 15+ Stabil
Windows 10/11 (x64) H.264 MP4 ✓ ✓ Stabil
Linux — — — Noch nicht

Unter macOS ist die Berechtigung „Bildschirmaufnahme“ erforderlich, das Betriebssystem fragt beim ersten Einsatz danach. Die Mikrofonaufnahme unter macOS setzt macOS 15 oder neuer voraus.

Unter Windows wird das Bildschirmvideo über GDI und ffmpeg aufgenommen, der Systemton über direkte WASAPI-Loopback-COM-Interoperabilität, und der Mikrofoneingang nutzt NAudio, sobald ein Gerät verfügbar ist.

API

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

Startet die Aufnahme in den angegebenen .mp4-Pfad und wird aufgelöst, sobald die Aufnahme läuft.

recorder.stopAsync() → Promise<string>

Beendet die Aufnahme, schließt die Datei ab und wird mit dem finalen Statusstring aufgelöst, sobald sie gespeichert ist.

recorder.start(outputPath[, options], onStatus)

Callback-Version von startAsync. Der Callback onStatus(message) erhält Fortschrittsstrings, während die Aufnahme startet und läuft.

recorder.stop(onStatus)

Callback-Version von stopAsync. Der Callback onStatus(message) erhält den finalen Statusstring.

recorder.isRecording()

Gibt true zurück, solange eine Aufnahme läuft.

Statusstrings

String Bedeutung
Checking permissions... Prüft unter macOS die Berechtigung zur Bildschirmaufnahme
Preparing screen capture... Einrichtung der Capture-Pipeline vor dem Start der Aufnahme
Recording to /path/file.mp4 Die Aufnahme läuft und schreibt in die Zieldatei
Stopping recording... Stop wurde aufgerufen, die MP4-Datei wird abgeschlossen
Saved recording to /path/file.mp4 Die Aufnahmedatei wurde erfolgreich geschrieben

Warum wir es gebaut haben

Wir haben Screenwire gebaut, weil wir bei BreakingPoint eine zuverlässige Bildschirmaufnahme in einer Electron-App brauchten und die vorhandenen Lösungen sich nur umständlich ausliefern ließen: ffmpeg-lastige Wrapper, verwaiste native Module oder kostenpflichtige SDKs mit Lizenzhürden. Also haben wir ein Paket gemacht, das sich sauber installieren lässt, die nativen APIs nutzt, die jede Plattform ohnehin mitbringt, und von der ersten Installation bis zur ersten Aufnahme einfach bleibt.

Häufig gestellte Fragen

Funktioniert Screenwire sowohl mit Node.js als auch mit Electron?

Ja. Das Paket ist sowohl für reine Node.js-Projekte als auch für Electron-Apps gebaut, mit einer kleinen CommonJS-API und ohne besonderes Bundler-Setup.

Kann es Systemton und Mikrofonton aufnehmen?

Ja. Beide sind standardmäßig aktiviert, und Sie können jede Quelle mit der Option audio oder microphone deaktivieren.

Brauche ich ffmpeg oder zusätzliche native Werkzeuge?

Nein. Screenwire wird mit vorkompilierten Binärdateien ausgeliefert und nutzt native Plattform-APIs, sodass Entwickler ffmpeg-Installationen, Xcode-Setup, .NET SDKs und die Fehlersuche mit node-gyp überspringen können.

Welche Plattformen werden derzeit unterstützt?

Aktuell unterstützt Screenwire macOS 13+ auf Apple Silicon und Windows 10/11 auf x64. Unter macOS setzt die Mikrofonaufnahme macOS 15+ voraus. Linux-Unterstützung ist geplant, aber noch nicht verfügbar.

Jetzt ausprobieren

npm install screenwire

MIT-lizenziert · Entwickelt und gepflegt von BreakingPoint