peiikai/LASRecomp

What it is

LAS Recomp converts the Nintendo Switch version of The Legend of Zelda: Link's Awakening (2019) into a native Windows, macOS, and Linux application. It is a static recompilation, not an emulator: the game code is generated from the player's own extracted game files and compiled locally on first launch.

Beyond running natively, it adds widescreen and ultrawide support, higher internal resolutions with MetalFX or FSR 1 upscaling and SMAA, precompiled shaders to avoid traversal stutter, remappable keyboard/controller input, ten languages, and a large randomizer suite covering items, pots, bushes, digging, shops, entrances, dungeon rooms, bosses, and more. It targets players who own the Switch game and want a native PC/macOS version, especially randomizer players.

Quick start

1. Obtain a legally acquired extracted copy of the game at v1.0.0, v1.0.1, or v1.1.0. The folder must contain exefs and romfs. The project does not explain how to obtain these files.
2. Install a release build for your platform, or build from source. Players on macOS need Apple Silicon and macOS 15+; Windows and Linux need an x86-64 CPU with AVX2/FMA and a Vulkan 1.3 GPU.
3. Launch the app. The start screen asks for the game-file folder and then compiles the game code on your machine; this is where the 12 GB of free disk space matters.
4. Choose vanilla or generate a randomizer seed, configure settings, and start playing. The in-game menu opens with F1 or Minus + Plus on a controller.

To build on macOS: install Xcode command line tools, Homebrew sdl3 and ffmpeg, and Python 3.12; then run make -j10, set up game files, run make gen, and make -j10 again. The result is build/lasrecomp. Run it with ./build/lasrecomp extracted for the start screen or ./build/lasrecomp extracted --play to go straight into the game. Windows uses a one-time tools\setup_windows.ps1 script followed by make -j in an MSYS2 UCRT64 shell; Linux builds with make -j then make appimage. Platform details are in the Windows build guide and Linux notes.

Constraints

• No game files, assets, or fonts are shipped. The repository and release builds contain none of the game's code; the start screen generates it from the user's files, so setup requires time and disk space.
• macOS is Apple Silicon only. Intel integrated graphics up to UHD 600 series and slower GPUs are unsupported. Linux aarch64 is built but untested on real hardware.
• The build is labeled beta: crashes, graphics issues in wide aspect ratios, and unsolvable randomizer seeds (especially dungeon room shuffle) are possible. Known issues are tracked on the issues page.
• On Windows, data lives next to lasrecomp.exe, so the folder must be writable (not Program Files). On Steam Deck, the AppImage should be added as a non-Steam game, with APPIMAGE_EXTRACT_AND_RUN=1 %command% if it fails to launch.
• The project's own code is MIT-licensed, but that grants nothing for Nintendo's game. The author states it was written almost entirely by Claude and is maintained with AI assistance, and asks users to judge the code themselves.

HotRepo's take

There is no HotRepo ranking or snapshot data recorded for this repository, so there is no trend signal to read. The project's substance comes through in its scope: a full static recompilation pipeline with local game-code generation, a Metal/Vulkan renderer, and a randomizer suite deep enough to include entrance shuffle, dungeon room rebuilds, and per-seed trackers. The AI-authored disclosure is the main caveat to weigh — it shifts the burden of trust onto the reader, and the beta status plus known randomizer logic risk mean it should be treated as a fan project in progress rather than a finished product.