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

Registrazione nativa dello schermo per
Node.js & Electron

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.

npm install screenwire
Vedi su npm GitHub

Inizia a registrare in poche righe.

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

Scegli cosa catturare

// 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
})

Opzioni

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

Preferisci i callback? Funziona anche così.

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)

Perché gli sviluppatori scelgono Screenwire

speed

Prestazioni native

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.

mic

Audio incluso

Cattura insieme audio di sistema e ingresso del microfono, oppure disattiva l'uno o l'altro con le semplici opzioni audio e microphone.

settings_power

Zero configurazione

Installa il pacchetto e inizia a registrare. Nessun Xcode, nessun .NET SDK e nessun node-gyp richiesti sul computer dell'utente.

movie

Un unico file MP4

Produce file MP4 standard H.264/AAC direttamente su disco, pronti per la riproduzione o la condivisione immediata.

code

API con Promise e callback

Si integra senza problemi nei moderni flussi asincroni o nel codice più datato basato su callback, senza wrapper aggiuntivi.

data_object

Superficie ridotta

Una piccola API CommonJS che si integra nei progetti Node.js o Electron senza lavoro aggiuntivo sul bundler.

Piattaforme supportate

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.

API

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.

Stringhe di stato

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

Perché l'abbiamo creato

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.

Domande frequenti

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.

Può registrare sia l'audio di sistema sia quello del microfono?

Sì. Entrambi sono attivi per impostazione predefinita e puoi disattivare l'uno o l'altro con l'opzione audio o microphone.

Mi servono ffmpeg o altri strumenti nativi?

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.

Quali piattaforme sono supportate al momento?

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.

Provalo ora

npm install screenwire

Licenza MIT · Sviluppato e mantenuto da BreakingPoint