Ruffle - Emulator Adobe Flash Playera

Ruffle to niezbędny emulator Adobe Flash Playera do uruchamiania starszych treści Flash (gier, animacji, aplikacji i banerów SWF). Działa jako samodzielna aplikacja na wszystkich systemach operacyjnych (w tym Windows, macOS i Linux) i integruje się z przeglądarkami za pośrednictwem WebAssembly.

Ruffle udostępnia osobne kompilacje dla systemów Windows, macOS i Linux, które działają jak zwykłe programy: wystarczy uruchomić plik wykonywalny i otworzyć w nim żądany plik SWF.

Ruffle wykorzystuje bezpieczeństwo pamięci języka Rust oraz mechanizmy izolacji nowoczesnych przeglądarek. Pozwala to na uruchamianie potencjalnie ryzykownych, starszych treści bez ryzyka infekcji systemu lub wycieku danych.

Emulator łączy obsługę zarówno starszego AVM1 (ActionScript 1 i 2, używany do 2006 roku), jak i bardziej złożonego AVM2 (ActionScript 3). Jest to niezbędne do prawidłowego działania praktycznie każdej treści Flash, od animacji z wczesnych lat 2000 po złożone gry i aplikacje wydane tuż przed wycofaniem tej technologii.

Linki do pobrania:

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

Wszystkie linki prowadzą do oficjalnych źródeł: kompilacje dla systemów Windows (x86_64), macOS (uniwersalna dla Intel i Apple Silicon), Linux (x86_64 i ARM64 dla Raspberry Pi i urządzeń ARM) są dystrybuowane za pośrednictwem repozytorium GitHub projektu Ruffle, natomiast wersja dla systemu Linux w formacie Flatpak jest dostępna za pośrednictwem oficjalnego katalogu Flathub z podpisami cyfrowymi i izolacją aplikacji.

Spis treści:

Kluczowe cechy Ruffle

Integracja przez WebAssembly. Do działania w przeglądarce Ruffle kompiluje się do WebAssembly (Wasm) — niskopoziomowego kodu bajtowego wykonywanego w izolowanym środowisku przeglądarki z wydajnością zbliżoną do natywnej. Pozwala to emulatorowi na ładowanie i przetwarzanie złożonej grafiki oraz logiki Flash bez konieczności instalowania przestarzałych i niebezpiecznych wtyczek NPAPI/PPAPI.

Automatyczne wykrywanie i zastępowanie treści Flash. Wersja internetowa Ruffle zawiera detektor JavaScript, który skanuje strukturę DOM strony w poszukiwaniu elementów object, embed i applet, a także plików z rozszerzeniem .swf. Po wykryciu takich treści Ruffle automatycznie zastępuje je własnym odtwarzaczem, przejrzyście naprawiając stronę dla użytkownika i przywracając funkcjonalność elementów Flash.

Dwojaki tryb działania (aplikacja komputerowa i rozszerzenie przeglądarki). Ruffle oferuje użytkownikom elastyczność: może być używany jako samodzielna aplikacja komputerowa do odtwarzania lokalnych plików SWF (wystarczy powiązać pliki z plikiem wykonywalnym Ruffle) lub jako rozszerzenie przeglądarki, które integruje się ze środowiskiem przeglądania sieci, zapewniając obsługę Flash na dowolnej stronie.

Obsługa ActionScript 1.0 i 2.0 (AVM1). Ruffle implementuje maszynę wirtualną AVM1, zapewniając kompatybilność z ogromną ilością treści stworzonych przed 2006 rokiem i do 2013 roku. Obecny poziom zgodności dla konstrukcji języka AVM1 sięga 99%, a dla API — 81%, co gwarantuje prawidłowe działanie zdecydowanej większości wczesnych gier i animacji Flash.

Obsługa ActionScript 3.0 (AVM2). Dla treści stworzonych po 2006 roku, Ruffle zawiera implementację AVM2. Chociaż prace nad kompatybilnością są aktywnie kontynuowane, emulator zapewnia już wystarczający poziom wsparcia do uruchomienia wielu złożonych gier i aplikacji napisanych w ActionScript 3, stale rozszerzając pokrycie API i możliwości językowe.

Bezpieczeństwo na poziomie języka Rust. Jedną z głównych zalet architektonicznych Ruffle jest użycie języka Rust. Rust gwarantuje bezpieczeństwo pamięci na etapie kompilacji, całkowicie eliminując całe klasy luk, które nękały oryginalnego Adobe Flash Playera, takie jak przepełnienia bufora, podwójne zwalnianie pamięci czy błędy użycia po zwolnieniu.

Izolacja w środowisku piaskownicy przeglądarki. Działając w środowisku internetowym, Ruffle (poprzez WebAssembly) w pełni przestrzega zasad bezpieczeństwa przeglądarki. Dodaje to dodatkową warstwę izolacji: emulator nie ma bezpośredniego dostępu do systemu plików użytkownika ani innych procesów systemowych, co sprawia, że jego wykorzystanie jest niezwykle trudne w porównaniu z klasyczną wtyczką Flash.

Efektywne zarządzanie pamięcią. W przeciwieństwie do oryginalnego Flash Playera, który używał garbage collection z nieprzewidywalnymi przerwami, Ruffle dziedziczy ścisły model własności Rusta. Pozwala to na bardziej przewidywalne wykorzystanie pamięci, zmniejszając fragmentację i eliminując wycieki pamięci, które często prowadziły do niestabilnego zachowania przeglądarki.

Obsługa wiersza poleceń. Wersja komputerowa Ruffle oferuje w pełni funkcjonalny interfejs wiersza poleceń. Użytkownicy mogą uruchomić emulator z parametrami, na przykład: ruffle filename.swf dla pliku lokalnego lub ruffle https://example.com/filename.swf do odtworzenia pliku SWF z adresu URL. Polecenie ruffle --help wyświetla obszerną listę wszystkich dostępnych argumentów i ustawień.

Otwarty kod źródłowy i przejrzystość rozwoju. Ruffle jest dystrybuowany na licencjach Apache 2.0 i MIT. Całkowita otwartość kodu źródłowego oznacza, że każdy programista może dokonać audytu bezpieczeństwa emulatora, wnieść poprawki i uczestniczyć w jego rozwoju, eliminując możliwość ukrytych funkcji lub luk, które mogłyby zostać wprowadzone przez programistów korporacyjnych.

Kompatybilność z szeroką gamą przeglądarek. Dzięki technologii WebAssembly, Ruffle jest obsługiwany przez wszystkie nowoczesne przeglądarki, w tym Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave i Vivaldi. Zapewnia to spójne doświadczenie z treściami Flash niezależnie od preferencji użytkownika co do silników przeglądarek (Chromium, Gecko lub WebKit).

Obsługa przeglądarek mobilnych (iOS i Android). W przeciwieństwie do oryginalnego Adobe Flash Playera, który nigdy nie był oficjalnie obsługiwany na iOS i miał ograniczone wsparcie na Androidzie, Ruffle działa na platformach mobilnych. Pozwala to na uruchamianie gier i animacji Flash na smartfonach i tabletach bezpośrednio przez przeglądarkę mobilną, otwierając dostęp do zarchiwizowanych treści dla odbiorców mobilnych.

Brak konieczności konfiguracji. Ruffle został zaprojektowany zgodnie z zasadą "zainstaluj i zapomnij". Po zainstalowaniu rozszerzenia lub uruchomieniu aplikacji komputerowej, emulator nie wymaga skomplikowanej konfiguracji. Automatycznie wykrywa parametry odtwarzania, takie jak rozmiar sceny, liczba klatek na sekundę i typ interakcji, stosując optymalne ustawienia bez ingerencji użytkownika.

Ochrona przed lukami typu zero-day. Ponieważ Ruffle nie jest wtyczką, nie używa przestarzałych interfejsów API, a jego kod jest napisany w języku Rust z naciskiem na bezpieczeństwo, jest odporny na ataki charakterystyczne dla Adobe Flash Playera. To czyni go idealnym rozwiązaniem dla organizacji, które muszą zachować dostęp do starszych treści, ale nie mogą ryzykować naruszenia bezpieczeństwa systemu.

Kompatybilność z różnymi metodami instalacji. Ruffle oferuje kilka metod wdrożenia. Programiści internetowi mogą zainstalować go jako statyczne rozszerzenie w przeglądarkach opartych na Chromium (poprzez tryb programisty) lub jako tymczasowy dodatek w Firefoksie (poprzez about:debugging). Dostępna jest również integracja poprzez wstawienie prostego kodu JavaScript po stronie serwera.

Odtwarzanie treści online i offline. Wersja komputerowa Ruffle umożliwia otwieranie i odtwarzanie plików SWF zapisanych lokalnie na komputerze. To czyni emulator niezbędnym narzędziem dla kolekcjonerów, archiwistów i badaczy pracujących z lokalnymi archiwami gier i animacji Flash.

Wysoka wydajność renderowania. Ruffle używa nowoczesnych interfejsów API graficznych (takich jak OpenGL, Vulkan, DirectX lub WebGL) poprzez biblioteki wieloplatformowe. Zapewnia to przyspieszenie sprzętowe renderowania grafiki wektorowej i rastrowej, umożliwiając płynne odtwarzanie nawet na słabszych urządzeniach, na których oryginalny Flash Player mógł działać z przycięciami.

Aktywny rozwój i częste aktualizacje. Projekt jest aktywnie rozwijany. Wydania pojawiają się regularnie i obejmują zarówno krytyczne poprawki błędów, jak i rozszerzone wsparcie API ActionScript. Na przykład, ostatnie wersje naprawiły przypadki brzegowe w metodach String.indexOf i lastIndexOf oraz poprawnie obsługują ujemne indeksy w Array.indexOf.

Integracja z głównymi archiwami i platformami. Ruffle został wybrany jako oficjalny odtwarzacz treści Flash przez takie giganty jak Internet Archive, Newgrounds, Coolmath Games i Armor Games. Potwierdza to wysoki stopień niezawodności i kompatybilności emulatora, a także jego zdolność do działania pod dużym obciążeniem w rzeczywistych warunkach.

Obsługa zapisów stanu gry. Podobnie jak oryginalny Flash Player, Ruffle obsługuje Local Shared Objects (LSO), których wiele gier używa do zapisywania postępów. Emulator poprawnie emuluje mechanizmy odczytu i zapisu danych do tego magazynu, zapewniając integralność zapisów w czasie działania aplikacji.

Dokładna emulacja taktowania i liczby klatek na sekundę. Ruffle dokładnie emuluje wewnętrzny timer Flash Playera, co jest kluczowe dla logiki gier i animacji. Zapewnia to prawidłową synchronizację zdarzeń, dźwięku i ruchu obiektów, zapobiegając sytuacjom, w których gra działa wolniej lub szybciej niż oryginał.

Obsługa interakcji z DOM i JavaScript (ExternalInterface). Dla złożonych aplikacji internetowych, które używały API ExternalInterface do wymiany danych między ActionScript a JavaScript, Ruffle implementuje kompatybilny most. Pozwala to emulatorowi poprawnie obsługiwać wywołania funkcji i transfer danych, zachowując interaktywność treści z otaczającą stroną internetową.

Automatyczne skalowanie i adaptacja rozdzielczości. Podczas odtwarzania treści Flash stworzonych dla określonej rozdzielczości (np. 800x600), Ruffle automatycznie stosuje algorytmy skalowania, aby dostosować się do bieżącego rozmiaru okna przeglądarki lub aplikacji komputerowej. Zachowuje proporcje i jakość obrazu oraz poprawnie obsługuje obszary interakcji myszy.

Obsługa różnorodnych formatów multimediów. Emulator obsługuje dekodowanie różnych formatów multimedialnych, które mogą być osadzone w plikach SWF, w tym MP3 do kompresji dźwięku i wideo używane w późniejszych wersjach Flash. Dekodowanie jest wykonywane za pomocą wydajnych bibliotek napisanych w języku Rust, co zmniejsza obciążenie systemu.

Zaawansowane debugowanie i rejestrowanie zdarzeń. Dla programistów i zaawansowanych użytkowników, Ruffle zapewnia możliwość włączenia szczegółowych logów działania maszyn wirtualnych AVM1/AVM2. Pozwala to diagnozować problemy ze zgodnością, śledzić błędy w kodzie ActionScript i zrozumieć wewnętrzne procesy emulacji w celu dokładniejszego dostrojenia.

Emulacja kursora i elementów interaktywnych. Ruffle poprawnie obsługuje zmiany stylu kursora określone przez treść Flash. Na przykład, dla elementów interaktywnych takich jak LoaderDisplay, emulator automatycznie zmienia standardowy kursor na wskaźnik, naśladując zachowanie oryginalnego odtwarzacza Flash i zapewniając użytkownikowi znajomą nawigację.

Obsługa nocnych kompilacji dla wczesnego dostępu. Oprócz stabilnych wydań, zespół Ruffle zapewnia dostęp do codziennych, eksperymentalnych kompilacji Nightly. Te kompilacje zawierają najnowsze poprawki i innowacje, które nie zostały jeszcze uwzględnione w stabilnej wersji.

Zachowanie cyfrowego dziedzictwa kulturowego. To nie tylko funkcja techniczna, ale fundamentalny cel projektu. Ruffle został stworzony jako narzędzie do zachowania historycznych treści internetowych. Dzięki możliwości pracy w nowoczesnych przeglądarkach bez naruszania bezpieczeństwa, miliony gier Flash, animacji i aplikacji, które zostałyby bezpowrotnie utracone po wycofaniu Adobe Flash Playera, pozostają dostępne dla przyszłych pokoleń.

12 mniej znanych możliwości technicznych Ruffle

  1. Użycie WGPU jako głównego backendu renderowania. W przeciwieństwie do wielu emulatorów, które opierają się na przestarzałym OpenGL, Ruffle używa biblioteki WGPU — nowoczesnego, bezpiecznego i wieloplatformowego API graficznego. Na komputerze WGPU automatycznie wybiera najbardziej optymalny niskopoziomowy backend: Vulkan, DirectX 12 lub Metal. W przeglądarce może działać przez WebGPU (tam, gdzie jest dostępne) lub emulować działanie przez WebGL z minimalną utratą wydajności.

  2. Obsługa WebGPU w przeglądarce dla maksymalnej wydajności. Dla użytkowników nowoczesnych przeglądarek (np. najnowsze wersje Chrome i Edge), Ruffle może używać najnowocześniejszego interfejsu API WebGPU. Zapewnia to znacznie skrócony czas kompilacji shaderów i mniejsze obciążenie w porównaniu ze standardowym backendem WebGL, co jest kluczowe dla złożonej grafiki 3D i aplikacji Stage3D.

  3. Drobnoziarniste dostrajanie backendu renderowania (canvas, webgl, wgpu-webgl). Niewiele osób wie, że zachowanie renderowania można kontrolować ręcznie. Oprócz standardowego wgpu-webgl, istnieje możliwość wymuszenia włączenia:

    • webgl — klasyczny backend, który inicjuje się szybciej i może być przydatny dla prostych treści, które nie wymagają złożonych efektów bitmapowych.

    • canvas — najwolniejszy, ale najdokładniejszy backend. Jest to jedyny, który poprawnie skaluje cienkie linie w grafice wektorowej, które przy użyciu przyspieszenia sprzętowego mogą wydawać się zbyt grube.

  4. Emulacja Stage3D i kompilacja AGAL do WGSL. Ruffle obsługuje nie tylko grafikę 2D, ale także akcelerację 3D poprzez API Stage3D (Context3D). Shadery napisane w AGAL (Adobe Graphics Assembly Language) są kompilowane "w locie" do nowoczesnego WGSL (WebGPU Shading Language) lub GLSL. Pozwala to na uruchamianie złożonych gier i aplikacji 3D stworzonych dla Flash Playera 11 i wyższych, wykorzystujących pełny potok programowalnych shaderów.

  5. Obsługa fscommand dla zachowania kompatybilności wstecznej. Ruffle zachował obsługę starszego, ale ważnego mechanizmu fscommand. Pozwala to starym filmom Flash (stworzonym przed ExternalInterface) na interakcję z JavaScript na stronie, wysyłając dowolne polecenia i argumenty. W nowoczesnej implementacji Ruffle, te polecenia są przetwarzane przez onFSCommand, umożliwiając działanie nawet bardzo starej zawartości internetowej.

  6. Podwójne buforowanie dla Context3D. Podczas pracy z treściami 3D, Ruffle używa wyrafinowanego mechanizmu podwójnego buforowania (bufor tylny / bufor przedni). Jest to standardowa, ale krytycznie ważna technika wydajnościowa, pozwalająca na renderowanie następnej klatki w buforze tła, podczas gdy bieżąca jest wyświetlana na ekranie, eliminując artefakty wizualne (zerwanie klatek) w dynamicznych grach.

  7. Narzędzia do testowania wydajności: ruffle_scanner i exporter. W repozytorium Ruffle znajdują się narzędzia pomocnicze, które nie są dołączone do standardowej kompilacji, ale są dostępne dla programistów:

    • ruffle_scanner — umożliwia testowanie kompatybilności emulatora z całym folderem plików SWF, generując raport CSV o powodzeniu parsowania.

    • exporter — narzędzie do wsadowego generowania zrzutów ekranu PNG z plików SWF, które może działać w trybie bezgłowym (bez GUI), przydatne do automatycznych testów i tworzenia podglądów.

  8. Całkowita izolacja poprzez piaskownicę Flatpak. Dla użytkowników Linuksa dostępna jest oficjalna kompilacja Ruffle w formacie Flatpak. To nie tylko metoda instalacji, ale dodatkowa warstwa bezpieczeństwa: aplikacja działa w izolowanym środowisku, gdzie wszystkie zapisy, konfiguracje i logi są przechowywane ściśle w katalogu domowym Flatpak (~/.var/app/rs.ruffle.Ruffle/), bez dostępu do reszty systemu.

  9. Wsparcie integracji przez Homebrew i Scoop. Dla zaawansowanych użytkowników, Ruffle oferuje zaawansowane metody instalacji poza ręcznym pobieraniem. Na macOS można go zainstalować przez Homebrew (brew install --HEAD ruffle-rs/ruffle/ruffle), co pozwala na automatyczne aktualizacje do najnowszej nocnej kompilacji. W systemie Windows podobną funkcję pełni menedżer pakietów Scoop.

  10. Przejrzysty system przechowywania danych (SharedObjects). Ruffle dokładnie emuluje lokalny system przechowywania Flash (LSO — Local Shared Objects). Jednak w przeciwieństwie do zastrzeżonego odtwarzacza, lokalizacja tych plików jest ustandaryzowana i przejrzysta dla użytkownika. W systemie Windows znajdują się w %AppData%\Local\Ruffle\SharedObjects\, w Linux — w ~/.local/share/ruffle/SharedObjects/. Pozwala to na ręczne tworzenie kopii zapasowych zapisów ze starych gier.

  11. Konfiguracja przez API JavaScript i ustawienia globalne. Dla programistów internetowych, Ruffle udostępnia potężne API JavaScript, pozwalające nie tylko na osadzenie odtwarzacza, ale także na kontrolowanie jego stanu. Dostępne są metody do programowego ładowania SWF (load), kontrolowania głośności (volume), wstrzymywania (suspend/resume) oraz przechwytywania danych wyjściowych trace() z ActionScript w celu debugowania poprzez traceObserver.

  12. Automatyczne podpisywanie i notarialne poświadczanie kompilacji dla macOS. W procesie CI/CD, wszystkie nocne kompilacje Ruffle dla macOS przechodzą podpisywanie kodu i notarialne poświadczenie przez Apple. Oznacza to, że nawet niestabilne wersje emulatora nie zostaną zablokowane przez Gatekeeper jako niebezpieczne oprogramowanie, zapewniając bezproblemowe działanie na najnowszych wersjach macOS, gdzie wymagania bezpieczeństwa są surowe.

Instalacja wersji komputerowej Ruffle

Wersja komputerowa Ruffle to natywna aplikacja, która umożliwia otwieranie i odtwarzanie plików SWF bezpośrednio na komputerze, bez potrzeby korzystania z przeglądarki. Jest to idealny wybór do przeglądania lokalnych archiwów gier i animacji Flash.

Windows (10, 11)

Metoda 1: Interfejs graficzny (zalecana)

  1. Pobierz plik o nazwie ruffle-windows-x86_64.zip (dla systemów 64-bitowych) lub ruffle-windows-x86.zip (dla systemów 32-bitowych).

  2. Wypakuj zawartość archiwum do dowolnego wygodnego folderu (np. C:\Program Files\Ruffle lub C:\Users\[Twoja_Nazwa_Użytkownika]\Documents\Ruffle).

  3. Aby go uruchomić, kliknij dwukrotnie plik wykonywalny ruffle.exe. Otworzy się interfejs graficzny aplikacji.

  4. Aby otworzyć plik SWF, kliknij przycisk Open File w interfejsie lub po prostu przeciągnij i upuść plik SWF do okna aplikacji.

  5. Alternatywna metoda: Skonfiguruj skojarzenie plików. Kliknij prawym przyciskiem myszy dowolny plik .swf, wybierz Otwórz przez → Wybierz inną aplikację, znajdź ruffle.exe i zaznacz opcję Zawsze używaj tej aplikacji do otwierania plików .swf.

Metoda 2: Wiersz poleceń

Dla zaawansowanych użytkowników dostępny jest interfejs wiersza poleceń:

  1. Otwórz Wiersz Poleceń (CMD) lub PowerShell.

  2. Przejdź do folderu zawierającego ruffle.exe lub dodaj ten folder do zmiennej środowiskowej PATH.

  3. Aby uruchomić plik lokalny, wykonaj polecenie:

    ruffle.exe C:\ścieżka\do\twojego\pliku.swf

  4. Aby uruchomić plik SWF z adresu URL:

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

  5. Aby wyświetlić wszystkie dostępne parametry wiersza poleceń:

    ruffle.exe --help

Metoda 3: Instalacja przez menedżer pakietów Scoop

Dla tych, którzy preferują zautomatyzowaną instalację:

scoop bucket add extras
scoop install ruffle

macOS

Metoda 1: Interfejs graficzny (zalecana)

  1. Pobierz plik ruffle-macos-x86_64.dmg lub ruffle-macos-aarch64.dmg (dla Apple Silicon M1/M2/M3) ze strony wydań.

  2. Otwórz pobrany plik .dmg.

  3. Przeciągnij ikonę Ruffle do folderu Aplikacje.

  4. Uruchom Ruffle z folderu Aplikacje. Przy pierwszym uruchomieniu system może poprosić o potwierdzenie — kliknij Otwórz.

  5. Po uruchomieniu aplikacji użyj przycisku Open File lub przeciągnij i upuść plik SWF do okna.

Metoda 2: Instalacja przez Homebrew

Dla zaawansowanych użytkowników:

# Zainstaluj najnowszą stabilną wersję (jeśli dostępna)
brew install ruffle

# Lub zainstaluj najnowszą nocną kompilację ze źródła
brew install --HEAD ruffle-rs/ruffle/ruffle

Metoda 3: Wiersz poleceń

Po instalacji przez Homebrew lub ręcznym umieszczeniu ruffle w /usr/local/bin:

ruffle ~/Pobrane/gry.swf
ruffle https://example.com/gry.swf

Linux

Metoda 1: Instalacja przez Flatpak (zalecana dla izolacji)

Flatpak zapewnia maksymalne bezpieczeństwo, uruchamiając Ruffle w izolowanej piaskownicy:

# Dodaj repozytorium Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Zainstaluj Ruffle
flatpak install flathub rs.ruffle.Ruffle

# Uruchom
flatpak run rs.ruffle.Ruffle

Metoda 2: Instalacja przez AppImage (bez instalacji)

  1. Pobierz plik ruffle-x86_64.AppImage ze strony wydań.

  2. Uczyń plik wykonywalnym:

    chmod +x ruffle-x86_64.AppImage

  3. Uruchom go przez dwukrotne kliknięcie lub w terminalu:

    ./ruffle-x86_64.AppImage

Metoda 3: Instalacja ręczna (dla dystrybucji opartych na Debianie/Ubuntu)

  1. Pobierz ruffle-linux-x86_64.tar.gz (lub ruffle-linux-armv7.tar.gz dla urządzeń ARM, takich jak Raspberry Pi).

  2. Wypakuj archiwum:

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

  3. Skopiuj plik wykonywalny do katalogu systemowego:

    sudo cp ruffle /usr/local/bin/

  4. Uruchom z terminala:

    ruffle

Instalacja Ruffle jako rozszerzenia przeglądarki

Rozszerzenie Ruffle automatycznie wykrywa treści Flash na dowolnej stronie internetowej i zastępuje je emulatorem.

Ważna uwaga

Obecnie rozszerzenie nie jest hostowane w oficjalnych sklepach z rozszerzeniami (Chrome Web Store, Firefox Add-ons) i jest aktywnie rozwijane. Instalacja odbywa się ręcznie, poprzez tryb programisty przeglądarki.

Instalacja w Google Chrome i przeglądarkach opartych na Chromium

Obsługiwane przeglądarki: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc i inne oparte na Chromium.

Instrukcja krok po kroku:

  1. Przejdź do strony wydań Ruffle na GitHub.

  2. Pobierz archiwum o nazwie ruffle-chromium.zip (lub podobne zawierające chromium).

  3. Wypakuj archiwum do stałego folderu na komputerze. Ważne: Nie usuwaj tego folderu po instalacji, ponieważ przeglądarka będzie mieć do niego dostęp, aby rozszerzenie działało. Zalecane lokalizacje:

    • Windows: C:\Users\[Twoja_Nazwa_Użytkownika]\AppData\Local\Ruffle\

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

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

  4. Otwórz przeglądarkę i wpisz w pasku adresu:

    chrome://extensions/

  5. W prawym górnym rogu strony włącz Tryb programisty.

  6. Kliknij przycisk Załaduj rozpakowane.

  7. W otwartym oknie dialogowym wybierz folder, do którego wypakowałeś archiwum ruffle-chromium.zip i kliknij Wybierz folder.

  8. Rozszerzenie jest zainstalowane. Teraz, podczas odwiedzania stron z treściami Flash, Ruffle uruchomi się automatycznie.

Dla Microsoft Edge (Chromium): Proces jest identyczny jak dla Chrome. Użyj edge://extensions/ zamiast chrome://extensions/ i włącz tryb programisty.

Instalacja w Mozilla Firefox

Ważne: W przeglądarce Firefox rozszerzenie instaluje się tylko tymczasowo i zostanie usunięte po ponownym uruchomieniu przeglądarki. Jest to ograniczenie Firefoksa dla niepodpisanych rozszerzeń. Do stałego użytku zaleca się używanie wersji komputerowej lub oczekiwanie na publikację w oficjalnym sklepie.

Instrukcja krok po kroku:

  1. Przejdź do strony wydań Ruffle na GitHub.

  2. Pobierz plik o nazwie ruffle-firefox.xpi. Podczas pobierania wybierz Zapisz plik.

  3. W przeglądarce Firefox wpisz w pasku adresu:

    about:debugging

  4. W lewym pasku bocznym wybierz Ta przeglądarka Firefox.

  5. Kliknij przycisk Załaduj dodatek tymczasowy….

  6. W oknie dialogowym plików wybierz pobrany plik ruffle-firefox.xpi i kliknij Otwórz.

  7. Rozszerzenie zostanie załadowane i aktywowane. Będzie działać do momentu zamknięcia przeglądarki.

Wskazówka: Jeśli używasz Firefox Nightly lub Developer Edition, możesz wyłączyć weryfikację podpisów rozszerzeń poprzez about:config, co umożliwia stałą instalację, ale nie jest to zalecane do codziennego użytku ze względów bezpieczeństwa.

Instalacja w Safari (macOS)

Instalacja rozszerzenia Ruffle w Safari wymaga dodatkowych kroków ze względu na politykę bezpieczeństwa Apple.

  1. Pobierz plik ruffle-safari.zip ze strony wydań.

  2. Wypakuj archiwum.

  3. Uruchom plik Ruffle.app z wypakowanego folderu. Spowoduje to zainstalowanie rozszerzenia w systemie.

  4. Otwórz Safari, przejdź do Safari → Ustawienia → zakładka Rozszerzenia.

  5. Upewnij się, że przełącznik obok Ruffle jest w pozycji Włączony.

  6. Rozszerzenie jest aktywowane i będzie działać z treściami Flash na stronach internetowych.

Instalacja Ruffle na stronie internetowej (dla webmasterów)

Jeśli jesteś właścicielem strony internetowej, która hostuje treści Flash, możesz zintegrować Ruffle bezpośrednio z kodem swojej strony. Umożliwi to odwiedzającym Twoją witrynę automatyczne odtwarzanie treści Flash bez instalowania żadnych rozszerzeń.

Najprostsza metoda: Użycie odtwarzacza JavaScript

  1. Pobierz plik ruffle.js oraz folder z zasobami ruffle ze strony wydań.

  2. Prześlij te pliki na swój serwer (np. do folderu takiego jak /js/ruffle/).

  3. Dodaj następujący kod do sekcji <head> każdej strony, na której znajdują się treści Flash:

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Ustawienia odtwarzacza
        autoplay: "auto", // "on", "off" lub "auto"
        splashScreen: false, // Wyłącz ekran powitalny
    };
</script>

  1. Ruffle automatycznie wykryje wszystkie elementy object, embed i applet na stronie i zastąpi je swoim odtwarzaczem.

Zaawansowana konfiguracja przez CDN (bez pobierania plików)

Do szybkiego testowania możesz użyć CDN:

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

Ręczna inicjalizacja dla dynamicznie ładowanych treści:

Jeśli pliki SWF są dodawane do strony dynamicznie (poprzez JavaScript), możesz ręcznie zainicjować odtwarzacz:

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("ścieżka/do/twojego/pliku.swf");
document.body.appendChild(player);

Weryfikacja działania

Po zainstalowaniu Ruffle dowolną metodą możesz sprawdzić jego działanie:

  1. Wersja komputerowa: Po prostu otwórz dowolny plik SWF.

  2. Rozszerzenie przeglądarki: Odwiedź kolekcję gier Flash w Internet Archive lub dowolną stronę ze znanymi treściami Flash. Jeśli element Flash wyświetla się i działa, Ruffle działa poprawnie.

  3. Diagnostyka: W przeglądarce naciśnij F12, aby otworzyć narzędzia deweloperskie. W konsoli zobaczysz komunikaty z Ruffle potwierdzające jego aktywację.

Rozwiązywanie typowych problemów

Problem Możliwe rozwiązanie
Rozszerzenie nie aktywuje się na stronie Upewnij się, że strona nie jest zablokowana w ustawieniach rozszerzenia. Sprawdź, czy tryb programisty jest włączony w chrome://extensions/.
Plik SWF nie odtwarza się lub pokazuje biały ekran Bieżąca wersja Ruffle może nie obsługiwać tego konkretnego pliku SWF. Sprawdź, czy treść jest w formacie AVM2 (ActionScript 3), którego obsługa jest wciąż udoskonalana.
Nie można otworzyć pliku w wersji komputerowej Upewnij się, że plik nie jest uszkodzony. Spróbuj otworzyć go z wiersza poleceń z flagą --verbose, aby uzyskać szczegółowe logi błędów.
Rozszerzenie zniknęło po ponownym uruchomieniu Firefoksa Jest to normalne zachowanie dla tymczasowych rozszerzeń. Użyj wersji komputerowej lub poczekaj na oficjalną publikację w sklepie z dodatkami.
Niska wydajność w przeglądarce Spróbuj zmienić backend renderowania w ustawieniach rozszerzenia. Dla przeglądarek Chromium sprawdź również, czy akceleracja sprzętowa jest włączona w ustawieniach przeglądarki.