Ruffle - Émulateur Adobe Flash Player

Ruffle est un émulateur Adobe Flash Player essentiel pour exécuter du contenu Flash hérité (jeux, animations, applications et bannières SWF). Il fonctionne comme une application autonome sur tous les systèmes d'exploitation (y compris Windows, macOS et Linux) et s'intègre dans les navigateurs via WebAssembly.

Ruffle fournit des versions distinctes pour Windows, macOS et Linux qui fonctionnent comme des programmes classiques : il suffit d'exécuter l'exécutable et d'ouvrir le fichier SWF souhaité à l'intérieur.

Ruffle exploite la sécurité mémoire du langage Rust et le sandbox du navigateur moderne. Cela permet d'exécuter d'anciens contenus potentiellement risqués sans risque d'infection du système ou de fuite de données.

L'émulateur combine la prise en charge à la fois de l'AVM1 plus ancienne (ActionScript 1 et 2, utilisée jusqu'en 2006) et de l'AVM2 plus complexe (ActionScript 3). Ceci est nécessaire pour le bon fonctionnement de pratiquement tout contenu Flash, des animations du début des années 2000 aux jeux et applications complexes sortis juste avant l'arrêt de la technologie.

Liens de téléchargement :

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

Tous les liens mènent vers des sources officielles : les versions pour Windows (x86_64), macOS (universelle pour Intel et Apple Silicon), Linux (x86_64 et ARM64 pour Raspberry Pi et appareils ARM) sont distribuées via le dépôt GitHub du projet Ruffle, tandis que la version Linux au format Flatpak est disponible via le catalogue officiel Flathub avec signatures numériques et isolation de l'application.

Sommaire :

Principales caractéristiques de Ruffle

Intégration via WebAssembly. Pour le fonctionnement dans le navigateur, Ruffle est compilé en WebAssembly (Wasm) — un bytecode de bas niveau exécuté dans le sandbox isolé du navigateur avec des performances proches du natif. Cela permet à l'émulateur de charger et de traiter des graphismes Flash complexes et leur logique sans avoir besoin d'installer des plugins NPAPI/PPAPI obsolètes et peu sécurisés.

Détection automatique et polyfill du contenu Flash. La version web de Ruffle inclut un détecteur JavaScript qui analyse la structure DOM de la page à la recherche d'éléments object, embed et applet, ainsi que de fichiers avec l'extension .swf. Lors de la détection de ce contenu, Ruffle le remplace automatiquement par son propre lecteur, corrigeant ainsi de manière transparente la page pour l'utilisateur et restaurant la fonctionnalité des éléments Flash.

Double mode de fonctionnement (application bureau et extension web). Ruffle offre aux utilisateurs une grande flexibilité : il peut être utilisé comme une application de bureau autonome pour la lecture locale de SWF (il suffit d'associer les fichiers à l'exécutable Ruffle) ou comme une extension de navigateur qui s'intègre à l'environnement de navigation web, fournissant le support Flash sur n'importe quel site.

Support d'ActionScript 1.0 et 2.0 (AVM1). Ruffle implémente la machine virtuelle AVM1, garantissant la compatibilité avec une vaste quantité de contenus créés avant 2006 et jusqu'en 2013. Le niveau de compatibilité actuel pour les constructions du langage AVM1 atteint 99%, et pour les API — 81%, assurant le bon fonctionnement de la grande majorité des jeux et animations Flash anciens.

Support d'ActionScript 3.0 (AVM2). Pour le contenu créé après 2006, Ruffle inclut une implémentation d'AVM2. Bien que le travail de compatibilité soit activement en cours, l'émulateur fournit déjà un niveau de support suffisant pour exécuter de nombreux jeux et applications complexes écrits en ActionScript 3, en élargissant constamment la couverture des API et les capacités du langage.

Sécurité au niveau du langage Rust. L'un des principaux avantages architecturaux de Ruffle est son utilisation du langage Rust. Rust garantit la sécurité mémoire au moment de la compilation, éliminant complètement des classes entières de vulnérabilités qui affligeaient le lecteur Flash original d'Adobe, telles que les débordements de tampon, les doubles libérations et les erreurs use-after-free.

Isolation dans le sandbox du navigateur. Lorsqu'il fonctionne dans un environnement web, Ruffle (via WebAssembly) se conforme entièrement à la politique de sécurité du navigateur. Cela ajoute une couche d'isolation supplémentaire : l'émulateur n'a pas d'accès direct au système de fichiers de l'utilisateur ni à d'autres processus système, ce qui rend son exploitation extrêmement difficile par rapport au plugin Flash classique.

Gestion efficace de la mémoire. Contrairement au lecteur Flash original, qui utilisait un ramasse-miettes avec des pauses non déterministes, Ruffle hérite du modèle de propriété stricte de Rust. Cela permet une utilisation plus prévisible de la mémoire, réduisant la fragmentation et éliminant les fuites de mémoire qui entraînaient souvent un comportement instable du navigateur.

Support de la ligne de commande. La version bureau de Ruffle offre une interface en ligne de commande entièrement fonctionnelle. Les utilisateurs peuvent exécuter l'émulateur avec des paramètres, par exemple : ruffle nomfichier.swf pour un fichier local, ou ruffle https://exemple.com/nomfichier.swf pour lire un SWF depuis une URL. La commande ruffle --help affiche une liste complète de tous les arguments et paramètres disponibles.

Code source ouvert et transparence du développement. Ruffle est distribué sous les licences Apache 2.0 et MIT. La complète ouverture du code source signifie que tout développeur peut auditer la sécurité de l'émulateur, contribuer à des correctifs et participer à son développement, éliminant la possibilité de fonctionnalités cachées ou de vulnérabilités qui pourraient être introduites par des développeurs d'entreprise.

Compatibilité avec une large gamme de navigateurs. Grâce à la technologie WebAssembly, Ruffle est supporté par tous les navigateurs modernes, y compris Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave et Vivaldi. Cela garantit une expérience cohérente avec le contenu Flash, quelles que soient les préférences de l'utilisateur en matière de moteurs de navigateur (Chromium, Gecko ou WebKit).

Support des navigateurs mobiles (iOS et Android). Contrairement au lecteur Flash original d'Adobe, qui n'a jamais été officiellement supporté sur iOS et ne l'était que partiellement sur Android, Ruffle fonctionne sur les plateformes mobiles. Cela permet aux jeux et animations Flash de tourner sur les smartphones et tablettes directement via le navigateur mobile, ouvrant l'accès aux contenus archivés pour le public mobile.

Aucune configuration requise. Ruffle est conçu selon le principe "installer et oublier". Après l'installation de l'extension ou le lancement de l'application bureau, l'émulateur ne nécessite aucune configuration complexe. Il détecte automatiquement les paramètres de lecture tels que la taille de la scène, le taux d'images et le type d'interaction, appliquant des réglages optimaux sans intervention de l'utilisateur.

Protection contre les vulnérabilités zero-day. Parce que Ruffle n'est pas un plugin, n'utilise pas d'API obsolètes et que son code est écrit en Rust en mettant l'accent sur la sécurité, il est immunisé contre les attaques qui étaient caractéristiques d'Adobe Flash Player. Cela en fait une solution idéale pour les organisations qui doivent maintenir l'accès à des contenus hérités sans pouvoir risquer une compromission du système.

Compatibilité avec diverses méthodes d'installation. Ruffle propose plusieurs méthodes de déploiement. Les développeurs web peuvent l'installer comme une extension statique dans les navigateurs basés sur Chromium (via le mode développeur) ou comme un module complémentaire temporaire dans Firefox (via about:debugging). L'intégration par l'insertion de code JavaScript simple côté serveur est également disponible.

Lecture de contenu en ligne et hors ligne. La version bureau de Ruffle permet d'ouvrir et de lire des fichiers SWF enregistrés localement sur l'ordinateur. Cela rend l'émulateur un outil indispensable pour les collectionneurs, les archivistes et les chercheurs travaillant avec des archives locales de jeux et d'animations Flash.

Performances de rendu élevées. Ruffle utilise des API graphiques modernes (telles que OpenGL, Vulkan, DirectX ou WebGL) via des bibliothèques multiplateformes. Cela fournit une accélération matérielle pour le rendu des graphismes vectoriels et bitmap, permettant une lecture fluide même sur des appareils plus faibles où le lecteur Flash original pouvait être saccadé.

Développement actif et mises à jour fréquentes. Le projet est en développement actif. Les versions sortent régulièrement et incluent à la fois des corrections de bogues critiques et un support élargi des API ActionScript. Par exemple, les versions récentes ont corrigé des cas particuliers dans les méthodes String.indexOf et lastIndexOf, et gèrent correctement les indices négatifs dans Array.indexOf.

Intégration avec les principales archives et plateformes. Ruffle a été choisi comme lecteur officiel pour la lecture de contenu Flash par des géants tels que l'Internet Archive, Newgrounds, Coolmath Games et Armor Games. Cela confirme le haut degré de fiabilité et de compatibilité de l'émulateur, ainsi que sa capacité à fonctionner sous de fortes charges dans des conditions réelles.

Support des sauvegardes et de l'état des jeux. Comme le lecteur Flash original, Ruffle supporte les Local Shared Objects (LSO), que de nombreux jeux utilisent pour sauvegarder la progression. L'émulateur émule correctement les mécanismes de lecture et d'écriture des données vers ce stockage, garantissant l'intégrité des sauvegardes pendant l'exécution de l'application.

Émulation précise des temporisations et du taux d'images. Ruffle émule avec précision la minuterie interne du Flash Player, ce qui est critique pour la logique des jeux et des animations. Cela assure une synchronisation correcte des événements, du son et du mouvement des objets, évitant les situations où un jeu tourne plus lentement ou plus rapidement que l'original.

Support de l'interaction DOM et JavaScript (ExternalInterface). Pour les applications web complexes qui utilisaient l'API ExternalInterface pour échanger des données entre ActionScript et JavaScript, Ruffle implémente un pont compatible. Cela permet à l'émulateur de gérer correctement les appels de fonction et le transfert de données, préservant ainsi l'interactivité du contenu avec la page web environnante.

Mise à l'échelle automatique et adaptation de la résolution. Lors de la lecture de contenu Flash créé pour une résolution spécifique (par exemple 800x600), Ruffle applique automatiquement des algorithmes de mise à l'échelle pour s'adapter à la taille actuelle de la fenêtre du navigateur ou de l'application de bureau. Il préserve les proportions et la qualité de l'image, et gère correctement les zones d'interaction de la souris.

Support de divers formats multimédia. L'émulateur supporte le décodage de divers formats multimédia pouvant être intégrés dans les fichiers SWF, y compris MP3 pour l'audio et la compression vidéo utilisée dans les versions ultérieures de Flash. Le décodage est effectué via des bibliothèques hautes performances écrites en Rust, réduisant la charge système.

Débogage et journalisation avancés. Pour les développeurs et les utilisateurs avancés, Ruffle offre la possibilité d'activer des journaux détaillés du fonctionnement des machines virtuelles AVM1/AVM2. Cela permet de diagnostiquer les problèmes de compatibilité, de suivre les erreurs dans le code ActionScript et de comprendre les processus internes de l'émulation pour un réglage plus précis.

Émulation du curseur et des éléments interactifs. Ruffle gère correctement les changements de style de curseur spécifiés par le contenu Flash. Par exemple, pour les éléments interactifs comme LoaderDisplay, l'émulateur change automatiquement le curseur standard en pointeur, imitant le comportement du lecteur Flash original et fournissant une navigation familière pour l'utilisateur.

Support des versions Nightly pour un accès anticipé. En plus des versions stables, l'équipe Ruffle donne accès à des versions expérimentales quotidiennes (Nightly builds). Ces versions contiennent les derniers correctifs et innovations non encore inclus dans la version stable.

Préservation du patrimoine culturel numérique. Ce n'est pas seulement une fonction technique, mais un objectif fondamental du projet. Ruffle a été créé comme un outil pour préserver le contenu historique d'Internet. Grâce à sa capacité à fonctionner dans les navigateurs modernes sans compromettre la sécurité, des millions de jeux Flash, animations et applications qui auraient été définitivement perdus après l'arrêt d'Adobe Flash Player restent accessibles pour les générations futures.

12 capacités techniques méconnues de Ruffle

  1. Utilisation de WGPU comme moteur de rendu principal. Contrairement à de nombreux émulateurs qui reposent sur OpenGL hérité, Ruffle utilise la bibliothèque WGPU — une API graphique moderne, sûre et multiplateforme. Sur bureau, WGPU sélectionne automatiquement le backend bas niveau le plus optimal : Vulkan, DirectX 12 ou Metal. Dans le navigateur, il peut fonctionner via WebGPU (là où c'est disponible) ou émuler le fonctionnement via WebGL avec une perte de performance minimale.

  2. Support WebGPU dans le navigateur pour des performances maximales. Pour les utilisateurs de navigateurs modernes (par exemple, les dernières versions de Chrome et Edge), Ruffle peut utiliser l'API de pointe WebGPU. Cela réduit considérablement le temps de compilation des shaders et diminue la surcharge par rapport au backend WebGL standard, ce qui est critique pour les graphismes 3D complexes et les applications Stage3D.

  3. Réglage fin du moteur de rendu (canvas, webgl, wgpu-webgl). Peu de gens savent que le comportement de rendu peut être contrôlé manuellement. En plus du wgpu-webgl standard, il existe une option pour forcer l'activation :

    • webgl — un backend classique qui s'initialise plus rapidement et peut être utile pour un contenu simple ne nécessitant pas d'effets bitmap complexes.

    • canvas — le backend le plus lent, mais le plus précis. C'est le seul qui met correctement à l'échelle les traits de contour fins dans les graphiques vectoriels, qui peuvent apparaître trop épais lors de l'utilisation de l'accélération matérielle.

  4. Émulation de Stage3D et compilation d'AGAL vers WGSL. Ruffle supporte non seulement les graphismes 2D mais aussi l'accélération 3D via l'API Stage3D (Context3D). Les shaders écrits en AGAL (Adobe Graphics Assembly Language) sont compilés "à la volée" en WGSL (WebGPU Shading Language) ou GLSL moderne. Cela permet d'exécuter des jeux et applications 3D complexes créés pour Flash Player 11 et versions ultérieures, en utilisant un pipeline complet de shaders programmables.

  5. Support de fscommand pour la rétrocompatibilité. Ruffle a conservé le support du mécanisme fscommand, ancien mais important. Cela permet aux anciennes animations Flash (créées avant ExternalInterface) d'interagir avec JavaScript sur la page, en envoyant des commandes et arguments arbitraires. Dans l'implémentation moderne de Ruffle, ces commandes sont traitées via onFSCommand, permettant la fonctionnalité même pour des contenus web très anciens.

  6. Double tampon pour Context3D. Lorsqu'il travaille avec du contenu 3D, Ruffle utilise un mécanisme sophistiqué de double tampon (back buffer / front buffer). Il s'agit d'une technique standard mais cruciale pour les performances, permettant de rendre l'image suivante dans le tampon arrière pendant que l'image actuelle est affichée à l'écran, éliminant les artefacts visuels (déchirure d'image) dans les jeux dynamiques.

  7. Outils de benchmarking : ruffle_scanner et exporter. Dans le dépôt Ruffle, il existe des outils utilitaires non inclus dans la version standard mais disponibles pour les développeurs :

    • ruffle_scanner — permet de tester la compatibilité de l'émulateur avec un dossier entier de fichiers SWF, générant un rapport CSV sur le succès de l'analyse.

    • exporter — un outil pour générer en masse des captures d'écran PNG à partir de fichiers SWF, qui peut fonctionner en mode headless (sans interface graphique), utile pour les tests automatisés et la création d'aperçus.

  8. Isolation complète via le sandbox Flatpak. Pour les utilisateurs Linux, il existe une version officielle de Ruffle au format Flatpak. Ce n'est pas seulement une méthode d'installation, mais une couche de sécurité supplémentaire : l'application s'exécute dans un environnement isolé où toutes les sauvegardes, configurations et journaux sont stockés strictement dans le répertoire home de Flatpak (~/.var/app/rs.ruffle.Ruffle/), sans accès au reste du système.

  9. Support d'intégration via Homebrew et Scoop. Pour les utilisateurs expérimentés, Ruffle offre des méthodes d'installation avancées au-delà du téléchargement manuel. Sur macOS, il peut être installé via Homebrew (brew install --HEAD ruffle-rs/ruffle/ruffle), permettant des mises à jour automatiques vers la dernière version nightly. Sur Windows, le gestionnaire de paquets Scoop remplit une fonction similaire.

  10. Système de stockage de données transparent (SharedObjects). Ruffle émule avec précision le système de stockage local Flash (LSO — Local Shared Objects). Cependant, contrairement au lecteur propriétaire, l'emplacement de ces fichiers est standardisé et transparent pour l'utilisateur. Sous Windows, ils se trouvent dans %AppData%\Local\Ruffle\SharedObjects\, sous Linux — dans ~/.local/share/ruffle/SharedObjects/. Cela permet une sauvegarde manuelle des sauvegardes de vieux jeux.

  11. Configuration via l'API JavaScript et les paramètres globaux. Pour les développeurs web, Ruffle fournit une puissante API JavaScript, permettant non seulement d'intégrer le lecteur mais aussi de contrôler son état. Des méthodes sont disponibles pour charger un SWF par programme (load), contrôler le volume (volume), mettre en pause (suspend/resume), et intercepter les sorties trace() d'ActionScript pour le débogage via traceObserver.

  12. Signature automatique et notarisation des versions macOS. Dans le processus CI/CD, toutes les versions nightly de Ruffle pour macOS subissent une signature de code et une notarisation par Apple. Cela signifie que même les versions instables de l'émulateur ne seront pas bloquées par Gatekeeper comme logiciels non sécurisés, assurant un fonctionnement sans problème sur les dernières versions de macOS où les exigences de sécurité sont strictes.

Installation de la version bureau de Ruffle

La version bureau de Ruffle est une application native qui vous permet d'ouvrir et de lire des fichiers SWF directement sur votre ordinateur, sans avoir besoin d'un navigateur. C'est un choix idéal pour visualiser des archives locales de jeux et d'animations Flash.

Windows (10, 11)

Méthode 1 : Interface graphique (recommandée)

  1. Téléchargez le fichier nommé ruffle-windows-x86_64.zip (pour les systèmes 64 bits) ou ruffle-windows-x86.zip (pour les systèmes 32 bits).

  2. Extrayez le contenu de l'archive dans un dossier de votre choix (par exemple, C:\Program Files\Ruffle ou C:\Users\[Votre_Nom_Utilisateur]\Documents\Ruffle).

  3. Pour l'exécuter, double-cliquez sur le fichier exécutable ruffle.exe. L'interface graphique de l'application s'ouvrira.

  4. Pour ouvrir un fichier SWF, cliquez sur le bouton Open File dans l'interface ou faites simplement glisser le fichier SWF dans la fenêtre de l'application.

  5. Méthode alternative : Configurez l'association de fichiers. Faites un clic droit sur n'importe quel fichier .swf, sélectionnez Open with → Choose another app, localisez ruffle.exe et cochez l'option Always use this app to open .swf files.

Méthode 2 : Ligne de commande

Pour les utilisateurs expérimentés, une interface en ligne de commande est disponible :

  1. Ouvrez l'invite de commandes (CMD) ou PowerShell.

  2. Naviguez jusqu'au dossier contenant ruffle.exe, ou ajoutez ce dossier à votre variable d'environnement PATH.

  3. Pour exécuter un fichier local, exécutez la commande :

    ruffle.exe C:\chemin\vers\votre\fichier.swf

  4. Pour exécuter un fichier SWF depuis une URL :

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

  5. Pour afficher tous les paramètres de ligne de commande disponibles :

    ruffle.exe --help

Méthode 3 : Installation via le gestionnaire de paquets Scoop

Pour ceux qui préfèrent une installation automatisée :

scoop bucket add extras
scoop install ruffle

macOS

Méthode 1 : Interface graphique (recommandée)

  1. Téléchargez le fichier ruffle-macos-x86_64.dmg ou ruffle-macos-aarch64.dmg (pour Apple Silicon M1/M2/M3) depuis la page des versions.

  2. Ouvrez le fichier .dmg téléchargé.

  3. Glissez l'icône Ruffle dans le dossier Applications.

  4. Lancez Ruffle depuis le dossier Applications. Au premier lancement, le système peut demander une confirmation — cliquez sur Open.

  5. Après le lancement de l'application, utilisez le bouton Open File ou glissez-déposez un fichier SWF dans la fenêtre.

Méthode 2 : Installation via Homebrew

Pour les utilisateurs avancés :

# Installer la dernière version stable (si disponible)
brew install ruffle

# Ou installer la dernière version nightly depuis le code source
brew install --HEAD ruffle-rs/ruffle/ruffle

Méthode 3 : Ligne de commande

Après l'installation via Homebrew ou après avoir placé manuellement ruffle dans /usr/local/bin :

ruffle ~/Downloads/jeu.swf
ruffle https://exemple.com/jeu.swf

Linux

Méthode 1 : Installation via Flatpak (recommandée pour l'isolation)

Flatpak offre une sécurité maximale en faisant tourner Ruffle dans un sandbox isolé :

# Ajouter le dépôt Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Installer Ruffle
flatpak install flathub rs.ruffle.Ruffle

# Exécuter
flatpak run rs.ruffle.Ruffle

Méthode 2 : Installation via AppImage (aucune installation requise)

  1. Téléchargez le fichier ruffle-x86_64.AppImage depuis la page des versions.

  2. Rendez le fichier exécutable :

    chmod +x ruffle-x86_64.AppImage

  3. Exécutez-le par double-clic ou via le terminal :

    ./ruffle-x86_64.AppImage

Méthode 3 : Installation manuelle (pour les distributions basées sur Debian/Ubuntu)

  1. Téléchargez ruffle-linux-x86_64.tar.gz (ou ruffle-linux-armv7.tar.gz pour les appareils ARM comme le Raspberry Pi).

  2. Extrayez l'archive :

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

  3. Copiez le fichier exécutable dans un répertoire système :

    sudo cp ruffle /usr/local/bin/

  4. Exécutez depuis le terminal :

    ruffle

Installation de Ruffle comme extension de navigateur

L'extension Ruffle détecte automatiquement le contenu Flash sur n'importe quelle page web et le remplace par l'émulateur.

Remarque importante

Actuellement, l'extension n'est pas hébergée dans les boutiques d'extensions officielles (Chrome Web Store, Firefox Add-ons) et est en cours de développement actif. L'installation se fait manuellement, via le mode développeur du navigateur.

Installation dans Google Chrome et les navigateurs basés sur Chromium

Navigateurs supportés : Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc et autres basés sur Chromium.

Instructions étape par étape :

  1. Rendez-vous sur la page des versions Ruffle sur GitHub.

  2. Téléchargez l'archive nommée ruffle-chromium.zip (ou similaire contenant chromium).

  3. Extrayez l'archive dans un dossier permanent sur votre ordinateur. Important : Ne supprimez pas ce dossier après l'installation, car le navigateur y accédera pour le fonctionnement de l'extension. Emplacements recommandés :

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

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

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

  4. Ouvrez votre navigateur et saisissez ce qui suit dans la barre d'adresse :

    chrome://extensions/

  5. Dans le coin supérieur droit de la page, activez le Mode développeur.

  6. Cliquez sur le bouton Charger l'extension non empaquetée.

  7. Dans la boîte de dialogue qui s'ouvre, sélectionnez le dossier où vous avez extrait l'archive ruffle-chromium.zip, puis cliquez sur Sélectionner le dossier.

  8. L'extension est installée. Désormais, lors de la visite de sites avec du contenu Flash, Ruffle s'activera automatiquement.

Pour Microsoft Edge (Chromium) : Le processus est identique à celui de Chrome. Utilisez edge://extensions/ au lieu de chrome://extensions/ et activez le mode développeur.

Installation dans Mozilla Firefox

Important : Dans Firefox, l'extension s'installe uniquement à titre temporaire et sera supprimée après le redémarrage du navigateur. Il s'agit d'une limitation de Firefox pour les extensions non signées. Pour une utilisation permanente, il est recommandé d'utiliser la version bureau ou d'attendre la publication dans la boutique officielle.

Instructions étape par étape :

  1. Rendez-vous sur la page des versions Ruffle sur GitHub.

  2. Téléchargez le fichier nommé ruffle-firefox.xpi. Lors du téléchargement, choisissez Enregistrer le fichier.

  3. Dans Firefox, saisissez ce qui suit dans la barre d'adresse :

    about:debugging

  4. Dans la barre latérale gauche, sélectionnez Ce Firefox.

  5. Cliquez sur le bouton Charger un module complémentaire temporaire….

  6. Dans la boîte de dialogue de sélection de fichiers, choisissez le fichier ruffle-firefox.xpi téléchargé et cliquez sur Ouvrir.

  7. L'extension sera chargée et activée. Elle fonctionnera jusqu'à ce que vous fermiez le navigateur.

Astuce : Si vous utilisez Firefox Nightly ou Developer Edition, vous pouvez désactiver la vérification des signatures des extensions via about:config, ce qui permet une installation permanente, mais cela n'est pas recommandé pour une utilisation quotidienne pour des raisons de sécurité.

Installation dans Safari (macOS)

L'installation de l'extension Ruffle dans Safari nécessite des étapes supplémentaires en raison de la politique de sécurité d'Apple.

  1. Téléchargez le fichier ruffle-safari.zip depuis la page des versions.

  2. Extrayez l'archive.

  3. Exécutez le fichier Ruffle.app du dossier extrait. Cela installera l'extension sur votre système.

  4. Ouvrez Safari, allez dans Safari → Réglages → onglet Extensions.

  5. Assurez-vous que l'interrupteur à côté de Ruffle est sur On (activé).

  6. L'extension est activée et fonctionnera avec le contenu Flash sur les pages web.

Installation de Ruffle sur un site web (pour les webmasters)

Si vous possédez un site web qui héberge du contenu Flash, vous pouvez intégrer Ruffle directement dans le code de votre page. Cela permettra à vos visiteurs du site de lire automatiquement le contenu Flash sans avoir à installer d'extensions.

La méthode la plus simple : Utiliser le lecteur JavaScript

  1. Téléchargez le fichier ruffle.js et le dossier de ressources ruffle depuis la page des versions.

  2. Chargez ces fichiers sur votre serveur (par exemple, dans un dossier comme /js/ruffle/).

  3. Ajoutez le code suivant dans la section <head> de chaque page où le contenu Flash est présent :

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Paramètres du lecteur
        autoplay: "auto", // "on", "off" ou "auto"
        splashScreen: false, // Désactiver l'écran de démarrage
    };
</script>

  1. Ruffle détectera automatiquement tous les éléments object, embed et applet sur la page et les remplacera par son lecteur.

Configuration avancée via CDN (sans télécharger de fichiers)

Pour des tests rapides, vous pouvez utiliser un CDN :

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

Initialisation manuelle pour le contenu chargé dynamiquement :

Si des fichiers SWF sont ajoutés à la page dynamiquement (via JavaScript), vous pouvez initialiser le lecteur manuellement :

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("chemin/vers/votre/fichier.swf");
document.body.appendChild(player);

Vérification du fonctionnement

Après avoir installé Ruffle par l'une des méthodes, vous pouvez vérifier son fonctionnement :

  1. Version bureau : Ouvrez simplement n'importe quel fichier SWF.

  2. Extension de navigateur : Visitez la collection de jeux Flash de l'Internet Archive ou tout site avec du contenu Flash connu. Si l'élément Flash s'affiche et se lit, Ruffle fonctionne correctement.

  3. Diagnostics : Dans votre navigateur, appuyez sur F12 pour ouvrir les outils de développement. Dans la console, vous verrez des messages de Ruffle confirmant son activation.

Dépannage des problèmes courants

Problème Solution possible
L'extension ne s'active pas sur un site Assurez-vous que le site n'est pas bloqué dans les paramètres de l'extension. Vérifiez que le mode développeur est activé dans chrome://extensions/.
Le fichier SWF ne se lit pas ou affiche un écran blanc La version actuelle de Ruffle peut ne pas supporter ce fichier SWF spécifique. Vérifiez si le contenu est en AVM2 (ActionScript 3), dont le support est encore en cours d'amélioration.
Impossible d'ouvrir le fichier dans la version bureau Assurez-vous que le fichier n'est pas corrompu. Essayez de l'ouvrir depuis la ligne de commande avec l'option --verbose pour obtenir des journaux d'erreur détaillés.
L'extension a disparu après le redémarrage de Firefox C'est un comportement normal pour les extensions temporaires. Utilisez la version bureau ou attendez la publication officielle dans la boutique de modules complémentaires.
Faibles performances dans le navigateur Essayez de changer le moteur de rendu dans les paramètres de l'extension. Pour les navigateurs Chromium, vérifiez également que l'accélération matérielle est activée dans les paramètres du navigateur.