Screenwire funziona sia con Node.js sia con Electron?
Sì. Il pacchetto è pensato sia per i progetti Node.js puri sia per le app Electron, con una piccola API CommonJS e senza configurazioni particolari del bundler.
Registrazione dello schermo open source facile da distribuire: nessuna configurazione fragile, nessuna sorpresa durante l'installazione e nessun vincolo a SDK a pagamento.
Registra schermo, audio di sistema e microfono in MP4 su macOS e Windows usando le API native del sistema operativo, con binari precompilati inclusi fin dall'inizio.
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()
// Schermo + audio di sistema + microfono (predefinito)
await recorder.startAsync(outputPath)
// Solo schermo + microfono
await recorder.startAsync(outputPath, {
audio: false
})
// Solo schermo + audio di sistema
await recorder.startAsync(outputPath, {
microphone: false
})
// Solo schermo
await recorder.startAsync(outputPath, {
audio: false,
microphone: false
})
audio controlla la cattura dell'audio di sistema. microphone controlla l'ingresso del microfono. Entrambe sono true per impostazione predefinita.
| Opzione | Tipo | Predefinito | Descrizione |
|---|---|---|---|
| audio | boolean | true | Cattura l'audio di sistema riprodotto dagli altoparlanti |
| microphone | boolean | true | Cattura l'ingresso del microfono, se disponibile |
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)
Costruito sullo stack di cattura nativo di ogni piattaforma, con ScreenCaptureKit su macOS e un bridge Windows NativeAOT per la cattura di video e audio.
Cattura insieme audio di sistema e ingresso del microfono, oppure disattiva l'uno o l'altro con le semplici opzioni audio e microphone.
Installa il pacchetto e inizia a registrare. Nessun Xcode, nessun .NET SDK e nessun node-gyp richiesti sul computer dell'utente.
Produce file MP4 standard H.264/AAC direttamente su disco, pronti per la riproduzione o la condivisione immediata.
Si integra senza problemi nei moderni flussi asincroni o nel codice più datato basato su callback, senza wrapper aggiuntivi.
Una piccola API CommonJS che si integra nei progetti Node.js o Electron senza lavoro aggiuntivo sul bundler.
| Piattaforma | Video | Audio di sistema | Microfono | Stato |
|---|---|---|---|---|
| macOS 13+ (Apple Silicon) | H.264 MP4 | ✓ | macOS 15+ | Stabile |
| Windows 10/11 (x64) | H.264 MP4 | ✓ | ✓ | Stabile |
| Linux | — | — | — | Non ancora |
Su macOS è richiesto il permesso di Registrazione schermo e il sistema lo chiede al primo utilizzo. La cattura del microfono su macOS richiede macOS 15 o successivo.
Su Windows il video dello schermo viene catturato tramite GDI e ffmpeg, l'audio di sistema usa l'interoperabilità COM diretta con il loopback WASAPI e l'ingresso del microfono usa NAudio quando è disponibile un dispositivo.
recorder.startAsync(outputPath[, options]) → Promise<string>
Avvia la registrazione nel percorso .mp4 indicato e si risolve quando la registrazione è attiva.
recorder.stopAsync() → Promise<string>
Interrompe la registrazione, finalizza il file e si risolve con la stringa di stato finale una volta salvato.
recorder.start(outputPath[, options], onStatus)
Versione callback di startAsync. Il callback onStatus(message) riceve stringhe di avanzamento mentre la registrazione parte e prosegue.
recorder.stop(onStatus)
Versione callback di stopAsync. Il callback onStatus(message) riceve la stringa di stato finale.
recorder.isRecording()
Restituisce true mentre è in corso una cattura.
| Stringa | Significato |
|---|---|
Checking permissions... |
Verifica il permesso di registrazione dello schermo su macOS |
Preparing screen capture... |
Preparazione della pipeline di cattura prima dell'avvio della registrazione |
Recording to /path/file.mp4 |
La registrazione è attiva e scrive nel file di destinazione |
Stopping recording... |
È stato chiamato stop e il file MP4 viene finalizzato |
Saved recording to /path/file.mp4 |
Il file della registrazione è stato scritto correttamente |
Abbiamo creato Screenwire perché in BreakingPoint ci serviva una registrazione dello schermo affidabile dentro un'app Electron e le soluzioni esistenti erano scomode da distribuire: wrapper pesanti basati su ffmpeg, moduli nativi abbandonati o SDK a pagamento con vincoli di licenza. Così abbiamo realizzato un pacchetto che si installa senza intoppi, usa le API native che ogni piattaforma già offre e resta semplice dalla prima installazione alla prima registrazione.
Sì. Il pacchetto è pensato sia per i progetti Node.js puri sia per le app Electron, con una piccola API CommonJS e senza configurazioni particolari del bundler.
Sì. Entrambi sono attivi per impostazione predefinita e puoi disattivare l'uno o l'altro con l'opzione audio o microphone.
No. Screenwire include binari precompilati e usa le API native della piattaforma, quindi gli sviluppatori possono evitare installazioni di ffmpeg, configurazione di Xcode, .NET SDK e problemi con node-gyp.
Oggi Screenwire supporta macOS 13+ su Apple Silicon e Windows 10/11 su x64. Su macOS la cattura del microfono richiede macOS 15+. Il supporto per Linux è previsto, ma non ancora disponibile.
npm install screenwire
Licenza MIT · Sviluppato e mantenuto da BreakingPoint