RecompLauncher README

README проекта с github.com/elripalda/RecompLauncher. Одним файлом markdown: README.md.

RecompLauncher: PC recomps, all in one place.

Download the beta · recomplauncher.com · Discord

Stars Downloads Latest version


RecompLauncher finds, installs, updates and plays PC recomps: native PC versions of console games, made by their developers from the original game. You bring your own copy of the game and the launcher sets it up.

What's in it

A look around

Home

Discover

Discover

A game's page

A game's page

Big Picture mode

Big Picture mode

Saves

Saves

Get it

Windows 10 or 11, 64-bit. Initial macOS support targets Apple Silicon: see the Mac build and test-artifact instructions. Mac test builds support native Mac games packaged as ZIP, DMG, RAR or 7z and are not Apple-notarized releases. If macOS blocks the first launch because it cannot verify the developer, follow the Mac first-launch steps.

Arch Linux x86_64 has a native .pkg.tar.zst build: see the Arch package instructions for building and installing it with pacman.

NixOS and Nix (x86_64): nix run github:elripalda/RecompLauncher, or see the Nix instructions to install it with your system.

Download the setup file from Releases and run it. While the beta is new, Windows may say "Windows protected your PC". Click More info, then Run anyway. Each release lists its file's SHA-256 so you can check you have the real one.

In Settings > General > When you close the window, Run in background controls whether closing the window keeps RecompLauncher in the system tray. Turn it off to exit the launcher and its background work when you close the window. Quit RecompLauncher always exits. The setting is also available in Big Picture mode. It is off by default for new installations; existing saved choices are kept. Games already running keep playing.

No game files

RecompLauncher has no game files and never downloads any. Every recomp comes from its developer's GitHub, and you set it up with your own copy of the game.

Found a bug? Have an idea?

The quickest way is Settings > Beta in the launcher. It goes straight to the developer and can include your PC's details. You can also post in the Discord or open an issue here.

If a game crashes, send the log from the crash screen. Every one helps.

Making a recomp?

Add a recomplauncher.json to your release and players get one-click setup, your settings inside the launcher, and Big Picture mode support. The guide is in docs/DEVELOPERS.md, with examples in docs/examples.

Source code

The full source of the launcher is here: the Rust core in src-tauri/ and the window in ui/. You can read exactly what it does, or build it yourself with the steps in docs/BUILDING.md. It's licensed under the GPL v3 (LICENSE).

Stars over time

RecompLauncher's stars over time

About

Made by Ripalda. If you'd like to support it: Ko-fi.

RecompLauncher is free to download and use. It isn't affiliated with or endorsed by any game's makers or platform holders.

RecompLauncher (elripalda/RecompLauncher)

Ищем в базе…

Что это такое?Лаунчер для PC-рекомпов, то есть нативных PC-версий консольных игр, которые создают сами разработчики на основе оригинальной игры. Он находит, устанавливает, обновляет и запускает их из одного места, а копию игры вы предоставляете сами.
Рекомп — это то же самое, что эмулятор?Нет. Рекомп — это нативная PC-версия, которую разработчики сами создали на основе оригинальной игры, а не эмулятор консоли, который запускает код игры.
Как всё запустить?На Windows 10 или 11 (64-бит) скачайте установочный файл на странице Releases и запустите его. Во время бета-версии Windows может показать предупреждение «Windows protected your PC»: нажмите More info, затем Run anyway.
Нужна ли мне собственная копия игры?Да. Лаунчер не содержит файлов игр и никогда их не скачивает. Каждый рекомп берётся с GitHub разработчика, и настраивается он с вашей собственной копией игры, например, если указать Easy Setup путь к образу диска или папке с игрой.
Есть ли подводные камни у сборок для macOS?Да. Это тестовые сборки без нотаризации Apple, поэтому macOS может заблокировать первый запуск. Они поддерживают нативные игры для Mac, упакованные в ZIP, DMG, RAR или 7z.
Какие платформы поддерживаются?Основная цель — Windows 10 или 11 (64-бит). Поддержка macOS начинается с тестовых сборок для Apple Silicon, а для Arch Linux есть нативный пакет .pkg.tar.zst.
Можно ли сделать резервную копию или синхронизировать мои сохранения игр?Сохранения копируются в резервную копию перед каждым обновлением, а облачные сохранения доступны с бесплатной учётной записью.
Что такое режим Big Picture?Полноэкранный интерфейс для геймпада и телевизора. Внутри него также есть опция, которая позволяет оставить лаунчер работающим в фоне.
Что происходит, когда я закрываю окно?Для новых установок лаунчер завершает работу, так как «Run in background» по умолчанию выключено. Включите эту опцию в Settings > General, чтобы лаунчер остался в системном трее. Уже запущенные игры продолжают работать.
Можно ли добавить свой рекомп в лаунчер?Да. Добавьте recomplauncher.json в свой релиз, чтобы получить настройку в один клик, настройки внутри лаунчера и поддержку Big Picture. Руководство находится в docs/DEVELOPERS.md.
Какие есть похожие проекты?gt4-staticrecomp, dsh_desktop, tauri, Eglantine, pokemon-fulldex, ocarina-recomp, ShadowRecomp, LanternEngine
Автор
elripalda
Размер
17.2 MB
Звёзды
1.4K
Обновлён
КоммитNov 17
Возраст
20 д
Коммиты · 90 дней