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.
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.
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()
// 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
})
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 |
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)
Aufgebaut auf dem nativen Capture-Stack jeder Plattform: ScreenCaptureKit unter macOS und eine NativeAOT-Windows-Bridge für Video- und Audioaufnahme.
Nehmen Sie Systemton und Mikrofoneingang gemeinsam auf oder deaktivieren Sie jeweils eine Quelle mit den einfachen Optionen audio und microphone.
Paket installieren und aufnehmen. Weder Xcode noch .NET SDK noch node-gyp sind auf dem Rechner des Nutzers nötig.
Gibt Standard-MP4-Dateien (H.264/AAC) direkt auf die Festplatte aus, bereit zur sofortigen Wiedergabe oder Weitergabe.
Fügt sich ohne zusätzliche Wrapper sauber in moderne asynchrone Abläufe oder älteren Callback-Code ein.
Eine kleine CommonJS-API, die sich ohne zusätzlichen Bundler-Aufwand in Node.js- oder Electron-Projekte einfügt.
| 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.
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.
| 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 |
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.
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.
Ja. Beide sind standardmäßig aktiviert, und Sie können jede Quelle mit der Option audio oder microphone deaktivieren.
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.
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.
npm install screenwire
MIT-lizenziert · Entwickelt und gepflegt von BreakingPoint