Ruffle - Emulatore di Adobe Flash Player

Ruffle è un emulatore di Adobe Flash Player essenziale per eseguire contenuti Flash legacy (giochi, animazioni, applicazioni e banner SWF). Funziona come applicazione standalone su tutti i sistemi operativi (tra cui Windows, macOS e Linux) e si integra nei browser tramite WebAssembly.

Ruffle fornisce build separate per Windows, macOS e Linux che funzionano come programmi normali: basta eseguire l'eseguibile e aprire il file SWF desiderato al suo interno.

Ruffle sfrutta la sicurezza della memoria del linguaggio Rust e il sandbox del browser moderno. Ciò consente l'esecuzione di vecchi contenuti potenzialmente rischiosi senza il pericolo di infezioni del sistema o perdite di dati.

L'emulatore combina il supporto sia per il più vecchio AVM1 (ActionScript 1 e 2, utilizzato fino al 2006) che per il più complesso AVM2 (ActionScript 3). Questo è necessario per il corretto funzionamento di praticamente qualsiasi contenuto Flash, dalle animazioni dei primi anni 2000 a giochi e applicazioni complessi rilasciati poco prima che la tecnologia fosse dismessa.

Link per il download:

Windows (64-bit) macOS Linux (x86_64) Linux (ARM64) Flatpak

Tutti i link portano a fonti ufficiali: le build per Windows (x86_64), macOS (universale per Intel e Apple Silicon), Linux (x86_64 e ARM64 per Raspberry Pi e dispositivi ARM) sono distribuite tramite il repository GitHub del progetto Ruffle, mentre la versione Linux in formato Flatpak è disponibile tramite il catalogo ufficiale Flathub con firme digitali e isolamento dell'applicazione.

Indice:

Caratteristiche principali di Ruffle

Integrazione tramite WebAssembly. Per il funzionamento nel browser, Ruffle viene compilato in WebAssembly (Wasm), un bytecode di basso livello eseguito all'interno del sandbox isolato del browser con prestazioni vicine a quelle native. Ciò consente all'emulatore di caricare ed elaborare grafica e logica Flash complesse senza la necessità di installare plugin NPAPI/PPAPI obsoleti e insicuri.

Rilevamento automatico e polyfill dei contenuti Flash. La versione web di Ruffle include un rilevatore JavaScript che analizza la struttura DOM della pagina alla ricerca di elementi object, embed e applet, nonché di file con estensione .swf. Una volta rilevato tale contenuto, Ruffle lo sostituisce automaticamente con il proprio player, riparando trasparentemente la pagina per l'utente e ripristinando la funzionalità degli elementi Flash.

Doppia modalità operativa (applicazione desktop ed estensione web). Ruffle offre flessibilità agli utenti: può essere utilizzato come applicazione desktop standalone per la riproduzione locale di SWF (basta associare i file all'eseguibile Ruffle) o come estensione del browser che si integra nell'ambiente di navigazione web, fornendo supporto Flash su qualsiasi sito.

Supporto per ActionScript 1.0 e 2.0 (AVM1). Ruffle implementa la macchina virtuale AVM1, garantendo la compatibilità con una vasta quantità di contenuti creati prima del 2006 e fino al 2013. L'attuale livello di compatibilità per i costrutti del linguaggio AVM1 raggiunge il 99%, e per le API l'81%, assicurando il corretto funzionamento della stragrande maggioranza dei primi giochi e animazioni Flash.

Supporto per ActionScript 3.0 (AVM2). Per i contenuti creati dopo il 2006, Ruffle include un'implementazione di AVM2. Sebbene il lavoro sulla compatibilità sia attivamente in corso, l'emulatore fornisce già un livello di supporto sufficiente per eseguire molti giochi e applicazioni complessi scritti in ActionScript 3, ampliando costantemente la copertura delle API e le capacità del linguaggio.

Sicurezza a livello del linguaggio Rust. Uno dei principali vantaggi architetturali di Ruffle è l'uso del linguaggio Rust. Rust garantisce la sicurezza della memoria in fase di compilazione, eliminando completamente intere classi di vulnerabilità che affliggevano il lettore Adobe Flash Player originale, come buffer overflow, double free ed errori use-after-free.

Isolamento all'interno del sandbox del browser. Quando opera in ambiente web, Ruffle (tramite WebAssembly) rispetta pienamente la politica di sicurezza del browser. Questo aggiunge un ulteriore livello di isolamento: l'emulatore non ha accesso diretto al file system dell'utente o ad altri processi di sistema, rendendo il suo sfruttamento estremamente difficile rispetto al classico plugin Flash.

Gestione efficiente della memoria. A differenza del lettore Flash originale, che utilizzava la garbage collection con pause non deterministiche, Ruffle eredita il rigoroso modello di proprietà di Rust. Ciò consente un utilizzo della memoria più prevedibile, riducendo la frammentazione ed eliminando le perdite di memoria che spesso portavano a un comportamento instabile del browser.

Supporto per la riga di comando. La versione desktop di Ruffle offre un'interfaccia a riga di comando completamente funzionale. Gli utenti possono eseguire l'emulatore con parametri, ad esempio: ruffle filename.swf per un file locale, o ruffle https://example.com/filename.swf per riprodurre uno SWF da un URL. Il comando ruffle --help mostra un elenco completo di tutti gli argomenti e le impostazioni disponibili.

Codice open source e trasparenza dello sviluppo. Ruffle è distribuito sotto le licenze Apache 2.0 e MIT. La completa apertura del codice sorgente significa che qualsiasi sviluppatore può controllare la sicurezza dell'emulatore, contribuire con correzioni e partecipare al suo sviluppo, eliminando la possibilità di funzionalità nascoste o vulnerabilità che potrebbero essere introdotte da sviluppatori aziendali.

Compatibilità con un'ampia gamma di browser. Grazie alla tecnologia WebAssembly, Ruffle è supportato da tutti i browser moderni, tra cui Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave e Vivaldi. Ciò garantisce un'esperienza coerente con i contenuti Flash indipendentemente dalle preferenze dell'utente per i motori di rendering (Chromium, Gecko o WebKit).

Supporto per browser mobili (iOS e Android). A differenza del lettore Adobe Flash Player originale, che non è mai stato ufficialmente supportato su iOS e aveva un supporto limitato su Android, Ruffle funziona sulle piattaforme mobili. Ciò consente l'esecuzione di giochi e animazioni Flash su smartphone e tablet direttamente tramite il browser mobile, aprendo l'accesso ai contenuti d'archivio per il pubblico mobile.

Nessuna configurazione richiesta. Ruffle è progettato secondo il principio "installa e dimentica". Dopo l'installazione dell'estensione o l'avvio dell'applicazione desktop, l'emulatore non richiede configurazioni complesse. Rileva automaticamente i parametri di riproduzione come le dimensioni dello stage, il frame rate e il tipo di interazione, applicando le impostazioni ottimali senza intervento dell'utente.

Protezione contro le vulnerabilità zero-day. Poiché Ruffle non è un plugin, non utilizza API obsolete e il suo codice è scritto in Rust con attenzione alla sicurezza, è immune agli attacchi che erano caratteristici di Adobe Flash Player. Questo lo rende una soluzione ideale per le organizzazioni che devono mantenere l'accesso a contenuti legacy ma non possono rischiare il compromissione del sistema.

Compatibilità con vari metodi di installazione. Ruffle offre diversi metodi di implementazione. Gli sviluppatori web possono installarlo come estensione statica nei browser basati su Chromium (tramite modalità sviluppatore) o come componente aggiuntivo temporaneo in Firefox (tramite about:debugging). È disponibile anche l'integrazione tramite semplice inserimento di codice JavaScript lato server.

Riproduzione di contenuti sia online che offline. La versione desktop di Ruffle consente di aprire e riprodurre file SWF salvati localmente sul computer. Questo rende l'emulatore uno strumento indispensabile per collezionisti, archivisti e ricercatori che lavorano con archivi locali di giochi e animazioni Flash.

Elevate prestazioni di rendering. Ruffle utilizza API grafiche moderne (come OpenGL, Vulkan, DirectX o WebGL) tramite librerie cross-platform. Ciò fornisce l'accelerazione hardware per il rendering di grafica vettoriale e raster, consentendo una riproduzione fluida anche su dispositivi più deboli dove il lettore Flash originale poteva subire rallentamenti.

Sviluppo attivo e aggiornamenti frequenti. Il progetto è in fase di sviluppo attivo. Le release escono regolarmente e includono sia correzioni critiche di bug che un supporto ampliato per le API ActionScript. Ad esempio, le versioni recenti hanno corretto casi limite nei metodi String.indexOf e lastIndexOf, e gestito correttamente gli indici negativi in Array.indexOf.

Integrazione con i principali archivi e piattaforme. Ruffle è stato scelto come player ufficiale per la riproduzione di contenuti Flash da giganti come Internet Archive, Newgrounds, Coolmath Games e Armor Games. Ciò conferma l'alto grado di affidabilità e compatibilità dell'emulatore, nonché la sua capacità di operare sotto carichi elevati in condizioni reali.

Supporto per salvataggi e stato dei giochi. Come il lettore Flash originale, Ruffle supporta gli oggetti condivisi locali (LSO), che molti giochi utilizzano per salvare i progressi. L'emulatore emula correttamente i meccanismi di lettura e scrittura dei dati in questo archivio, garantendo l'integrità del salvataggio durante l'esecuzione dell'applicazione.

Emulazione accurata dei tempi e del frame rate. Ruffle emula accuratamente il timer interno del Flash Player, fondamentale per la logica di giochi e animazioni. Ciò garantisce una corretta sincronizzazione di eventi, suoni e movimento degli oggetti, evitando situazioni in cui un gioco viene eseguito più lentamente o più velocemente dell'originale.

Supporto per l'interazione DOM e JavaScript (ExternalInterface). Per le applicazioni web complesse che utilizzavano l'API ExternalInterface per scambiare dati tra ActionScript e JavaScript, Ruffle implementa un ponte compatibile. Ciò consente all'emulatore di gestire correttamente le chiamate di funzione e il trasferimento dei dati, preservando l'interattività del contenuto con la pagina web circostante.

Ridimensionamento automatico e adattamento della risoluzione. Quando riproduce contenuti Flash creati per una risoluzione specifica (es. 800x600), Ruffle applica automaticamente algoritmi di ridimensionamento per adattarsi alle dimensioni correnti della finestra del browser o dell'applicazione desktop. Preserva le proporzioni e la qualità dell'immagine e gestisce correttamente le aree di interazione del mouse.

Supporto per diversi formati multimediali. L'emulatore supporta la decodifica di vari formati multimediali che potrebbero essere incorporati nei file SWF, inclusi MP3 per l'audio e la compressione video utilizzata nelle versioni successive di Flash. La decodifica viene eseguita tramite librerie ad alte prestazioni scritte in Rust, riducendo il carico sul sistema.

Debugging e logging avanzati. Per sviluppatori e utenti esperti, Ruffle fornisce la possibilità di abilitare log dettagliati delle operazioni delle macchine virtuali AVM1/AVM2. Ciò consente di diagnosticare problemi di compatibilità, tracciare errori nel codice ActionScript e comprendere i processi interni dell'emulazione per una messa a punto più precisa.

Emulazione del cursore e degli elementi interattivi. Ruffle gestisce correttamente le modifiche dello stile del cursore specificate dai contenuti Flash. Ad esempio, per elementi interattivi come LoaderDisplay, l'emulatore cambia automaticamente il cursore standard in un puntatore, imitando il comportamento del lettore Flash originale e fornendo una navigazione familiare all'utente.

Supporto per le build notturne per l'accesso anticipato. Oltre alle versioni stabili, il team di Ruffle fornisce l'accesso a build sperimentali giornaliere (Nightly). Queste build contengono le ultime correzioni e innovazioni non ancora incluse nella versione stabile.

Preservazione del patrimonio culturale digitale. Questa non è solo una funzione tecnica, ma un obiettivo fondamentale del progetto. Ruffle è stato creato come strumento per preservare i contenuti storici di Internet. Grazie alla sua capacità di funzionare nei browser moderni senza compromettere la sicurezza, milioni di giochi, animazioni e applicazioni Flash che sarebbero andati irrimediabilmente persi dopo la dismissione di Adobe Flash Player rimangono accessibili per le generazioni future.

12 Capacità tecniche meno note di Ruffle

  1. Utilizzo di WGPU come backend di rendering principale. A differenza di molti emulatori che si basano su OpenGL legacy, Ruffle utilizza la libreria WGPU, un'API grafica moderna, sicura e cross-platform. Su desktop, WGPU seleziona automaticamente il backend di basso livello più ottimale: Vulkan, DirectX 12 o Metal. Nel browser, può funzionare tramite WebGPU (dove disponibile) o emulare il funzionamento tramite WebGL con una perdita di prestazioni minima.

  2. Supporto WebGPU nel browser per massime prestazioni. Per gli utenti di browser moderni (es. le ultime versioni di Chrome e Edge), Ruffle può utilizzare l'API all'avanguardia WebGPU. Ciò riduce significativamente i tempi di compilazione degli shader e l'overhead rispetto al backend WebGL standard, il che è fondamentale per la grafica 3D complessa e le applicazioni Stage3D.

  3. Ottimizzazione fine del backend di rendering (canvas, webgl, wgpu-webgl). Pochi sanno che il comportamento di rendering può essere controllato manualmente. Oltre allo standard wgpu-webgl, è possibile forzare l'abilitazione di:

    • webgl — un backend classico che si inizializza più rapidamente e può essere utile per contenuti semplici che non richiedono effetti bitmap complessi.

    • canvas — il backend più lento, ma il più accurato. È l'unico che ridimensiona correttamente i tratti sottili nella grafica vettoriale, che potrebbero apparire troppo spessi quando si utilizza l'accelerazione hardware.

  4. Emulazione di Stage3D e compilazione di AGAL in WGSL. Ruffle supporta non solo la grafica 2D ma anche l'accelerazione 3D tramite l'API Stage3D (Context3D). Gli shader scritti in AGAL (Adobe Graphics Assembly Language) vengono compilati "al volo" in moderni WGSL (WebGPU Shading Language) o GLSL. Ciò consente di eseguire complessi giochi e applicazioni 3D creati per Flash Player 11 e versioni successive, utilizzando un intero pipeline di shader programmabili.

  5. Supporto per fscommand per la retrocompatibilità. Ruffle ha mantenuto il supporto per il meccanismo legacy ma importante fscommand. Ciò consente ai vecchi filmati Flash (creati prima di ExternalInterface) di interagire con JavaScript sulla pagina, inviando comandi e argomenti arbitrari. Nell'implementazione moderna di Ruffle, questi comandi vengono elaborati tramite onFSCommand, abilitando la funzionalità anche per contenuti web molto vecchi.

  6. Doppio buffering per Context3D. Quando lavora con contenuti 3D, Ruffle utilizza un sofisticato meccanismo di doppio buffering (back buffer / front buffer). Questa è una tecnica standard ma estremamente importante per le prestazioni, che consente di eseguire il rendering del fotogramma successivo nel buffer di sfondo mentre quello corrente viene visualizzato sullo schermo, eliminando gli artefatti visivi (tearing del fotogramma) nei giochi dinamici.

  7. Strumenti di benchmarking: ruffle_scanner e exporter. All'interno del repository di Ruffle, ci sono strumenti utility non inclusi nella build standard ma disponibili per gli sviluppatori:

    • ruffle_scanner — consente di testare la compatibilità dell'emulatore con un'intera cartella di file SWF, generando un report CSV sul successo dell'analisi.

    • exporter — uno strumento per generare in batch screenshot PNG da file SWF, che può funzionare in modalità headless (senza interfaccia grafica), utile per test automatizzati e creazione di anteprime.

  8. Isolamento completo tramite sandbox Flatpak. Per gli utenti Linux, è disponibile una build ufficiale di Ruffle in formato Flatpak. Non è solo un metodo di installazione, ma un ulteriore livello di sicurezza: l'applicazione viene eseguita in un ambiente isolato in cui tutti i salvataggi, le configurazioni e i log sono archiviati rigorosamente all'interno della directory home di Flatpak (~/.var/app/rs.ruffle.Ruffle/), senza accesso al resto del sistema.

  9. Supporto per l'integrazione tramite Homebrew e Scoop. Per gli utenti esperti, Ruffle offre metodi di installazione avanzati oltre al download manuale. Su macOS, può essere installato tramite Homebrew (brew install --HEAD ruffle-rs/ruffle/ruffle), consentendo aggiornamenti automatici all'ultima build notturna. Su Windows, il gestore di pacchetti Scoop svolge una funzione simile.

  10. Sistema di archiviazione dati trasparente (SharedObjects). Ruffle emula accuratamente il sistema di archiviazione locale di Flash (LSO — Local Shared Objects). Tuttavia, a differenza del player proprietario, la posizione di questi file è standardizzata e trasparente per l'utente. Su Windows, si trovano in %AppData%\Local\Ruffle\SharedObjects\, su Linux in ~/.local/share/ruffle/SharedObjects/. Ciò consente il backup manuale dei salvataggi dei vecchi giochi.

  11. Configurazione tramite API JavaScript e impostazioni globali. Per gli sviluppatori web, Ruffle fornisce una potente API JavaScript, che consente non solo di incorporare il player ma anche di controllarne lo stato. Sono disponibili metodi per caricare SWF a livello di codice (load), controllare il volume (volume), mettere in pausa (suspend/resume) e intercettare gli output trace() da ActionScript per il debug tramite traceObserver.

  12. Firma automatica e notarizzazione delle build macOS. Nel processo CI/CD, tutte le build notturne di Ruffle per macOS vengono sottoposte a firma del codice e notarizzazione da parte di Apple. Ciò significa che anche le versioni instabili dell'emulatore non verranno bloccate da Gatekeeper come software non sicuro, garantendo un funzionamento senza problemi sulle ultime versioni di macOS dove i requisiti di sicurezza sono rigorosi.

Installazione della versione desktop di Ruffle

La versione desktop di Ruffle è un'applicazione nativa che consente di aprire e riprodurre file SWF direttamente sul computer, senza bisogno di un browser. Questa è una scelta ideale per visualizzare archivi locali di giochi e animazioni Flash.

Windows (10, 11)

Metodo 1: Interfaccia grafica (consigliato)

  1. Scaricare il file denominato ruffle-windows-x86_64.zip (per sistemi a 64 bit) o ruffle-windows-x86.zip (per sistemi a 32 bit).

  2. Estrarre il contenuto dell'archivio in qualsiasi cartella comoda (ad es., C:\Program Files\Ruffle o C:\Users\[Nome_Utente]\Documents\Ruffle).

  3. Per eseguirlo, fare doppio clic sul file eseguibile ruffle.exe. Si aprirà l'interfaccia grafica dell'applicazione.

  4. Per aprire un file SWF, fare clic sul pulsante Apri file nell'interfaccia o semplicemente trascinare e rilasciare il file SWF nella finestra dell'applicazione.

  5. Metodo alternativo: Impostare l'associazione dei file. Fare clic con il tasto destro su qualsiasi file .swf, selezionare Apri con → Scegli un'altra app, individuare ruffle.exe e spuntare l'opzione Usa sempre questa app per aprire i file .swf.

Metodo 2: Riga di comando

Per gli utenti esperti, è disponibile un'interfaccia a riga di comando:

  1. Aprire il Prompt dei comandi (CMD) o PowerShell.

  2. Navigare nella cartella contenente ruffle.exe o aggiungere quella cartella alla variabile d'ambiente PATH.

  3. Per eseguire un file locale, eseguire il comando:

    ruffle.exe C:\percorso\del\tuo\file.swf

  4. Per eseguire un file SWF da un URL:

    ruffle.exe https://example.com/animazione.swf

  5. Per visualizzare tutti i parametri della riga di comando disponibili:

    ruffle.exe --help

Metodo 3: Installazione tramite il gestore di pacchetti Scoop

Per chi preferisce l'installazione automatizzata:

scoop bucket add extras
scoop install ruffle

macOS

Metodo 1: Interfaccia grafica (consigliato)

  1. Scaricare il file ruffle-macos-x86_64.dmg o ruffle-macos-aarch64.dmg (per Apple Silicon M1/M2/M3) dalla pagina delle release.

  2. Aprire il file .dmg scaricato.

  3. Trascinare l'icona Ruffle nella cartella Applicazioni.

  4. Avviare Ruffle dalla cartella Applicazioni. Al primo avvio, il sistema potrebbe chiedere una conferma: fare clic su Apri.

  5. Dopo l'avvio dell'applicazione, utilizzare il pulsante Apri file o trascinare e rilasciare un file SWF nella finestra.

Metodo 2: Installazione tramite Homebrew

Per utenti avanzati:

# Installa l'ultima versione stabile (se disponibile)
brew install ruffle

# Oppure installa l'ultima build notturna dal sorgente
brew install --HEAD ruffle-rs/ruffle/ruffle

Metodo 3: Riga di comando

Dopo l'installazione tramite Homebrew o il posizionamento manuale di ruffle in /usr/local/bin:

ruffle ~/Downloads/gioco.swf
ruffle https://example.com/gioco.swf

Linux

Metodo 1: Installazione tramite Flatpak (consigliato per l'isolamento)

Flatpak fornisce la massima sicurezza eseguendo Ruffle in un sandbox isolato:

# Aggiungi il repository Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Installa Ruffle
flatpak install flathub rs.ruffle.Ruffle

# Esegui
flatpak run rs.ruffle.Ruffle

Metodo 2: Installazione tramite AppImage (nessuna installazione richiesta)

  1. Scaricare il file ruffle-x86_64.AppImage dalla pagina delle release.

  2. Rendere il file eseguibile:

    chmod +x ruffle-x86_64.AppImage

  3. Eseguirlo facendo doppio clic o tramite terminale:

    ./ruffle-x86_64.AppImage

Metodo 3: Installazione manuale (per distribuzioni basate su Debian/Ubuntu)

  1. Scaricare ruffle-linux-x86_64.tar.gz (o ruffle-linux-armv7.tar.gz per dispositivi ARM come Raspberry Pi).

  2. Estrarre l'archivio:

    tar -xzf ruffle-linux-x86_64.tar.gz

  3. Copiare il file eseguibile in una directory di sistema:

    sudo cp ruffle /usr/local/bin/

  4. Eseguire dal terminale:

    ruffle

Installazione di Ruffle come estensione del browser

L'estensione Ruffle rileva automaticamente i contenuti Flash su qualsiasi pagina web e li sostituisce con l'emulatore.

Nota importante

Attualmente, l'estensione non è ospitata negli store ufficiali delle estensioni (Chrome Web Store, Componenti aggiuntivi di Firefox) ed è in fase di sviluppo attivo. L'installazione viene eseguita manualmente, tramite la modalità sviluppatore del browser.

Installazione in Google Chrome e browser basati su Chromium

Browser supportati: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc e altri basati su Chromium.

Istruzioni passo-passo:

  1. Andare alla pagina delle release di Ruffle su GitHub.

  2. Scaricare l'archivio denominato ruffle-chromium.zip (o simile contenente chromium).

  3. Estrarre l'archivio in una cartella permanente sul computer. Importante: Non eliminare questa cartella dopo l'installazione, poiché il browser vi accederà per il funzionamento dell'estensione. Posizioni consigliate:

    • Windows: C:\Users\[Nome_Utente]\AppData\Local\Ruffle\

    • macOS: ~/Library/Application Support/Ruffle/

    • Linux: ~/.local/share/ruffle/

  4. Aprire il browser e inserire il seguente indirizzo nella barra degli indirizzi:

    chrome://extensions/

  5. Nell'angolo in alto a destra della pagina, abilitare la Modalità sviluppatore.

  6. Fare clic sul pulsante Carica estensione non impacchettata.

  7. Nella finestra di dialogo che si apre, selezionare la cartella in cui è stato estratto l'archivio ruffle-chromium.zip e fare clic su Seleziona cartella.

  8. L'estensione è installata. Ora, visitando siti con contenuti Flash, Ruffle si attiverà automaticamente.

Per Microsoft Edge (Chromium): Il processo è identico a Chrome. Utilizzare edge://extensions/ invece di chrome://extensions/ e abilitare la modalità sviluppatore.

Installazione in Mozilla Firefox

Importante: In Firefox, l'estensione si installa solo temporaneamente e verrà rimossa dopo il riavvio del browser. Questa è una limitazione di Firefox per le estensioni non firmate. Per un uso permanente, si consiglia di utilizzare la versione desktop o attendere la pubblicazione nello store ufficiale.

Istruzioni passo-passo:

  1. Andare alla pagina delle release di Ruffle su GitHub.

  2. Scaricare il file denominato ruffle-firefox.xpi. Durante il download, scegliere Salva file.

  3. In Firefox, inserire il seguente indirizzo nella barra degli indirizzi:

    about:debugging

  4. Nella barra laterale sinistra, selezionare Questo Firefox.

  5. Fare clic sul pulsante Carica componente aggiuntivo temporaneo….

  6. Nella finestra di dialogo dei file, selezionare il file ruffle-firefox.xpi scaricato e fare clic su Apri.

  7. L'estensione verrà caricata e attivata. Funzionerà fino alla chiusura del browser.

Suggerimento: Se si utilizza Firefox Nightly o Developer Edition, è possibile disabilitare la verifica della firma delle estensioni tramite about:config, il che consente l'installazione permanente, ma per motivi di sicurezza non è consigliato per l'uso quotidiano.

Installazione in Safari (macOS)

L'installazione dell'estensione Ruffle in Safari richiede passaggi aggiuntivi a causa della politica di sicurezza di Apple.

  1. Scaricare il file ruffle-safari.zip dalla pagina delle release.

  2. Estrarre l'archivio.

  3. Eseguire il file Ruffle.app dalla cartella estratta. Questo installerà l'estensione sul sistema.

  4. Aprire Safari, andare su Safari → Impostazioni → scheda Estensioni.

  5. Assicurarsi che l'interruttore accanto a Ruffle sia impostato su Attivo.

  6. L'estensione è attivata e funzionerà con i contenuti Flash sulle pagine web.

Installazione di Ruffle su un sito web (per webmaster)

Se si possiede un sito web che ospita contenuti Flash, è possibile integrare Ruffle direttamente nel codice della pagina. Ciò consentirà ai visitatori del sito di riprodurre automaticamente i contenuti Flash senza installare estensioni.

Il metodo più semplice: Utilizzo del player JavaScript

  1. Scaricare il file ruffle.js e la cartella delle risorse ruffle dalla pagina delle release.

  2. Caricare questi file sul proprio server (ad es., in una cartella come /js/ruffle/).

  3. Aggiungere il seguente codice nella sezione <head> di ogni pagina in cui è presente contenuto Flash:

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Impostazioni del player
        autoplay: "auto", // "on", "off" o "auto"
        splashScreen: false, // Disabilita la schermata iniziale
    };
</script>

  1. Ruffle rileverà automaticamente tutti gli elementi object, embed e applet sulla pagina e li sostituirà con il suo player.

Configurazione avanzata tramite CDN (senza scaricare file)

Per test rapidi, è possibile utilizzare una CDN:

<script src="https://unpkg.com/@ruffle-rs/ruffle"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        autoplay: "on",
    };
</script>

Inizializzazione manuale per contenuti caricati dinamicamente:

Se i file SWF vengono aggiunti alla pagina dinamicamente (tramite JavaScript), è possibile inizializzare manualmente il player:

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("percorso/del/tuo/file.swf");
document.body.appendChild(player);

Verifica del funzionamento

Dopo aver installato Ruffle con qualsiasi metodo, è possibile verificarne il funzionamento:

  1. Versione desktop: Aprire semplicemente qualsiasi file SWF.

  2. Estensione del browser: Visitare la collezione di giochi Flash di Internet Archive o qualsiasi sito con contenuti Flash noti. Se l'elemento Flash viene visualizzato e riprodotto, Ruffle funziona correttamente.

  3. Diagnostica: Nel browser, premere F12 per aprire gli strumenti di sviluppo. Nella console, verranno visualizzati messaggi da Ruffle che ne confermano l'attivazione.

Risoluzione dei problemi comuni

Problema Possibile soluzione
L'estensione non si attiva su un sito Assicurarsi che il sito non sia bloccato nelle impostazioni dell'estensione. Verificare che la modalità sviluppatore sia abilitata in chrome://extensions/.
Il file SWF non viene riprodotto o mostra una schermata bianca La versione corrente di Ruffle potrebbe non supportare questo specifico file SWF. Verificare se il contenuto è AVM2 (ActionScript 3), il cui supporto è ancora in fase di perfezionamento.
Impossibile aprire il file nella versione desktop Assicurarsi che il file non sia danneggiato. Provare ad aprirlo dalla riga di comando con il flag --verbose per ottenere log di errore dettagliati.
L'estensione è scomparsa dopo il riavvio di Firefox Questo è un comportamento normale per le estensioni temporanee. Utilizzare la versione desktop o attendere la pubblicazione ufficiale nello store dei componenti aggiuntivi.
Scarse prestazioni nel browser Provare a cambiare il backend di rendering nelle impostazioni dell'estensione. Per i browser Chromium, verificare anche che l'accelerazione hardware sia abilitata nelle impostazioni del browser.