At a glance

  1. DownloadOne archive for your system from the Releases page.
  2. UnpackExtract the archive to a folder of its own; keep the files together.
  3. StartLegaia Studio to explore the disc, Legend of Legaia to play.
  4. Pick your disc onceYour USA .bin (or .cue). Both programs remember it.
Bring your own disc - nothing is uploaded

The download contains only the project's own compiled programs: no game data. Both apps read a disc image you supply - a raw Mode 2/2352 .bin dump of your own Legend of Legaia (USA) disc, SCUS-94254, or the .cue sheet beside it. They read it on your computer and write only into folders you choose; nothing is sent anywhere.

The two pages these programs grew out of go further: Extracting assets has the command-line route for every asset type, and Playing and viewing has every option of the port. Prefer no install at all? The same engine runs in the browser on the play page.

1 · Download

Open the Releases page, take the newest release, and under Assets download the archive for your system:

Your systemArchive
Windows 10 / 11 (64-bit)legaia-tools-<version>-x86_64-pc-windows-gnu.zip
macOS 11 or newer (Apple silicon or Intel)legaia-tools-<version>-universal-apple-darwin.tar.gz
Linux on a PC (x86_64, glibc 2.28+)legaia-tools-<version>-x86_64-unknown-linux-gnu.tar.gz
Linux on ARM (aarch64)legaia-tools-<version>-aarch64-unknown-linux-gnu.tar.gz

Every archive holds both apps, the command-line tools, the licenses, and two short text files: README-PLAY.txt (how to start the game, the controls) and README.txt (every program in the folder). To check a download was not damaged, fetch SHA256SUMS from the same release and run sha256sum -c SHA256SUMS --ignore-missing (shasum -a 256 -c ... on a Mac).

2 · Unpack and start for the first time

Each archive unpacks into a single folder named after it. Keep everything in that folder together: the game's launcher and Studio's Play button both look for legaia-engine right beside them.

Windows

  1. Right-click the .zip and choose Extract All.... Do not run the programs from inside the zip window - Windows then unpacks one file at a time, and the game's launcher cannot find the engine beside it.
  2. In the extracted folder, double-click legaia-studio.exe for Studio, or Legend of Legaia.exe to play.

"Windows protected your PC"

The programs are not code-signed, so Microsoft Defender SmartScreen may stop the first start of a program it has not seen before. Click More info, then Run anyway. It asks once per program.

Legend of Legaia.exe is a small starter that runs legaia-engine.exe without a console window; legaia-engine.exe itself is the same game plus every command-line option, and is the one to run from a command prompt.

macOS

  1. Double-click the .tar.gz in Finder to unpack it.
  2. In the folder, open Legaia Studio.app for Studio, or Legend of Legaia.app to play.

"Apple could not verify..." (Gatekeeper)

The two apps are signed ad hoc but not notarised by Apple, so the first open is refused. Right-click (or Control-click) the app and choose Open, then Open again; on recent macOS versions, try to open it once, then go to System Settings > Privacy & Security and click Open Anyway. Each app asks once. If macOS instead says the app "is damaged", clear the download quarantine flag from a Terminal in that folder:

xattr -dr com.apple.quarantine "Legend of Legaia.app" "Legaia Studio.app"

Linux

tar -xzf legaia-tools-<version>-x86_64-unknown-linux-gnu.tar.gz

Then start ./legaia-studio or ./legaia-engine from the new folder, or double-click either in your file manager. The game needs ALSA (libasound.so.2) for sound and udev for gamepads, and Studio needs OpenGL; every mainstream desktop distribution already has all three.

3 · Legaia Studio

Studio is the friendly front end to the project's asset tools: everything the command-line extractors do for a single texture, model, sound or line of dialog is a button here, and the whole-disc extraction is a tab with a progress bar.

Open your disc

Legaia Studio's start page: the title, a gold Open disc image button beside Open extracted folder, and a list of what each view does
The start page. Once you have opened something, an Open again list (also Recent in the top bar) holds the last eight discs and folders; click one to reopen it.

Click the gold Open disc image... button (Ctrl+O), drop the .bin or .cue onto the window, or type its path. A folder that legaia-extract already wrote opens too, with Open extracted folder.... Studio checks the image before loading it and reopens the last one at the next start; if the file is not a disc image, a red banner says why, with Copy for a bug report. The x beside a recent entry takes it off the list, and an entry whose file has been moved or deleted drops off by itself.

Browse and search the archive

The Browse view filtered by the search rim elm: the archive tree lists the Rim Elm scene blocks with their entries, categories and sizes, and the selected entry's Overview on the right
Every word of the search must match: rim elm keeps just the Rim Elm scenes, town tmd the town meshes.

The left panel is the game's main archive (PROT.DAT), grouped by the name each block carries on the disc and by the place a scene is (town01 - Rim Elm). Each entry shows what kind of data it holds and its size. The search (Ctrl+F, Esc or its x clears it) matches the block name, the place name, the kind of data and the entry number, and says how many entries match; the category menu narrows the list further, Show all drops both, and the arrow keys, Page Up / Page Down, Home and End walk it. Disc files at the bottom lists the disc's own file system, each file with a save button.

Preview and export

The tabs above the preview show what the selected entry holds:

The Textures tab listing a Rim Elm entry's 96 textures, one page of ground textures drawn large, the palette slider, zoom and PNG export buttons
Textures: every image in the entry, with a palette (CLUT) slider.
The 3D model tab showing a textured Rim Elm tree, drawn with the textures its scene loads
3D model: drag to orbit, scroll to zoom; scene textures a mesh the way the game does.
  • Textures - a palette slider and zoom. Many textures carry several palettes, and the wrong row looks like static, so try a few before deciding one is broken. Export one image or all of them as PNG.
  • 3D model - the game's own shading, or untextured under a viewer light. Most scene meshes borrow textures another entry of their scene loads, which the scene option resolves. Export as OBJ or as a textured glTF (.glb) that Blender opens directly.
  • Audio - play the samples of a sound bank one by one, or a music sequence through a chosen bank; export WAV.
  • Text - a scene's dialog and other messages, with the accented letters of the French, German and Italian discs; export as text.
  • Hex and Overview - the raw bytes, where the entry sits on the disc, and a raw .BIN export.

After an export, Show folder on the status line opens the folder it went to.

Characters & monsters

The Characters & monsters view: the party and monster lists on the left, Vahn in battle form partway through his Pyro Pummel art on the right, with the equipment pickers, the clip picker and the frame slider
The party in battle form with any equipment, and every monster by name with its element; every battle animation plays or steps frame by frame.

Pick a party member to see the battle model built from the equipment you choose, or a monster from the list (Gimard Lv2, with its element badge). Every battle animation plays at game speed or steps a frame at a time; for Vahn, Noa and Gala the list includes every Tactical Art by name. Export glTF writes the animated model.

Movies & voice

The disc's movies play with their soundtrack, or step frame by frame with PNG export of any frame. The streamed CD-XA audio (voices, some music) is listed file by file and channel by channel, each playable and exportable as WAV. These read raw CD sectors, so they need the disc image rather than an extracted folder.

Extract the whole disc

The Extract tab after a finished run: output folder, skip options, a full progress bar, the step-by-step log and an Open output folder button
The Extract tab writes exactly what the legaia-extract command line produces.

Choose an output folder (Studio proposes one beside the disc image), tick any steps to skip, and start; a note under the folder warns when it already holds files. The tab shows the step, the time so far and, once a step has a steady rate, about how long it has left; the log can be cut down to its warnings, the run can be cancelled, and Open output folder is there whenever the folder exists. The run goes on while you browse, and its end (or its error) shows on the status line of whatever view is open. Tick Export all textures as PNG to also get every texture on the disc as a PNG. What the folder holds is described in Getting started.

Play, and the rest of the window

Play - the gold button in the top bar, or F5 - starts the game on the open disc, at the title screen. Saves, key bindings and options are the same ones the game uses when you start it directly, and the disc is remembered for the game too: starting Legend of Legaia later finds it ready. The display options you set in the game's launcher (below) apply to a game started from Studio too. Play needs the USA disc image and legaia-engine in the same folder; when it is greyed out, hover it to see why. If the game stops with an error, the status line shows the end of its log and where the full log is.

Legaia Studio in its light theme, showing the monster Drake Ghost textured in the Characters & monsters view
The light theme, from the View menu.
  • Status line - a confirmation (an export written, the game started) clears itself after a few seconds; an error is a red banner that stays until Dismiss, and Copy puts its text on the clipboard for a bug report.
  • Keyboard - Ctrl+1 to Ctrl+4 switch between Browse, Characters & monsters, Movies & voice and Extract; F5 plays; F1 lists every shortcut.
  • View - a light or dark theme, or follow the desktop; and the zoom of the whole window, also on Ctrl+= / Ctrl+- / Ctrl+0. Both are remembered.
  • About (F1) - the version, the keyboard shortcuts, and where the third-party license notices sit.

Studio remembers its window size, the view you left it on, the recent list and its folders in legaia-studio/settings.json under your configuration folder (~/.config on Linux, %APPDATA% on Windows, ~/Library/Application Support on macOS).

4 · The native port

The port is Legend of Legaia from New Game to the credits on a from-scratch engine, drawn with a modern GPU renderer at any window size. It reads the game's data from your disc as it runs.

The native port in Rim Elm: Vahn on the village path between a house, the windmill and the Genesis Tree
Rim Elm in the native window.

Three ways to start it

  • Double-click Legend of Legaia.exe (Windows), Legend of Legaia.app (macOS) or legaia-engine (Linux). The launcher opens: pick your disc once, set the display options if you like, and press Play.
  • From Legaia Studio - Play starts it on the disc Studio has open, and remembers that disc for the double-click start.
  • From a terminal - every option is a flag:
    ./legaia-engine play-window --disc "/path/to/Legend of Legaia (USA).bin" --boot-ui
    --boot-ui opens on the title screen; without it the game drops you straight into Rim Elm. ./legaia-engine play-window --help lists the rest, and Playing and viewing explains them.

The launcher

The launcher: a disc card saying Legend of Legaia (USA) is ready, the Play, Change disc, Controls, Open saves folder and Quit buttons with a help box, and the grouped option list with its scroll bar - Display, Enhancements and Play, with Sound and Original game below the fold
The launcher. Once it knows your disc it letters itself in the game's own font.
  1. Choose disc...Pick your .bin or .cue (Ctrl+O), drag it onto the window, or type its path. It is checked and remembered.
  2. OptionsTurn the enhancements on or off before you start, in a scrolling list grouped as Display, Enhancements, Play, Sound and Original game; they are the same settings the in-game keys below change.
  3. PlayThe game opens on the title screen and the launcher closes.

The disc card at the top says whether the disc is ready, or what is wrong with it: moved, not a disc image, or another region's disc (a PAL or Japanese disc is refused; a randomized or translated USA disc is fine). The help box under the buttons explains whichever row is focused. The arrow keys move, Left / Right change an option, Enter presses, Esc quits; the mouse works too. Controls shows your key bindings, and Open saves folder opens the folder your saves and settings live in.

PlayStation pixel look adds the console's wobbling vertices and colour dithering; Original game only starts the game exactly as the original looks and moves - every enhancement off for that session, your settings kept for next time. If the game ever stops with an error, the launcher comes back and shows it.

Controls

The arrow keys are the D-pad. A gamepad works too, by button position (bottom / right / left / top face buttons are Cross / Circle / Square / Triangle), and either the D-pad or the left stick moves.

KeyPlayStation button
ZCross
SCircle
ATriangle
XSquare
Q / WL1 / R1
1 / 2L2 / R2
Enter, SpaceStart
Right ShiftSelect

Key Config on the in-game Options screen rebinds the keys. The mouse turns the camera: drag to orbit around your character, scroll to zoom, double-click to put the game's own framing back.

Esc twice quits. The first press only shows Press Esc again to quit at the bottom left, so a stray key does not lose an unsaved game; save in the game first.

Display toggles and the F12 panel

The native window with the F12 panel open, listing every toggle key with its current state
F12 (or ?) lists every toggle key with its current state; press it again to close.

The port adds a few enhancements over the original, each on its own key (and on the launcher), each with the original look one press away. A press shows the toggle's new state at the bottom left for a moment. For its first few seconds the window says F12 or ? lists the keys in the same place, until you open the panel.

KeyToggleStarts
IEnhanced lighting: a time-of-day mood, real light at lamps, glowing props. Off is the game's own baked shading.on
F8Lighting time of day: auto, day, dusk, nightauto
YShadows from the enhanced lightson
F4See-through walls between the camera and your characteron
F9Volumetric ground fogoff
F10Bloom: lamps, glowing props and bright sky glow softlyoff
TCamera distance: retail, far, fartherfar
RFree-angle movement instead of the original eight directionsoff
F2Muteoff
F11, Alt+EnterFullscreen (the launcher also sets it, and the window size)off

The panel also lists a few keys for tinkering rather than playing: F1 diagnostic text, F3 a free debug camera, F6 to fill the AP gauge and F7 to switch random encounters off and on. The visual options (lighting and its time of day, lamp shadows, see-through walls, ground fog, bloom), camera distance, movement mode and fullscreen are remembered between sessions.

To play exactly as the original looks and moves, turn on Original game only in the launcher, or start with --retail: every enhancement off and every engine option at its original value for that session, without changing your saved options.

./legaia-engine play-window --disc "/path/to/Legend of Legaia (USA).bin" --boot-ui --retail

Where saves and settings live

Started by double-click or from Studio, the game keeps its files in your per-user folders, so they are the same however you start it:

SystemDisc choice (launcher.toml)Saves, options, key bindings
Linux~/.config/legaia-engine~/.local/share/legaia-engine
Windows%APPDATA%\legaia-enginethe same folder
macOS~/Library/Application Support/legaia-enginethe same folder

Saves go to saves/memcard1.mcr, a standard PlayStation memory-card image that emulators read too; options to legaia-options.toml, key bindings to legaia-input.toml, and the log of the last launcher-started game to legaia-engine-game.log. A play-window run from a terminal keeps these three in the current directory instead, so run it from the same place each time (or pass --save-dir).

See also

  • Getting started - the command-line tools from the same archive, and what an extraction writes.
  • Extracting assets - one scenario per asset type, on the command line.
  • Playing and viewing - every option of the port: scenes, battles on demand, cheats, movies, minigames, record and replay.
  • Play in the browser - the same engine with nothing to install.