Repository navigation
Releases
0.1.0
Important
Report crashes from inside Trudy
If a game crashes, start Trudy again and pick Help > Report a Crash on GitHub. It opens a bug report on the Trudy repository with your build, system, GPU and driver and the end of the crash log already filled in, and opens the log folder so you can attach the full log of the crashed run.
Trudy 0.1
The first Trudy release: Orchid 0.7.5 with all of its game fixes (and Orchid's newest shader fixes), plus performance work found by profiling a real game.
Ocarina of Time on a Ryzen 7 9800X3D + RTX 4090: 56 FPS where the same scene and settings ran at 35 FPS (+61%), with the graphics card 38% busy instead of 55% (30 FPS patch off to show the full rate; details in the README).
Faster on every PC
- GPU results are copied back to the game only for the pages its CPU actually reads. Before, one read page sent the GPU's whole written range back after every write: 8.6 GB/s over PCIe in Ocarina of Time, now 0.7 GB/s.
TRUDY_PAGE_DOWNLOADS=0restores the old behaviour. - Ocarina of Time's recommended settings now turn reactive flushing off (faster now: 17.9 instead of 22.9 ms a frame).
- Switch 2 games without recommended settings get what all of Orchid's presets share (GPU accuracy Low, Balanced fences, asynchronous shaders, reactive flushing off), unless you chose those settings yourself.
TRUDY_SWITCH2_DEFAULTS=0turns this off. - GPU waits spin for 50 µs before sleeping on CPUs with 12 or more threads.
Fixed
- Ocarina of Time: the leaves in Kokiri Forest no longer flash with a large white glow. Copying back whole ranges wrote stale GPU data over memory the game had just written.
AMD Ryzen
- New
-zen5downloads for Ryzen 9000 / 9000X3D (-march=znver5, with the PGO profile). They do not start on older CPUs; use-pgothere. - On dual-CCD Ryzen (7950X3D, 9950X3D, 9900X3D, 9950X...) the emulator's hot threads stay on one CCD, the 3D V-Cache CCD on X3D parts.
TRUDY_CCD_AFFINITY=0turns it off.
NVIDIA RTX 40 / RTX 50
- RTX 40 (Ada) and RTX 50 (Blackwell) cards are recognised. The tensor-core path for the games' matrix instructions can now switch on there (
EDEN_NX2_TENSOR=fast, experimental); it stays off by default.
Also
- Profiling tools:
TRUDY_GPU_TIMING=1andTRUDY_GPU_TRACE=1log the host GPU's time per shader, render pass and command. - New name and orchid icon;
trudy.exe. Settings, keys, firmware and saves are shared with Orchid (%APPDATA%\eden).
Known issues
- Only Ocarina of Time was available for testing. Please report FPS for Orchid and Trudy side by side in other games.
- Everything listed under Orchid 0.7.5's known issues still applies.
Install
Windows: extract the zip and run trudy.exe, or eden-cli.exe from a terminal.
Linux (AppImage): make it executable (chmod +x) and run it; it bundles its libraries and needs glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch).
Linux (tar.gz): extract it and run ./trudy or ./eden-cli; it uses your system libraries, so Qt 6 and the usual libraries must be installed.
macOS: Apple Silicon and macOS 15 or newer. Extract the zip and move trudy.app to Applications. The CLI is inside trudy.app/Contents/MacOS/eden-cli. The app bundles Qt and MoltenVK and is ad-hoc signed, not notarized; macOS may require approval in Privacy & Security. macOS support remains experimental and uses the JIT, not NCE.
The -pgo builds are the same programs compiled with profile-guided optimization (clang plus the repo's orchid.profdata) and run on the same CPUs; if one is slower than the normal build for you, please report it. The Windows PGO build is a MinGW build, so it carries its own DLLs and needs no Visual C++ redistributable.
Trudy looks for newer builds of its channel at startup and from Help > Check for Updates.