Ruffle - Adobe Flash Player Emulator

Ruffle ist ein Adobe Flash Player Emulator, der für die Ausführung von Legacy-Flash-Inhalten (Spiele, Animationen, Anwendungen und SWF-Banner) unerlässlich ist. Er funktioniert als eigenständige Anwendung auf allen Betriebssystemen (einschließlich Windows, macOS und Linux) und integriert sich über WebAssembly in Browser.

Ruffle bietet separate Builds für Windows, macOS und Linux, die wie normale Programme funktionieren: Führen Sie einfach die ausführbare Datei aus und öffnen Sie die gewünschte SWF-Datei darin.

Ruffle nutzt die Speichersicherheit der Sprache Rust und die Sandbox des modernen Browsers. Dies ermöglicht die Ausführung potenziell riskanter alter Inhalte ohne das Risiko einer Systeminfektion oder Datenleckage.

Der Emulator kombiniert Unterstützung sowohl für die ältere AVM1 (ActionScript 1 und 2, verwendet bis 2006) als auch für die komplexere AVM2 (ActionScript 3). Dies ist für den korrekten Betrieb praktisch aller Flash-Inhalte notwendig, von Animationen der frühen 2000er Jahre bis hin zu komplexen Spielen und Anwendungen, die kurz vor der Einstellung der Technologie veröffentlicht wurden.

Download-Links:

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

Alle Links führen zu offiziellen Quellen: Builds für Windows (x86_64), macOS (universal für Intel und Apple Silicon), Linux (x86_64 und ARM64 für Raspberry Pi und ARM-Geräte) werden über das GitHub-Repository des Ruffle-Projekts vertrieben, während die Linux-Version im Flatpak-Format über den offiziellen Flathub-Katalog mit digitalen Signaturen und Anwendungsisolierung verfügbar ist.

Inhaltsverzeichnis:

Hauptfunktionen von Ruffle

Integration über WebAssembly. Für den Betrieb im Browser wird Ruffle in WebAssembly (Wasm) kompiliert – einen Low-Level-Bytecode, der innerhalb der isolierten Sandbox des Browsers mit nahezu nativer Leistung ausgeführt wird. Dies ermöglicht es dem Emulator, komplexe Flash-Grafiken und -Logik zu laden und zu verarbeiten, ohne dass veraltete und unsichere NPAPI/PPAPI-Plugins installiert werden müssen.

Automatische Erkennung und Polyfilling von Flash-Inhalten. Die Webversion von Ruffle enthält einen JavaScript-Detektor, der die DOM-Struktur der Seite nach object-, embed- und applet-Elementen sowie nach Dateien mit der Endung .swf durchsucht. Bei Erkennung solcher Inhalte ersetzt Ruffle diese automatisch durch seinen eigenen Player, repariert die Seite transparent für den Benutzer und stellt die Funktionalität der Flash-Elemente wieder her.

Zweifacher Betriebsmodus (Desktop-Anwendung und Weberweiterung). Ruffle bietet den Benutzern Flexibilität: Es kann als eigenständige Desktop-Anwendung für die lokale SWF-Wiedergabe verwendet werden (einfach Dateien mit der Ruffle-ausführbaren Datei verknüpfen) oder als Browser-Erweiterung, die sich in die Webbrowser-Umgebung integriert und Flash-Unterstützung auf jeder Website bietet.

Unterstützung für ActionScript 1.0 und 2.0 (AVM1). Ruffle implementiert die AVM1-Virtualmaschine und gewährleistet so die Kompatibilität mit einer großen Menge an Inhalten, die vor 2006 und bis 2013 erstellt wurden. Der aktuelle Kompatibilitätsgrad für AVM1-Sprachkonstrukte erreicht 99% und für APIs 81%, was den korrekten Betrieb der überwältigenden Mehrheit früher Flash-Spiele und -Animationen garantiert.

Unterstützung für ActionScript 3.0 (AVM2). Für Inhalte, die nach 2006 erstellt wurden, enthält Ruffle eine Implementierung von AVM2. Obwohl die Arbeit an der Kompatibilität aktiv weitergeht, bietet der Emulator bereits ein ausreichendes Maß an Unterstützung, um viele komplexe Spiele und Anwendungen auszuführen, die in ActionScript 3 geschrieben wurden, und erweitert ständig die API-Abdeckung und Sprachfähigkeiten.

Sicherheit auf der Ebene der Sprache Rust. Einer der wichtigsten architektonischen Vorteile von Ruffle ist die Verwendung der Sprache Rust. Rust garantiert Speichersicherheit zur Kompilierzeit und eliminiert vollständig ganze Klassen von Schwachstellen, die den ursprünglichen Adobe Flash Player plagten, wie Pufferüberläufe, doppelte Freigaben und Use-after-free-Fehler.

Isolierung innerhalb der Browser-Sandbox. Bei der Ausführung in einer Webumgebung entspricht Ruffle (über WebAssembly) vollständig der Sicherheitsrichtlinie des Browsers. Dies fügt eine zusätzliche Isolierungsebene hinzu: Der Emulator hat keinen direkten Zugriff auf das Dateisystem des Benutzers oder andere Systemprozesse, was seine Ausnutzung im Vergleich zum klassischen Flash-Plugin extrem erschwert.

Effizientes Speichermanagement. Im Gegensatz zum ursprünglichen Flash Player, der die Speicherbereinigung mit nichtdeterministischen Pausen verwendete, erbt Ruffle das strenge Besitzmodell von Rust. Dies ermöglicht eine vorhersagbarere Speichernutzung, reduziert Fragmentierung und eliminiert Speicherlecks, die oft zu instabilem Browserverhalten führten.

Kommandozeilenunterstützung. Die Desktop-Version von Ruffle bietet eine voll funktionsfähige Kommandozeilenschnittstelle. Benutzer können den Emulator mit Parametern ausführen, zum Beispiel: ruffle dateiname.swf für eine lokale Datei oder ruffle https://example.com/dateiname.swf um eine SWF von einer URL abzuspielen. Der Befehl ruffle --help zeigt eine umfassende Liste aller verfügbaren Argumente und Einstellungen an.

Open-Source-Code und Entwicklungstransparenz. Ruffle wird unter den Lizenzen Apache 2.0 und MIT vertrieben. Die vollständige Offenheit des Quellcodes bedeutet, dass jeder Entwickler die Sicherheit des Emulators überprüfen, Korrekturen beitragen und an seiner Entwicklung teilnehmen kann, wodurch die Möglichkeit versteckter Funktionen oder Schwachstellen, die von Unternehmensentwicklern eingeführt werden könnten, ausgeschlossen wird.

Kompatibilität mit einer Vielzahl von Browsern. Dank der WebAssembly-Technologie wird Ruffle von allen modernen Browsern unterstützt, einschließlich Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave und Vivaldi. Dies gewährleistet ein konsistentes Erlebnis mit Flash-Inhalten, unabhängig von den Präferenzen der Benutzer für Browser-Engines (Chromium, Gecko oder WebKit).

Unterstützung für mobile Browser (iOS und Android). Im Gegensatz zum ursprünglichen Adobe Flash Player, der auf iOS nie offiziell unterstützt wurde und auf Android nur eingeschränkte Unterstützung hatte, funktioniert Ruffle auf mobilen Plattformen. Dies ermöglicht es, Flash-Spiele und -Animationen auf Smartphones und Tablets direkt über den mobilen Browser auszuführen und so archivierte Inhalte für ein mobiles Publikum zugänglich zu machen.

Keine Konfiguration erforderlich. Ruffle ist nach dem Prinzip "Einrichten und vergessen" konzipiert. Nach der Installation der Erweiterung oder dem Start der Desktop-Anwendung erfordert der Emulator keine komplexe Konfiguration. Er erkennt automatisch Wiedergabeparameter wie Bühnengröße, Bildrate und Interaktionsart und wendet optimale Einstellungen ohne Benutzereingriff an.

Schutz vor Zero-Day-Schwachstellen. Da Ruffle kein Plugin ist, keine veralteten APIs verwendet und sein Code in Rust mit Fokus auf Sicherheit geschrieben ist, ist es immun gegen Angriffe, die für Adobe Flash Player charakteristisch waren. Dies macht es zu einer idealen Lösung für Organisationen, die den Zugriff auf Legacy-Inhalte aufrechterhalten müssen, aber das Risiko einer Systemkompromittierung nicht eingehen können.

Kompatibilität mit verschiedenen Installationsmethoden. Ruffle bietet mehrere Bereitstellungsmethoden. Webentwickler können es als statische Erweiterung in Chromium-basierten Browsern (über den Entwicklermodus) oder als temporäres Add-on in Firefox (über about:debugging) installieren. Auch die Integration durch einfaches Einfügen von JavaScript-Code auf der Serverseite ist verfügbar.

Wiedergabe von Online- und Offline-Inhalten. Die Desktop-Version von Ruffle ermöglicht das Öffnen und Abspielen von lokal auf dem Computer gespeicherten SWF-Dateien. Dies macht den Emulator zu einem unverzichtbaren Werkzeug für Sammler, Archivare und Forscher, die mit lokalen Archiven von Flash-Spielen und -Animationen arbeiten.

Hohe Rendering-Leistung. Ruffle verwendet moderne Grafik-APIs (wie OpenGL, Vulkan, DirectX oder WebGL) über plattformübergreifende Bibliotheken. Dies ermöglicht Hardware-Beschleunigung für das Rendern von Vektor- und Rastergrafiken und sorgt für eine flüssige Wiedergabe selbst auf schwächeren Geräten, auf denen der ursprüngliche Flash Player möglicherweise ruckelte.

Aktive Entwicklung und häufige Updates. Das Projekt befindet sich in aktiver Entwicklung. Veröffentlichungen erscheinen regelmäßig und enthalten sowohl kritische Fehlerbehebungen als auch erweiterte ActionScript-API-Unterstützung. Beispielsweise haben aktuelle Versionen Randfälle in String.indexOf- und lastIndexOf-Methoden behoben und negative Indizes in Array.indexOf korrekt behandelt.

Integration mit großen Archiven und Plattformen. Ruffle wurde als offizieller Player für die Wiedergabe von Flash-Inhalten von Giganten wie dem Internet Archive, Newgrounds, Coolmath Games und Armor Games ausgewählt. Dies bestätigt den hohen Grad an Zuverlässigkeit und Kompatibilität des Emulators sowie seine Fähigkeit, unter hohen Lasten unter realen Bedingungen zu funktionieren.

Unterstützung für Spielstände und Zustände. Wie der ursprüngliche Flash Player unterstützt Ruffle Local Shared Objects (LSO), die viele Spiele zum Speichern des Fortschritts verwenden. Der Emulator emuliert korrekt die Mechanismen zum Lesen und Schreiben von Daten in diesem Speicher und gewährleistet so die Integrität der Spielstände innerhalb der Laufzeitumgebung der Anwendung.

Genaue Emulation von Timings und Bildrate. Ruffle emuliert genau den internen Timer des Flash Players, was für die Spiel- und Animationslogik entscheidend ist. Dies gewährleistet eine ordnungsgemäße Synchronisation von Ereignissen, Ton und Objektbewegungen und verhindert Situationen, in denen ein Spiel langsamer oder schneller läuft als im Original.

Unterstützung für DOM- und JavaScript-Interaktion (ExternalInterface). Für komplexe Webanwendungen, die die ExternalInterface-API zum Datenaustausch zwischen ActionScript und JavaScript verwendeten, implementiert Ruffle eine kompatible Brücke. Dies ermöglicht es dem Emulator, Funktionsaufrufe und Datenübertragungen korrekt zu behandeln und so die Interaktivität von Inhalten mit der umgebenden Webseite zu bewahren.

Automatische Skalierung und Auflösungsanpassung. Bei der Wiedergabe von Flash-Inhalten, die für eine bestimmte Auflösung (z. B. 800x600) erstellt wurden, wendet Ruffle automatisch Skalierungsalgorithmen an, um sich an die aktuelle Fenstergröße des Browsers oder der Desktop-Anwendung anzupassen. Es erhält Proportionen und Bildqualität und behandelt Mausinteraktionsbereiche korrekt.

Unterstützung verschiedener Medienformate. Der Emulator unterstützt die Decodierung verschiedener Medienformate, die in SWF-Dateien eingebettet sein können, einschließlich MP3 für Audio- und Videokomprimierung, die in späteren Versionen von Flash verwendet wurde. Die Decodierung erfolgt über leistungsstarke, in Rust geschriebene Bibliotheken, was die Systembelastung reduziert.

Erweitertes Debugging und Logging. Für Entwickler und fortgeschrittene Benutzer bietet Ruffle die Möglichkeit, detaillierte Logs der AVM1/AVM2-Virtualmaschinenoperationen zu aktivieren. Dies ermöglicht die Diagnose von Kompatibilitätsproblemen, die Verfolgung von Fehlern im ActionScript-Code und das Verständnis der internen Prozesse der Emulation für eine präzisere Abstimmung.

Emulation von Cursor und interaktiven Elementen. Ruffle behandelt Änderungen des Cursor-Stils, die durch Flash-Inhalte vorgegeben werden, korrekt. Für interaktive Elemente wie LoaderDisplay ändert der Emulator automatisch den Standard-Cursor in einen Zeiger, ahmt das Verhalten des ursprünglichen Flash-Players nach und bietet dem Benutzer eine vertraute Navigation.

Unterstützung für Nightly-Builds für frühen Zugriff. Zusätzlich zu den stabilen Versionen stellt das Ruffle-Team tägliche experimentelle Nightly-Builds zur Verfügung. Diese Builds enthalten die neuesten Korrekturen und Innovationen, die noch nicht in der stabilen Version enthalten sind.

Bewahrung des digitalen kulturellen Erbes. Dies ist nicht nur eine technische Funktion, sondern ein grundlegendes Ziel des Projekts. Ruffle wurde als Werkzeug zur Bewahrung historischer Internetinhalte entwickelt. Dank seiner Fähigkeit, in modernen Browsern ohne Sicherheitskompromisse zu arbeiten, bleiben Millionen von Flash-Spielen, -Animationen und -Anwendungen, die nach der Einstellung von Adobe Flash Player dauerhaft verloren gewesen wären, für zukünftige Generationen zugänglich.

12 weniger bekannte technische Fähigkeiten von Ruffle

  1. Verwendung von WGPU als primäres Rendering-Backend. Im Gegensatz zu vielen Emulatoren, die auf Legacy-OpenGL angewiesen sind, verwendet Ruffle die Bibliothek WGPU – eine moderne, sichere und plattformübergreifende Grafik-API. Auf dem Desktop wählt WGPU automatisch das optimalste Low-Level-Backend aus: Vulkan, DirectX 12 oder Metal. Im Browser kann es über WebGPU (wo verfügbar) arbeiten oder den Betrieb über WebGL mit minimalem Leistungsverlust emulieren.

  2. WebGPU-Unterstützung im Browser für maximale Leistung. Für Benutzer moderner Browser (z. B. neueste Versionen von Chrome und Edge) kann Ruffle die hochmoderne WebGPU-API verwenden. Dies bietet eine erheblich reduzierte Shader-Kompilierungszeit und einen geringeren Overhead im Vergleich zum Standard-WebGL-Backend, was für komplexe 3D-Grafiken und Stage3D-Anwendungen entscheidend ist.

  3. Feinkörnige Anpassung des Rendering-Backends (canvas, webgl, wgpu-webgl). Wenige wissen, dass das Rendering-Verhalten manuell gesteuert werden kann. Neben dem Standard wgpu-webgl gibt es die Möglichkeit, Folgendes zu erzwingen:

    • webgl — ein klassisches Backend, das schneller initialisiert und für einfache Inhalte nützlich sein kann, die keine komplexen Biteffekte erfordern.

    • canvas — das langsamste, aber genaueste Backend. Es ist das einzige, das Haarlinienstriche in Vektorgrafiken korrekt skaliert, die bei Verwendung von Hardwarebeschleunigung zu dick erscheinen können.

  4. Emulation von Stage3D und Kompilierung von AGAL nach WGSL. Ruffle unterstützt nicht nur 2D-Grafiken, sondern auch 3D-Beschleunigung über die Stage3D- (Context3D) API. In AGAL (Adobe Graphics Assembly Language) geschriebene Shader werden "on the fly" in modernes WGSL (WebGPU Shading Language) oder GLSL kompiliert. Dies ermöglicht die Ausführung komplexer 3D-Spiele und -Anwendungen, die für Flash Player 11 und höher erstellt wurden, und nutzt eine vollständige Pipeline programmierbarer Shader.

  5. Unterstützung für fscommand für Abwärtskompatibilität. Ruffle hat die Unterstützung für den veralteten, aber wichtigen fscommand-Mechanismus beibehalten. Dies ermöglicht es alten Flash-Filmen (die vor ExternalInterface erstellt wurden), mit JavaScript auf der Seite zu interagieren und beliebige Befehle und Argumente zu senden. In Ruffles moderner Implementierung werden diese Befehle über onFSCommand verarbeitet, was selbst für sehr alte Webinhalte Funktionalität ermöglicht.

  6. Double Buffering für Context3D. Bei der Arbeit mit 3D-Inhalten verwendet Ruffle einen ausgeklügelten Double Buffering-Mechanismus (Back Buffer / Front Buffer). Dies ist eine Standard-, aber entscheidende Leistungstechnik, die es ermöglicht, den nächsten Frame im Hintergrundpuffer zu rendern, während der aktuelle auf dem Bildschirm angezeigt wird, wodurch visuelle Artefakte (Frame Tearing) in dynamischen Spielen eliminiert werden.

  7. Benchmarking-Tools: ruffle_scanner und exporter. Im Ruffle-Repository befinden sich Hilfsprogramme, die nicht im Standard-Build enthalten, aber für Entwickler verfügbar sind:

    • ruffle_scanner — ermöglicht das Testen der Kompatibilität des Emulators mit einem ganzen Ordner von SWF-Dateien und generiert einen CSV-Bericht über den Parsing-Erfolg.

    • exporter — ein Werkzeug zur Stapelgenerierung von PNG-Screenshots aus SWF-Dateien, das im Headless-Modus (ohne GUI) ausgeführt werden kann, nützlich für automatisierte Tests und die Erstellung von Vorschaubildern.

  8. Vollständige Isolierung über Flatpak-Sandbox. Für Linux-Benutzer gibt es einen offiziellen Ruffle-Build im Flatpak-Format. Dies ist nicht nur eine Installationsmethode, sondern eine zusätzliche Sicherheitsebene: Die Anwendung läuft in einer isolierten Umgebung, in der alle Spielstände, Konfigurationen und Logs streng innerhalb des Flatpak-Home-Verzeichnisses (~/.var/app/rs.ruffle.Ruffle/) gespeichert werden, ohne Zugriff auf den Rest des Systems.

  9. Integrationsunterstützung über Homebrew und Scoop. Für erfahrene Benutzer bietet Ruffle erweiterte Installationsmethoden über manuellen Download hinaus. Unter macOS kann es über Homebrew installiert werden (brew install --HEAD ruffle-rs/ruffle/ruffle), was automatische Updates auf den neuesten Nightly-Build ermöglicht. Unter Windows erfüllt der Paketmanager Scoop eine ähnliche Funktion.

  10. Transparentes Datenspeichersystem (SharedObjects). Ruffle emuliert genau das lokale Flash-Speichersystem (LSO — Local Shared Objects). Im Gegensatz zum proprietären Player ist der Speicherort dieser Dateien jedoch standardisiert und für den Benutzer transparent. Unter Windows befinden sie sich in %AppData%\Local\Ruffle\SharedObjects\, unter Linux in ~/.local/share/ruffle/SharedObjects/. Dies ermöglicht die manuelle Sicherung von Spielständen aus alten Spielen.

  11. Konfiguration über JavaScript-API und globale Einstellungen. Für Webentwickler bietet Ruffle eine leistungsstarke JavaScript-API, die nicht nur das Einbetten des Players, sondern auch die Steuerung seines Zustands ermöglicht. Es stehen Methoden zum programmgesteuerten Laden von SWF (load), zur Lautstärkeregelung (volume), zum Anhalten (suspend/resume) und zum Abfangen von trace()-Ausgaben aus ActionScript zum Debuggen über traceObserver zur Verfügung.

  12. Automatische Signierung und Notarisierung von macOS-Builds. Im CI/CD-Prozess durchlaufen alle Nightly-Builds von Ruffle für macOS eine Code-Signierung und Notarisierung durch Apple. Dies bedeutet, dass selbst instabile Versionen des Emulators nicht von Gatekeeper als unsichere Software blockiert werden, was einen problemlosen Betrieb auf den neuesten macOS-Versionen gewährleistet, in denen die Sicherheitsanforderungen streng sind.

Installieren der Desktop-Version von Ruffle

Die Desktop-Version von Ruffle ist eine native Anwendung, mit der Sie SWF-Dateien direkt auf Ihrem Computer öffnen und abspielen können, ohne dass ein Browser erforderlich ist. Dies ist eine ideale Wahl für die Anzeige lokaler Archive von Flash-Spielen und -Animationen.

Windows (10, 11)

Methode 1: Grafische Oberfläche (empfohlen)

  1. Laden Sie die Datei mit dem Namen ruffle-windows-x86_64.zip (für 64-Bit-Systeme) oder ruffle-windows-x86.zip (für 32-Bit-Systeme) herunter.

  2. Extrahieren Sie den Archivinhalt in einen beliebigen Ordner (z. B. C:\Programme\Ruffle oder C:\Benutzer\[Ihr_Benutzername]\Dokumente\Ruffle).

  3. Doppelklicken Sie zum Starten auf die ausführbare Datei ruffle.exe. Die grafische Oberfläche der Anwendung wird geöffnet.

  4. Klicken Sie zum Öffnen einer SWF-Datei auf die Schaltfläche Datei öffnen in der Oberfläche oder ziehen Sie die SWF-Datei einfach per Drag & Drop in das Anwendungsfenster.

  5. Alternative Methode: Richten Sie die Dateizuordnung ein. Klicken Sie mit der rechten Maustaste auf eine beliebige .swf-Datei, wählen Sie Öffnen mit → Eine andere App auswählen, suchen Sie ruffle.exe und aktivieren Sie die Option Immer diese App zum Öffnen von .swf-Dateien verwenden.

Methode 2: Kommandozeile

Für erfahrene Benutzer ist eine Kommandozeilenschnittstelle verfügbar:

  1. Öffnen Sie die Eingabeaufforderung (CMD) oder PowerShell.

  2. Navigieren Sie zu dem Ordner, der ruffle.exe enthält, oder fügen Sie diesen Ordner zur Umgebungsvariablen PATH hinzu.

  3. Führen Sie zum Ausführen einer lokalen Datei den Befehl aus:

    ruffle.exe C:\Pfad\zu\Ihrer\datei.swf

  4. Zum Ausführen einer SWF-Datei von einer URL:

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

  5. Um alle verfügbaren Kommandozeilenparameter anzuzeigen:

    ruffle.exe --help

Methode 3: Installation über den Scoop-Paketmanager

Für diejenigen, die eine automatisierte Installation bevorzugen:

scoop bucket add extras
scoop install ruffle

macOS

Methode 1: Grafische Oberfläche (empfohlen)

  1. Laden Sie die Datei ruffle-macos-x86_64.dmg oder ruffle-macos-aarch64.dmg (für Apple Silicon M1/M2/M3) von der Versionsseite herunter.

  2. Öffnen Sie die heruntergeladene .dmg-Datei.

  3. Ziehen Sie das Symbol Ruffle in den Ordner Programme.

  4. Starten Sie Ruffle aus dem Ordner "Programme". Beim ersten Start wird das System möglicherweise um Bestätigung bitten – klicken Sie auf Öffnen.

  5. Verwenden Sie nach dem Start der Anwendung die Schaltfläche Datei öffnen oder ziehen Sie eine SWF-Datei per Drag & Drop in das Fenster.

Methode 2: Installation über Homebrew

Für fortgeschrittene Benutzer:

# Installieren Sie die neueste stabile Version (falls verfügbar)
brew install ruffle

# Oder installieren Sie den neuesten Nightly-Build aus dem Quellcode
brew install --HEAD ruffle-rs/ruffle/ruffle

Methode 3: Kommandozeile

Nach der Installation über Homebrew oder dem manuellen Platzieren von ruffle in /usr/local/bin:

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

Linux

Methode 1: Installation über Flatpak (empfohlen für Isolierung)

Flatpak bietet maximale Sicherheit, indem es Ruffle in einer isolierten Sandbox ausführt:

# Flathub-Repository hinzufügen
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Ruffle installieren
flatpak install flathub rs.ruffle.Ruffle

# Ausführen
flatpak run rs.ruffle.Ruffle

Methode 2: Installation über AppImage (keine Installation erforderlich)

  1. Laden Sie die Datei ruffle-x86_64.AppImage von der Versionsseite herunter.

  2. Machen Sie die Datei ausführbar:

    chmod +x ruffle-x86_64.AppImage

  3. Führen Sie sie per Doppelklick oder über das Terminal aus:

    ./ruffle-x86_64.AppImage

Methode 3: Manuelle Installation (für Debian/Ubuntu-basierte Distributionen)

  1. Laden Sie ruffle-linux-x86_64.tar.gz (oder ruffle-linux-armv7.tar.gz für ARM-Geräte wie Raspberry Pi) herunter.

  2. Extrahieren Sie das Archiv:

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

  3. Kopieren Sie die ausführbare Datei in ein Systemverzeichnis:

    sudo cp ruffle /usr/local/bin/

  4. Starten Sie über das Terminal:

    ruffle

Installieren von Ruffle als Browser-Erweiterung

Die Ruffle-Erweiterung erkennt automatisch Flash-Inhalte auf jeder Webseite und ersetzt sie durch den Emulator.

Wichtiger Hinweis

Derzeit ist die Erweiterung nicht in offiziellen Erweiterungsgeschäften (Chrome Web Store, Firefox Add-ons) gehostet und befindet sich in aktiver Entwicklung. Die Installation erfolgt manuell über den Entwicklermodus des Browsers.

Installation in Google Chrome und Chromium-basierten Browsern

Unterstützte Browser: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc und andere auf Chromium basierende.

Schritt-für-Schritt-Anleitung:

  1. Gehen Sie zur Ruffle-Versionsseite auf GitHub.

  2. Laden Sie das Archiv namens ruffle-chromium.zip (oder ein ähnliches, das chromium enthält) herunter.

  3. Extrahieren Sie das Archiv in einen permanenten Ordner auf Ihrem Computer. Wichtig: Löschen Sie diesen Ordner nach der Installation nicht, da der Browser für die Funktion der Erweiterung darauf zugreifen wird. Empfohlene Speicherorte:

    • Windows: C:\Benutzer\[Ihr_Benutzername]\AppData\Local\Ruffle\

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

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

  4. Öffnen Sie Ihren Browser und geben Sie Folgendes in die Adressleiste ein:

    chrome://extensions/

  5. Aktivieren Sie in der oberen rechten Ecke der Seite den Entwicklermodus.

  6. Klicken Sie auf die Schaltfläche Entpackte Erweiterung laden.

  7. Wählen Sie im sich öffnenden Dialog den Ordner aus, in den Sie das Archiv ruffle-chromium.zip extrahiert haben, und klicken Sie auf Ordner auswählen.

  8. Die Erweiterung ist installiert. Beim Besuch von Websites mit Flash-Inhalten wird Ruffle nun automatisch aktiviert.

Für Microsoft Edge (Chromium): Der Vorgang ist identisch mit Chrome. Verwenden Sie edge://extensions/ anstelle von chrome://extensions/ und aktivieren Sie den Entwicklermodus.

Installation in Mozilla Firefox

Wichtig: In Firefox wird die Erweiterung nur vorübergehend installiert und nach einem Neustart des Browsers entfernt. Dies ist eine Einschränkung von Firefox für nicht signierte Erweiterungen. Für die dauerhafte Nutzung wird die Desktop-Version oder das Warten auf eine Veröffentlichung im offiziellen Store empfohlen.

Schritt-für-Schritt-Anleitung:

  1. Gehen Sie zur Ruffle-Versionsseite auf GitHub.

  2. Laden Sie die Datei namens ruffle-firefox.xpi herunter. Wählen Sie beim Herunterladen Datei speichern.

  3. Geben Sie in Firefox Folgendes in die Adressleiste ein:

    about:debugging

  4. Wählen Sie in der linken Seitenleiste Dieser Firefox.

  5. Klicken Sie auf die Schaltfläche Vorübergehendes Add-on laden….

  6. Wählen Sie im Dateidialog die heruntergeladene Datei ruffle-firefox.xpi aus und klicken Sie auf Öffnen.

  7. Die Erweiterung wird geladen und aktiviert. Sie funktioniert, bis Sie den Browser schließen.

Tipp: Wenn Sie Firefox Nightly oder Developer Edition verwenden, können Sie die Signaturprüfung für Erweiterungen über about:config deaktivieren, was eine dauerhafte Installation ermöglicht. Dies wird aus Sicherheitsgründen jedoch nicht für den täglichen Gebrauch empfohlen.

Installation in Safari (macOS)

Die Installation der Ruffle-Erweiterung in Safari erfordert aufgrund der Sicherheitsrichtlinien von Apple zusätzliche Schritte.

  1. Laden Sie die Datei ruffle-safari.zip von der Versionsseite herunter.

  2. Extrahieren Sie das Archiv.

  3. Führen Sie die Datei Ruffle.app aus dem extrahierten Ordner aus. Dadurch wird die Erweiterung auf Ihrem System installiert.

  4. Öffnen Sie Safari, gehen Sie zu Safari → Einstellungen → Registerkarte Erweiterungen.

  5. Stellen Sie sicher, dass der Schalter neben Ruffle auf Ein gestellt ist.

  6. Die Erweiterung ist aktiviert und funktioniert mit Flash-Inhalten auf Webseiten.

Installieren von Ruffle auf einer Website (für Webmaster)

Wenn Sie eine Website besitzen, die Flash-Inhalte hostet, können Sie Ruffle direkt in Ihren Seitenquellcode integrieren. Dadurch können Ihre Besucher Flash-Inhalte automatisch abspielen, ohne Erweiterungen installieren zu müssen.

Die einfachste Methode: Verwendung des JavaScript-Players

  1. Laden Sie die Datei ruffle.js und den Ressourcenordner ruffle von der Versionsseite herunter.

  2. Laden Sie diese Dateien auf Ihren Server hoch (z. B. in einen Ordner wie /js/ruffle/).

  3. Fügen Sie den folgenden Code in den <head>-Bereich jeder Seite ein, auf der Flash-Inhalte vorhanden sind:

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Player-Einstellungen
        autoplay: "auto", // "on", "off" oder "auto"
        splashScreen: false, // Startbildschirm deaktivieren
    };
</script>

  1. Ruffle erkennt automatisch alle object-, embed- und applet-Elemente auf der Seite und ersetzt sie durch seinen eigenen Player.

Erweiterte Einrichtung über CDN (ohne Herunterladen von Dateien)

Für schnelle Tests können Sie ein CDN verwenden:

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

Manuelle Initialisierung für dynamisch geladene Inhalte:

Wenn SWF-Dateien dynamisch (über JavaScript) zur Seite hinzugefügt werden, können Sie den Player manuell initialisieren:

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("pfad/zu/ihrer/datei.swf");
document.body.appendChild(player);

Funktionalität überprüfen

Nach der Installation von Ruffle mit einer beliebigen Methode können Sie dessen Funktion überprüfen:

  1. Desktop-Version: Öffnen Sie einfach eine beliebige SWF-Datei.

  2. Browser-Erweiterung: Besuchen Sie die Internet Archive Flash-Spiele-Sammlung oder eine beliebige Seite mit bekanntem Flash-Inhalt. Wenn das Flash-Element angezeigt wird und abgespielt wird, funktioniert Ruffle korrekt.

  3. Diagnose: Drücken Sie in Ihrem Browser F12, um die Entwicklertools zu öffnen. In der Konsole sehen Sie Meldungen von Ruffle, die dessen Aktivierung bestätigen.

Fehlerbehebung bei häufigen Problemen

Problem Mögliche Lösung
Erweiterung wird auf einer Website nicht aktiviert Stellen Sie sicher, dass die Website nicht in den Erweiterungseinstellungen blockiert ist. Überprüfen Sie, ob der Entwicklermodus unter chrome://extensions/ aktiviert ist.
SWF-Datei wird nicht abgespielt oder zeigt einen weißen Bildschirm Die aktuelle Version von Ruffle unterstützt diese spezielle SWF-Datei möglicherweise nicht. Überprüfen Sie, ob der Inhalt AVM2 (ActionScript 3) verwendet, dessen Unterstützung noch verfeinert wird.
Datei kann in der Desktop-Version nicht geöffnet werden Stellen Sie sicher, dass die Datei nicht beschädigt ist. Versuchen Sie, sie über die Kommandozeile mit dem Flag --verbose zu öffnen, um detaillierte Fehlerprotokolle zu erhalten.
Erweiterung ist nach dem Neustart von Firefox verschwunden Dies ist normales Verhalten für temporäre Erweiterungen. Verwenden Sie die Desktop-Version oder warten Sie auf die offizielle Veröffentlichung im Add-on-Store.
Geringe Leistung im Browser Versuchen Sie, das Rendering-Backend in den Erweiterungseinstellungen umzuschalten. Überprüfen Sie bei Chromium-Browsern auch, ob die Hardwarebeschleunigung in den Browsereinstellungen aktiviert ist.