Jorge262007/FFTARecomp

Final Fantasy Tactics Advance, running natively on your Windows PC, Linux PC or Steam Deck.
Widescreen, video and audio options, and a one-click installer.

FFTARecomp turns Final Fantasy Tactics Advance (USA version) into a native program for Windows, Linux and Steam Deck. Instead of running in an emulator, the game is recompiled from your own ROM, so it runs smoothly, needs no BIOS, and gets modern options. It is based on gba-recomp by JRickey.

• 🎛️ Completely redesigned menu.
• 🔍 Zoom in and out.
• 🐧 Native Linux version.
• 🕹️ Steam Deck support.
• 📜 Installer scroll on small screens: you can now scroll down to reach the rest of the installer and continue the installation.
• 🎮 Gamepad support (generic XInput).
• 🐛 Many bugs fixed related to very wide aspect ratios.
• 🔊 New Normal audio mode: the game fast-forwards while the audio keeps playing at normal speed.

• 🖥️ Widescreen: Auto, 16:10, 16:9 (default), 20:9, 21:9 and 32:9.
• 🔍 Zoom in and out.
• 🎨 Video options: screen model, grid, scaling and vsync.
• 🔊 Audio options and volume control.
• ⏩ Fast forward.
• 🕹️ Remappable controls and generic XInput gamepad support.
• 📦 One-click installer: pick your ROM and you're done.
• 🚫 No console BIOS needed.

💡 To open the Options Menu, press Esc while in-game.

Controls can be remapped from the Options Menu.

1. Download FFTARecomp-windows-x86_64.zip from Releases and extract it.
2. Run FFTARecomp.exe, choose your ROM and press Recompile & Install.
3. Wait for the five steps to finish, then press Play. ▶️

Download FFTARecomp-linux-x86_64.tar.gz from Releases and run:

mkdir -p FFTARecomp-linux && tar -xzf FFTARecomp-linux-x86_64.tar.gz -C FFTARecomp-linux && cd FFTARecomp-linux && ./FFTAInstaller

On Steam Deck, run it from Desktop Mode.

💡 You need your own copy of Final Fantasy Tactics Advance (USA). This project does not include any game data.

You need Rust and Windows PowerShell. Then run a single script from the repo root:

git clone https://github.com/Jorge262007/FFTARecomp.git
cd FFTARecomp
.\build-all.ps1

The script does everything in order:

1. Builds the whole workspace (cargo build --release).
2. Builds the installer (cargo build --release -p installer).
3. Copies installer.exe into Installer\, next to the static payload folder.
4. Downloads the compiler toolchain (w64devkit 2.10.0) into Installer\payload\toolchain, only if it is missing.

When it finishes, the final installer is in:

FFTARecomp\Installer\

If PowerShell blocks the script, run it with:

powershell -ExecutionPolicy Bypass -File .\build-all.ps1

To force a fresh toolchain download, delete Installer\payload\toolchain and run the script again.

⏱️ The first build can take several minutes.

• 👻 In the first level, some sprite silhouettes may appear on screen for 1 to 3 seconds. They don't show up again for the rest of the game.
• 🎮 The first time you launch the game, the gamepad may not be detected until you open Options > Input and try to remap a button. It then activates on its own.

• 🐢 The first installation builds the game on your PC and can take several minutes. It is normal for the PC to slow down and for CPU/RAM usage to rise. This only happens once.
• 💾 The install is larger than the game alone because it includes the compiler toolchain needed to build it.
• 🚧 This is a work in progress.

🛡️ Windows or your antivirus shows a warning?

The executables are not code-signed, so Windows SmartScreen or your antivirus may show a warning. Click More info → Run anyway, or right-click the .zip → Properties → tick Unblock before extracting.

If you have any doubts, you can check the VirusTotal report included in each release.

• License: MIT, see LICENSE. It keeps the original author's copyright line.
• Based on gba-recomp by JRickey (MIT OR Apache-2.0).
• gamedb.sqlite is by JRickey, released under CC0 1.0.
• Includes w64devkit (GCC, binutils and other tools under GPL and compatible licenses), unmodified. Their licenses are in payload/toolchain.
• Final Fantasy Tactics Advance is owned by Square Enix / Nintendo. This project is not affiliated with them and does not distribute ROMs or copyrighted game data.

Made by a fan, for fans.