Repository navigation
Releases
Retro Launcher 2.2.0
Retro Launcher 2.2.0 — IGDB replaces RAWG.
-
Descriptions, genres, release year and critic score now come from
IGDB (Twitch): Client ID + Client Secret in Settings -> Artwork,
with built-in step-by-step instructions. -
Smart matching handles IGDB duplicate entries (arcade, port,
remaster, edition) by platform, canonical slug and data quality. -
IGDB covers are downloaded and cached locally.
-
TheGamesDB stays as the fallback source; old RAWG keys are left
untouched in the config. -
Includes the 2.1.1 fixes: returning to the launcher after a game
and the gamepad stop combo (L3 + R3 + LB + RB). -
Linux:
.deb(Debian / Ubuntu / Mint) and portable.AppImage -
Windows: NSIS installer (WebView2 handled automatically)
-
Existing 1.x/2.1 configuration in
~/.config/retro-launcheris preserved.
Full Changelog: rel/2.1.1...rel/2.2.0
Retro Launcher 2.1.1
Retro Launcher 2.1.1 — bugfix release.
-
Fixed returning to the launcher after closing a game (application
state was never registered, so the launcher aborted on launch). -
Gamepad stop combo (L3 + R3 + LB + RB) now works for the whole
game session and survives pad reconnects. -
Stop shortcut unified between the UI and the renderer.
-
Linux:
.deb(Debian / Ubuntu / Mint) and portable.AppImage -
Windows: NSIS installer (WebView2 handled automatically)
-
Existing 1.x/2.1 configuration in
~/.config/retro-launcheris preserved.
Full Changelog: rel/2.1...rel/2.1.1
Retro Launcher 2.1.0
Retro Launcher 2.1.0 — rebuilt on Tauri 2.
- Linux:
.deb(Debian / Ubuntu / Mint) and portable.AppImage - Windows: NSIS installer (WebView2 handled automatically)
- Existing 1.x configuration in
~/.config/retro-launcheris preserved.
Full Changelog: rel/1.1...rel/2.1
Retro Launcher 1.1.0
Retro Launcher
Language / Język: Polski | English
Polski
Retro Launcher to desktopowy launcher gier retro inspirowany trybem Steam Big Picture. Aplikacja działa w Electronie, obsługuje pada, pełny ekran, bibliotekę ROM-ów dla wielu platform, ręczne i automatyczne okładki oraz trwały zapis konfiguracji emulatorów na dysku.
Co potrafi
- Przegląda bibliotekę gier w widoku kanapy, z nawigacją klawiaturą i padem.
- Obsługuje wiele platform jednocześnie, każdą z własnym folderem ROM-ów, emulatorem i argumentami startowymi.
- Uruchamia gry przez skonfigurowane emulatory.
- Pozwala testować polecenie uruchomieniowe emulatora z poziomu ustawień.
- Pobiera okładki i opisy z SteamGridDB po wpisaniu klucza API.
- Pozwala ręcznie ustawić okładkę gry przez URL albo plik lokalny.
- Zapamiętuje ustawienia użytkownika, platformy, ścieżki ROM-ów, emulatory, argumenty, okładki i preferencje widoku.
- Obsługuje pełny ekran przy starcie oraz przełączanie fullscreen w trakcie pracy.
- Ma efekty dźwiękowe UI, animowane tło i obsługę kilku trybów widoku półki z grami.
- Działa z bezpiecznym mostkiem preload/IPC między rendererem a main process.
Dla kogo
Projekt jest przeznaczony dla osób, które chcą mieć jeden interfejs do uruchamiania gier retro z różnych emulatorów, najlepiej z poziomu kanapy, kontrolera albo mini-PC pod telewizorem.
Szybki start
- Uruchom aplikację.
- Otwórz zakładkę Ustawienia.
- Dodaj platformę albo użyj już istniejących wpisów.
- Dla każdej platformy ustaw:
- folder z ROM-ami,
- polecenie uruchomieniowe emulatora,
- opcjonalne argumenty startowe,
- typ okładki.
- Zapisz ustawienia.
- Wróć do biblioteki i wybierz grę.
- Uruchom grę przyciskiem
Uruchomalbo padem.
Jak działa konfiguracja platform
Każda platforma może mieć własny zestaw ustawień:
- nazwę i identyfikator,
- kolor wyróżnienia,
- listę rozszerzeń ROM-ów,
- folder z ROM-ami,
- emulator lub komendę uruchomieniową,
- domyślne argumenty,
- preferowany format okładki.
Dzięki temu można osobno skonfigurować np. PSP, PS2, PS1, SNES, DS albo inne systemy.
Okładki i metadane
Launcher wspiera dwa sposoby zarządzania grafikami:
Automatyczne
Po wpisaniu klucza SteamGridDB API można pobierać:
- okładki,
- opisy,
- dodatkowe dane dla gier.
Pobieranie można wykonać dla jednej platformy albo dla wszystkich naraz.
Ręczne
Dla każdej gry można ręcznie ustawić okładkę przez:
- adres URL,
- lokalny plik z dysku.
Można też usunąć ręczną okładkę i wrócić do automatycznej.
Obsługa pada
Launcher jest przygotowany do używania kontrolera jako głównej metody nawigacji.
- Lewo/prawo, D-pad lub analog: przełączanie gier.
- Góra: otwarcie listy platform.
- LB / RB: szybka zmiana platformy.
- LT / RT: zmiana trybu widoku półki.
- A: uruchomienie gry albo zatwierdzenie wyboru.
- Y: otwarcie szczegółów gry.
- B: powrót lub zamknięcie aktywnego panelu.
- Start: otwarcie ustawień.
Klawiatura
Strzałka w lewo/Strzałka w prawo: przełączanie gier.Enter: uruchomienie wybranej gry.Esc: zamknięcie modala albo powrót z ustawień.F11lubAlt+Enter: przełączenie pełnego ekranu.
Gdzie zapisują się ustawienia
Konfiguracja jest zapisywana trwale w pliku JSON w katalogu danych użytkownika systemu. Obejmuje to między innymi:
- platformy,
- ścieżki do ROM-ów,
- emulatory,
- argumenty uruchomieniowe,
- ustawienia interfejsu,
- ręczne okładki,
- część metadanych.
Przykładowe lokalizacje:
- Windows:
%APPDATA%/retro-launcher - Linux: katalog
userDataElectron dla aplikacji
Testowanie emulatora
W ustawieniach każdej platformy można użyć przycisku Testuj, aby sprawdzić, czy polecenie emulatora uruchamia się poprawnie. To ułatwia diagnozowanie problemów zanim użytkownik spróbuje uruchomić konkretną grę.
Flatpak i Linux
Przy uruchamianiu w Flatpaku niektóre emulatory lub foldery spoza sandboxa mogą wymagać dodatkowych uprawnień. Jeśli emulator działa na hoście, a launcher jest zamknięty w sandboxie, może być potrzebne uruchamianie przez flatpak-spawn --host albo nadanie dostępu do systemu plików.
Najczęstszy scenariusz użycia
- Dodanie platformy, na przykład PSP.
- Wskazanie folderu z ROM-ami.
- Ustawienie emulatora, na przykład PPSSPP.
- Opcjonalne ustawienie argumentów typu fullscreen.
- Pobranie okładek z API albo ręczne podpięcie grafik.
- Nawigacja po bibliotece z poziomu pada.
- Uruchamianie gier z jednego, spójnego interfejsu.
Rozwiązywanie problemów
Emulator się nie uruchamia
Sprawdź:
- czy ścieżka lub komenda emulatora jest poprawna,
- czy emulator uruchamia się ręcznie poza launcherem,
- czy argumenty startowe są poprawne,
- czy przycisk
Testujdziała dla danej platformy.
Nie widać okładki
Sprawdź:
- czy URL jest poprawny,
- czy lokalny plik istnieje,
- czy aplikacja ma dostęp do pliku,
- czy dla Linux/Flatpak nie brakuje uprawnień do odczytu plików.
Status projektu
Projekt rozwija launcher typu couch-gaming UI dla emulatorów i bibliotek ROM-ów, z naciskiem na prostą obsługę, sterowanie padem i szybkie uruchamianie gier.
Wersja 1.1.0
- Naprawienie focusowania po włączeniu emu (minimalizacja launchera i powrót po zamknięciu emu).
- Dodanie skanowania plików w subfolderach.
- Dodanie możliwości zmiany nazwy konkretnej gry.
- Dodano grid do widoków.
- Dodano skrót klawiszowy do powrotu do menu (pad).
- Dodano przełącznik językowy Angielski/Polski
English
Retro Launcher is a desktop launcher for retro games, inspired by Steam's Big Picture mode. The app runs on Electron, supports gamepads, fullscreen mode, a ROM library for multiple platforms, manual and automatic cover art, and persistent on-disk storage of emulator configurations.
What it can do
- Browse your game library in a couch-mode view, with keyboard and gamepad navigation.
- Support multiple platforms simultaneously, each with its own ROM folder, emulator, and launch arguments.
- Launch games through configured emulators.
- Test the emulator launch command directly from the settings panel.
- Fetch cover art and descriptions from SteamGridDB after entering an API key.
- Manually set a game's cover art via URL or a local file.
- Remember user settings, platforms, ROM paths, emulators, arguments, cover art, and view preferences.
- Support fullscreen on startup as well as toggling fullscreen while running.
- Include UI sound effects, an animated background, and several shelf view modes for games.
- Use a secure preload/IPC bridge between the renderer and the main process.
Who it's for
The project is designed for people who want a single interface to launch retro games from different emulators, ideally from the couch, using a controller, or from a mini-PC connected to a TV.
Quick start
- Launch the app.
- Open the Settings tab.
- Add a platform or use an existing entry.
- For each platform, set:
- the ROM folder,
- the emulator launch command,
- optional startup arguments,
- the cover art type.
- Save the settings.
- Return to the library and select a game.
- Launch the game with the
Runbutton or the gamepad.
How platform configuration works
Each platform can have its own set of settings:
- name and identifier,
- highlight color,
- list of ROM file extensions,
- ROM folder,
- emulator or launch command,
- default arguments,
- preferred cover art format.
This lets you configure systems like PSP, PS2, PS1, SNES, DS, or others independently.
Cover art and metadata
The launcher supports two ways of managing artwork:
Automatic
After entering a SteamGridDB API key, you can fetch:
- cover art,
- descriptions,
- additional game data.
Fetching can be run for a single platform or for all platforms at once.
Manual
For each game, you can manually set cover art via:
- a URL,
- a local file from disk.
You can also remove a manual cover and revert to the automatic one.
Gamepad support
The launcher is built with a controller as the primary navigation method.
- Left/right, D-pad or analog stick: switch between games.
- Up: open the platform list.
- LB / RB: quickly switch platforms.
- LT / RT: change shelf view mode.
- A: launch the game or confirm a selection.
- Y: open game details.
- B: go back or close the active panel.
- Start: open settings.
Keyboard
Left arrow/Right arrow: switch between games.Enter: launch the selected game.Esc: close a modal or go back from settings.F11orAlt+Enter: toggle fullscreen.
Where settings are saved
The configuration is stored persistently in a JSON file inside the system's user data directory. This includes, among other things:
- platforms,
- ROM paths,
- emulators,
- launch arguments,
- interface settings,
- manual cover art,
- some metadata.
Example locations:
- Windows:
%APPDATA%/retro-launcher - Linux: Electron's
userDatadirectory for the app
Testing the emulator
In each platform's settings, you can use the Test button to check whether the emulator command launches correctly. This makes it easier to diagnose problems before trying to run a specific game.
Flatpak and Linux
When running inside Flatpak, some emulators or folders outside the sandbox may require additional permissions. If the emulator runs on the host while the launcher is confined to the sandbox, you may need to run it via flatpak-spawn --host or grant filesystem access.
Most common usage scenario
- Ad...
Retro Laucher 1.0
Retro Launcher
Retro Launcher to desktopowy launcher gier retro inspirowany trybem Steam Big Picture. Aplikacja działa w Electronie, obsługuje pada, pełny ekran, bibliotekę ROM-ów dla wielu platform, ręczne i automatyczne okładki oraz trwały zapis konfiguracji emulatorów na dysku.
Co potrafi
- Przegląda bibliotekę gier w widoku kanapy, z nawigacją klawiaturą i padem.
- Obsługuje wiele platform jednocześnie, każdą z własnym folderem ROM-ów, emulatorem i argumentami startowymi.
- Uruchamia gry przez skonfigurowane emulatory.
- Pozwala testować polecenie uruchomieniowe emulatora z poziomu ustawień.
- Pobiera okładki i opisy z SteamGridDB po wpisaniu klucza API.
- Pozwala ręcznie ustawić okładkę gry przez URL albo plik lokalny.
- Zapamiętuje ustawienia użytkownika, platformy, ścieżki ROM-ów, emulatory, argumenty, okładki i preferencje widoku.
- Obsługuje pełny ekran przy starcie oraz przełączanie fullscreen w trakcie pracy.
- Ma efekty dźwiękowe UI, animowane tło i obsługę kilku trybów widoku półki z grami.
- Działa z bezpiecznym mostkiem preload/IPС między rendererem a main process.
Dla kogo
Projekt jest przeznaczony dla osób, które chcą mieć jeden interfejs do uruchamiania gier retro z różnych emulatorów, najlepiej z poziomu kanapy, kontrolera albo mini-PC pod telewizorem.
Szybki start
- Uruchom aplikację.
- Otwórz zakładkę Ustawienia.
- Dodaj platformę albo użyj już istniejących wpisów.
- Dla każdej platformy ustaw:
- folder z ROM-ami,
- polecenie uruchomieniowe emulatora,
- opcjonalne argumenty startowe,
- typ okładki.
- Zapisz ustawienia.
- Wróć do biblioteki i wybierz grę.
- Uruchom grę przyciskiem
Uruchomalbo padem.
Jak działa konfiguracja platform
Każda platforma może mieć własny zestaw ustawień:
- nazwę i identyfikator,
- kolor wyróżnienia,
- listę rozszerzeń ROM-ów,
- folder z ROM-ami,
- emulator lub komendę uruchomieniową,
- domyślne argumenty,
- preferowany format okładki.
Dzięki temu można osobno skonfigurować np. PSP, PS2, PS1, SNES, DS albo inne systemy.
Okładki i metadane
Launcher wspiera dwa sposoby zarządzania grafikami:
Automatyczne
Po wpisaniu klucza SteamGridDB API można pobierać:
- okładki,
- opisy,
- dodatkowe dane dla gier.
Pobieranie można wykonać dla jednej platformy albo dla wszystkich naraz.
Ręczne
Dla każdej gry można ręcznie ustawić okładkę przez:
- adres URL,
- lokalny plik z dysku.
Można też usunąć ręczną okładkę i wrócić do automatycznej.
Obsługa pada
Launcher jest przygotowany do używania kontrolera jako głównej metody nawigacji.
- Lewo/prawo, D-pad lub analog: przełączanie gier.
- Góra: otwarcie listy platform.
- LB / RB: szybka zmiana platformy.
- LT / RT: zmiana trybu widoku półki.
- A: uruchomienie gry albo zatwierdzenie wyboru.
- Y: otwarcie szczegółów gry.
- B: powrót lub zamknięcie aktywnego panelu.
- Start: otwarcie ustawień.
Klawiatura
Strzałka w lewo/Strzałka w prawo: przełączanie gier.Enter: uruchomienie wybranej gry.Esc: zamknięcie modala albo powrót z ustawień.F11lubAlt+Enter: przełączenie pełnego ekranu.
Gdzie zapisują się ustawienia
Konfiguracja jest zapisywana trwale w pliku JSON w katalogu danych użytkownika systemu. Obejmuje to między innymi:
- platformy,
- ścieżki do ROM-ów,
- emulatory,
- argumenty uruchomieniowe,
- ustawienia interfejsu,
- ręczne okładki,
- część metadanych.
Przykładowe lokalizacje:
- Windows:
%APPDATA%/retro-launcher - Linux: katalog
userDataElectron dla aplikacji
Testowanie emulatora
W ustawieniach każdej platformy można użyć przycisku Testuj, aby sprawdzić, czy polecenie emulatora uruchamia się poprawnie. To ułatwia diagnozowanie problemów zanim użytkownik spróbuje uruchomić konkretną grę.
Flatpak i Linux
Przy uruchamianiu w Flatpaku niektóre emulatory lub foldery spoza sandboxa mogą wymagać dodatkowych uprawnień. Jeśli emulator działa na hoście, a launcher jest zamknięty w sandboxie, może być potrzebne uruchamianie przez flatpak-spawn --host albo nadanie dostępu do systemu plików.
Najczęstszy scenariusz użycia
- Dodanie platformy, na przykład PSP.
- Wskazanie folderu z ROM-ami.
- Ustawienie emulatora, na przykład PPSSPP.
- Opcjonalne ustawienie argumentów typu fullscreen.
- Pobranie okładek z API albo ręczne podpięcie grafik.
- Nawigacja po bibliotece z poziomu pada.
- Uruchamianie gier z jednego, spójnego interfejsu.
Rozwiązywanie problemów
Emulator się nie uruchamia
Sprawdź:
- czy ścieżka lub komenda emulatora jest poprawna,
- czy emulator uruchamia się ręcznie poza launcherem,
- czy argumenty startowe są poprawne,
- czy przycisk
Testujdziała dla danej platformy.
Nie widać okładki
Sprawdź:
- czy URL jest poprawny,
- czy lokalny plik istnieje,
- czy aplikacja ma dostęp do pliku,
- czy dla Linux/Flatpak nie brakuje uprawnień do odczytu plików.
Status projektu
Projekt rozwija launcher typu couch-gaming UI dla emulatorów i bibliotek ROM-ów, z naciskiem na prostą obsługę, sterowanie padem i szybkie uruchamianie gier.