Skip to content

Releases

Lichii-tgm-v1.0.6

Choose a tag to compare

@ThatGuyMcd ThatGuyMcd released this 18 Nov 01:39

Lichii-tgm-v1.0.6

I've brought across two more shared fixes from the nightly review, keeping our Forest Lantern, handheld and Couch Mode interfaces, every setting, saves and OOT add-ons intact. Frame generation remains off.

Profiles and launching

I've fixed profile reloads so the selected user is opened again. Reloading an empty user directory also creates and opens the normal default profile, matching the existing startup behaviour.

The command-line launcher now resolves user names after loading the selected configuration and its NAND directory. Names beginning with a number stay names, repeated --user options keep the last choice, and invalid indices keep the configured choice. Existing profile files retain their user IDs and contents.

This adapts Lichii #2064, landed in d3074e62d3, with additional checks for deferred profile selection and numeric bounds.

Repeated memory diagnostics

I've limited repeated unmapped-memory write messages to the first 1,000 for each write width, followed by a periodic sample every 100,000 attempts. The address and value remain in each message. The counters are safe across host threads, and mapped writes keep their existing path.

This adapts Lichii #2151, reviewed at 5b5330a826. It reduces logging overhead when faults repeat; it doesn't change the underlying memory operation.

Downloads

I've included matching Windows x86-64 and Linux AppImage builds, with checksums, the source/version manifest and complete automated test receipts. Couch Mode and its first-launch invitation are included in both.

All source changes since v1.0.5.

Thanks to the upstream authors and the Lichii, Fritchii, Eglantine, Eden and yuzu contributors. Their original copyright notices and licences remain. Games, keys and firmware are not included.

Lichii-tgm-v1.0.5

Choose a tag to compare

@ThatGuyMcd ThatGuyMcd released this 17 Nov 23:52

Lichii-tgm-v1.0.5

I've brought Couch Mode into this update, along with another round of shared fixes from upstream. I've kept our Forest Lantern UI, handheld layout, settings, saves and OOT add-ons intact.

Couch Mode

I've added a full-screen library and settings layout for playing from the sofa, using a controller or a touchscreen. It includes game collections, search, settings navigation and theme packs. The settings still use the emulator's original controls and apply paths.

On first launch, you can choose Switch now or Later, with Never ask again if you don't want the invitation to return. You can also open it from View → Couch Mode or Ctrl+Shift+C. Starting in Couch Mode is a separate preference, so trying it once won't change how the emulator starts next time.

There's more information in the Couch Mode guide.

Shared fixes

I've adapted these upstream components to our fork, keeping our existing cache ownership and settings:

  • Texture-handle interpretation and cache migration: Lichii #2051, based on Eglantine #900.
  • Texture cleanup in the image's owning GPU address space: #2062.
  • Bounded reads for large shader-cache logs: #2110.
  • Complete, atomic Vulkan pipeline-cache snapshots and fallback when a driver rejects a saved cache: #2100.
  • Shader-job waiters can pick up their own ready driver work: #2098.
  • Syncpoint polling keeps its notification history separate from the immediate value mirror: #2052.
  • VP9 range-encoder carry handling: #2070.
  • Native texture tiling in uploads and software blits: #2085 and #2121.
  • Safer package metadata parsing, preserving useful missing-key and program errors: #2061, with isolated synthetic key-generation coverage informed by #2068.
  • Register bounds for the existing LZ texture-load lowering: #2132.
  • Correct handling of the default IP protocol on Windows, avoiding an incorrect unsupported-protocol error: #2058.
  • Game-list patch and DLC labels refresh on each scan rather than reusing stale text from disk: #2095, addressing #2088.

These are specific components from those changes, with credit to their upstream authors. I've kept frame generation off and retained our independent shader regressions.

Downloads and nightly updates

I've included matching Windows x86-64 and Linux AppImage builds. Both carry the same source version, with checksums and complete automated test receipts alongside them.

I've also expanded the nightly routine to review commits, PRs and issues across both upstream forks, including shared fixes that don't mention OOT. Each successful nightly release advances the patch version; the next one after this is v1.0.6.

All source changes since v1.0.4.

Thanks to the Lichii, Fritchii, Eglantine, Eden and yuzu contributors. Their original copyright notices and licences remain. Games, keys and firmware are not included.

Lichii-tgm-v1.0.4

Choose a tag to compare

@ThatGuyMcd ThatGuyMcd released this 17 Nov 11:33

Lichii-tgm-v1.0.4

I've brought together the OOT Remake fixes and supporting renderer, shader-cache
and loader changes from this round of work. Our Forest Lantern UI, selected-game
artwork, handheld layout, full-screen settings and all of the existing settings
are still here. Saves, profiles, data paths, Photo Mode and the aspect-ratio
add-ons keep their existing behaviour.

Windows and Linux AppImage versions come from the same source commit.

OOT and rendering

  • I've corrected the OOT patch-storage reservation across both NSO loading passes,
    and retained the movie timeline, Scarecrow recording, moving-platform, water,
    sound, step-counter and Gohma timing fixes alongside the existing FPS Unlock.
  • Native upload tracking is retired after dispatch. Stream-buffer wrap, mapping
    runs, staging-buffer ownership and descriptor preparation now preserve resources
    through their final recorded use. Texture cleanup retains pending CPU writes.
  • Buffer-binding queries reuse mapping spans, and pages without cached images
    avoid unnecessary texture-cache locking. Contended CPU writes are gathered
    before command lists consume them.
  • OOT output recognition accepts stable native program keys. The NoSharpening
    path uses an established tone-mapped output and validates its frame, channel
    and mapping identity. The original prepass and network work remain available
    for a same-frame fallback.
  • Shader work includes shared-memory ordering, guarded global-buffer routing,
    atomic-return control flow and native offset handling. Syncpoint callbacks
    run outside the manager lock, with cancellation and exception cleanup.

Shader preparation and loading

  • I've balanced shader-build notifications across success, cancellation and
    failure, and kept the remaining-build count in the existing status label.
    Detached jobs retain their inputs and join before their owner is destroyed.
  • Cache migration, AMD session pipeline binaries, stale warm-file detection,
    worker cancellation, cache locks and driver checkpoints are retained. A second
    process cannot recover or truncate a live shader-build journal.
  • NSO reads and decompression lengths are checked before use. Module sizing uses
    checked arithmetic and the furthest segment, including OOT's additional BSS.
    NPDM ACI0 metadata, KIP section reads and BLZ expansion bounds are checked too.
  • Windows sparse-vector fault handling preserves writable pages, including pages
    committed concurrently. OOT's video-finalize command is registered explicitly.

UI, audio and source maintenance

  • Session speed limits and saved graphics choices are retained. Movie scaling
    keeps Automatic, Bilinear and Game choices. Frame generation remains off by
    default, and every existing graphics control remains available.
  • Audio keeps the microphone, None and silent-input choices, six-channel PCM and
    bounded host-queue refill. Empty saved input choices survive serialization.
  • Adventure Notes keeps bounded script output, timeout recovery, missing-state
    handling and progress corrections. Per-game recommendations can be remembered,
    skipped or reset independently of global choices.
  • I've restored our TGM banner in the main README and added nightly patch-release
    checks for source cleanliness, content provenance, matching packages, complete
    test receipts and checksums.
  • I've replaced four game-derived shader fixtures with small, independently
    assembled programs. Their generators declare every instruction and environment
    value. Regression coverage includes byte stores, unmapped atomic counters,
    descriptor-alias routing, geometry passthrough and cache replay/migration.

Extract the whole Windows ZIP before running lichii-tgm.exe. On Linux, make the
AppImage executable and run it. The downloads include the project licence;
SHA256SUMS, the release manifest and test receipts identify the exact builds.

All source changes since v1.0.3.

Thanks to the Lichii, Fritchii, Eglantine, Eden and yuzu contributors. Their original
copyright notices and licences remain. Games, keys and firmware are not included.

Build checks

Both downloads use source 1c1ff3e3fdd42b69ef092323a6f8d374b5e594b2.
Windows passed all 17 CTest groups and Linux passed all 18, including the cache
replay and corruption checks. The independent shader regressions catch all four
original bugs when their fixes are disabled. Package dependencies, source/content
checks, settings/UI retention, shader workers, unprivileged Linux cases, the
standalone AppImage Qt launcher and 44 emitted SPIR-V modules passed their checks.

I've included the exact test receipts, release manifest and SHA-256 checksums
alongside the Windows ZIP and Linux AppImage.

Lichii-tgm-v1.0.3

Choose a tag to compare

@ThatGuyMcd ThatGuyMcd released this 13 Nov 01:06

I've brought our fork up to speed with the useful commits and PRs from Lichii and Fritchii, keeping OOT Remake as the priority. Our Forest Lantern UI, handheld layout and all of the settings are still here. I've left the experimental changes for later.

Windows and Linux AppImage versions are both available below as Lichii-tgm-v1.0.3.

What's changed

  • Shutdown fixes for the Windows closing deadlock and guest stop ordering, plus local Windows crash logs and minidumps to help investigate future crashes.
  • Memory cleanup and SMMU reuse fixes, including returning retained blocks when memory pressure requires it.
  • Selected renderer fixes for mesh buffer lifetime, task/mesh descriptor limits, uniform write tracking, pointer recapture, query cleanup and fence handling. Geometry output and image-layout guards are included too.
  • Shader translation cleanup and recovery from interrupted shader-cache boot loading. More Actions → Prepare game shaders keeps our separate worker, pinned OOT profile, version checks, cancellation, cache locks and driver checkpoints. Compressed .zst shader archives are recognised too.
  • Custom clock fixes that keep both the date and numeric offset controls, including per-game restore. Recommended settings can also back up and restore the relevant per-game overrides.
  • A no-microphone option that captures silence without opening a host microphone. Existing microphone choices and audio output are retained.
  • Hardware GPUs are preferred over software renderers. Linux DLSS gains versioned runtime-library discovery through our existing backend. Frame-dump reports use UTF-8, and driver-cache diagnostics report actual file ages.
  • Self-contained NUP/tree-NX games keep their executable and game-data versions together. Existing installed NCA updates and user mods retain their behaviour.

This also includes the v1.0.3 fixes already prepared locally, including all-channel deleted-buffer cleanup and the 64-bit storage-binding correction. Saves, keys, firmware, profiles, existing data paths, OOT aspect-ratio add-ons and Photo Mode compatibility are preserved.

Checks

Both builds passed all 16 CTest groups, settings/UI retention, protected-source identity, package versions, dependencies and checksum checks. Linux permission-sensitive cases were also run without administrator privileges. The standalone AppImage Qt launcher, packaged shader workers, synthetic GPU preparation and isolated Windows crash-handler probes passed.

Both downloads come from the same source commit. The attached manifest and integration audit record the exact source, selected PR/commit scopes and validation. The full integration notes list what was brought in, already covered or left for later.

I haven't benchmarked gameplay performance for this integration. The native 60 FPS investigation is on hold, so this release doesn't claim a 2x boost or that every crash or location-specific issue has been fixed. Frame-generation settings and experimental defaults haven't been forced on.

The final upstream check also found PR #1550, published while these builds were running. I've reviewed it and left it out: it's a broad internal branding rename, with no missing renderer fix identified. That leaves main one commit ahead in Git's count. Fritchii's remaining ancestry differences are historical or deliberately excluded; the attached audit lists the compared tips and counts.

Lichii-tgm-v1.0.2

Choose a tag to compare

@ThatGuyMcd ThatGuyMcd released this 10 Nov 23:30

I wanted to give the entire emulator a bit of a visual overhaul. It was very "Clinical", and I wanted it to look a bit more joyful and have a sense of simplicity to it.

We want the best emulator specifically for OOT Remake, so this revision also brings in more of the wins from Lichii and Fritchii, more aspect ratios and the new shader preparation option.

A bit of a visual overhaul

  • Forest Lantern for dark mode and a similar light green version for light mode, across the toolbars, menus and settings windows.
  • A much more organised layout including all the settings. No settings have been removed or omitted.
  • The graphic at the bottom with the fox has been removed. The selected game's album art now replaces the forest scene image instead of having the artwork appear below it.
  • More touch screen friendly, with gaming handhelds in mind. The toolbar at the top, dropdowns and options are bigger, and the settings windows can be full screen instead of just being in a window.
  • Searchable settings, a layout that adjusts to smaller screens, and a Compact spacing option if you prefer it.

Existing settings, saves, profiles and data paths are kept.

OOT Remake shader preparation

There is now a Prepare game shaders… option in More Actions for each listed game. This first supported profile is for OOT Remake v131072.

It reads the shader programs from your selected game, uses a matching recipe to assemble the available pipeline records, and prepares them on your selected Vulkan GPU before you play. The existing shader cache options are still there.

The aim is to help with shader compilation stutters throughout the game. The OOT extraction check found 42,848 unique shader programs and assembled 120,124 pipeline records. These are different counts: one shader program can be used by several pipelines.

Coverage is still partial. 337 recipe records couldn't be matched, and the CPU replay check found 22 shader environments with missing data. The results show failed, unsupported and skipped work separately, and the game can still compile new configurations while playing. Full OOT GPU preparation and improvements to gameplay stutter still need testing.

Close the game, choose More Actions → Prepare game shaders…, and leave it to finish. It checks the game version and build before using the bundled profile. Vulkan and persistent shader/driver caches need to be enabled. Completed GPU work can be resumed; missing driver-cache data is rebuilt.

More OOT Remake aspect ratios and upstream changes

Added 4:3, 16:10, 3:2, 2:1, 32:9 and 32:10, alongside the existing 21:9 option. These adjust the game rendering, camera and HUD together. Choose the ratio in Graphics before starting the game, use Docked mode and disable fixed-size upscalers. The wider ratios need more GPU and memory headroom.

This includes 22 reviewed upstream commits through 7dddff2d0e, with OOT audio, GPU mapping and memory-pressure changes, plus the Fritchii v5.7 OOT shader recipe and a compatible pipeline-state fix. Further upstream changes are still being reviewed.

Downloads and checks

  • Windows: extract the entire Windows ZIP and run lichii-tgm.exe. Keep the shader preparation helper and the recipes folder with it.
  • Linux: download the AppImage, make it executable and run it. This is an x86_64 build made on Ubuntu 24.04.

Both builds passed all ten automated test groups. The packages, dependencies, versions and checksums were checked, and a small GPU test passed compilation, cache reuse and rebuilding after cache loss. These checks don't replace proper testing in-game or on a gaming handheld. The earlier blue-screen issue is not confirmed fixed by this release.

The build report, shader coverage audit and SHA256SUMS are attached below. Thanks to Lichii, Fritchii, Eglantine, Eden, yuzu and the original emulator and mod contributors.

Lichii-tgm-v1.0.1

Choose a tag to compare

@ThatGuyMcd ThatGuyMcd released this 10 Nov 02:05

Lichii-tgm-v1.0.1

This release retains the v1.0 Ocarina of Time Remake integration and merges all
11 commits from Lichii's nx2 through d2eaae4f3abca636b030b726f107bace06f61079.
Windows and Linux packages are built from the same source commit; the release
manifest records their checks, hashes and validation limits.

Graphics and stability changes

  • Upstream #1143 retains known
    storage-buffer pointer slots when a graphics pipeline is evicted and translated
    again. A temporarily null pointer can otherwise permanently remove geometry
    from that pipeline. The fork also carries this information through its prepared
    pipeline paths. This does not repair previously captured bad shader records.
  • Upstream #1154 corrects the
    variable shadowing introduced by zortos293#1143 for Windows builds.
  • Upstream #1147 keeps occlusion
    windows through 2048 slots within eight query banks, covering the 1025–1058-slot
    resets seen in the reported session. This is a bounded mitigation: windows above
    that limit still reset, and gameplay validation remains outstanding.
  • Device loss discovered while a guest CPU read waits for the GPU now reports
    Vulkan device-fault diagnostics before the existing fatal exception path.
    This improves evidence collection; it does not recover a lost GPU.
  • The upstream update includes translations, UI language handling and documentation.
    The fork retains its existing GPU-shutdown, host-memory diagnostic and delayed
    nxformat.dll loading integrations.

Fritchii OOT review

The review also covers Fritchii v5.5
and its 40 pull requests at the review snapshot. The
comparison records which changes are already covered,
newly selected, specific to Fritchii, or require further validation.

  • Ported Fritchii's texture-decode bounds checks,
    covering ASTC edge texels and rounded unswizzle dispatches. These avoid writes
    outside destination images; Fritchii reports OOT corruption and GPU faults on AMD.
  • NVIDIA keeps native noperspective interpolation in both shader stages, following
    Fritchii's NVIDIA fog regression report.
    The existing AMD clipping correction remains. Paired-stage SPIR-V tests check both
    paths, and the prepared-code identity changes so old prepared shaders are rebuilt.
    The affected scenes still need a hardware retest.
  • The inline shader-emission path keeps its verification reference when the queued-IR
    budget is exhausted, avoiding a second emission of mutated IR in diagnostic mode.
  • The buffer cache's post-copy barrier also orders later transfers, closing the
    downloads/gathers path identified in Fritchii's transfer-order fix.
  • Host-sync requests arriving after GPU shutdown are rejected, so a late GPU tick
    cannot execute callbacks whose waiting stack frames have already returned.
  • Inline QMD launches mirror their implicit compute-register update on the split's
    front, so later macros read the same state as the back. A production front/back
    macro regression fails on the old code and passes for mapped/control boundaries.
  • The sysmix audio queue adapts to the host callback size, within its ring capacity,
    using the focused change from Fritchii #22.
    The old three-block queue could not feed a 1,024-frame PipeWire callback. Playback,
    admission-limit and surround-capacity tests cover the change.
  • The AppImage has a relocatable Qt launcher, Wayland client deployment and an explicit
    X11 preference that takes precedence over a desktop's platform environment, adapted
    from Fritchii #37 and
    #39.

The review does not establish a frame-rate gain on the reported PC. The NVIDIA
system blue screen and damaged game-data findings below still apply.

Missing fairy-fountain rooms and grottos

A read-only check confirmed that the installed fairy-fountain normal-map member
/Tex/CmnTex_Map_Soil_FairyFountain_Floor_D_Nrm.bntx.zs starts with 12288 zero bytes
instead of a Zstandard frame. This matches the damaged member diagnosed in
upstream issue #420.
The upstream investigation found that the game then fails to create the dependent
room model, while collision can remain.

A renderer update cannot reconstruct the missing original bytes. Re-dump or verify
the affected game/update from your own console, retaining a backup of the existing
files. This release does not replace the texture with a different material. Other
missing grotto geometry needs scene validation after the data defect is corrected;
the confirmed fairy-fountain defect alone does not establish every missing surface's
cause.

Crash investigation and remaining limits

The application dump identifies VK_ERROR_DEVICE_LOST in the GPU semaphore wait
reached by a guest CPU readback. Independently, Windows Error Reporting recorded a
0x7F, trap 0x8 blue screen with the bucket
nvlddmkm!CNvLAdapter::queryNodePerfData and stack-usage classification.
The recovered kernel stack shows a hardware-monitoring service querying GPU node
performance through DxgkQueryStatistics / GetNodePerfData, followed by extensive
NVIDIA kernel-driver stack use. This is a concrete lead for a monitoring/driver
interaction; it does not establish the original driver defect or prove that every
reported application crash has the same cause.

The two reports do not prove an out-of-memory condition or a DLSS fault, and this
release does not claim to fix the system blue screen. A driver-level investigation
and a controlled gameplay retest are still needed. No Windows, driver, game-data
or controller settings were changed as part of this release.

Automated tests and package checks are not gameplay or hardware validation. The
release manifest records completed checks; private logs, dumps and game assets are
not included in the release.

Windows ZIP and Linux AppImage are attached below, together with SHA-256 checksums, the build manifest and audits. Extract the Windows ZIP in full before running lichii-tgm.exe. Make the Linux AppImage executable before running it. Both platforms passed all seven CTest groups; detailed case counts are in release-manifest.json.

Lichii-tgm-v1.0

Choose a tag to compare

@ThatGuyMcd ThatGuyMcd released this 09 Nov 23:42

First numbered release of Lichii-tgm, ThatGuyMcd's independent fork of Lichii.

This release includes the reviewed Ocarina of Time Remake integration, supporting
emulator fixes, fork branding and version metadata, and fork-specific update handling.

Downloads

Platform Package Run
Windows x86_64 Lichii-tgm-v1.0-windows-x86_64.zip Extract the entire ZIP and run lichii-tgm.exe
Linux x86_64 Lichii-tgm-v1.0-linux-x86_64.AppImage Make it executable with chmod +x, then run it

The CLI is lichii-tgm-cli.exe / lichii-tgm-cli. The Windows archive includes
the Qt libraries, update helper and Visual C++ runtime installer. Linux was built
and dependency-checked on Ubuntu 24.04 x86_64. Both packages include the project license.

Changes

  • Branded UI, window titles, startup logs, desktop metadata and release artwork as
    Lichii-tgm-v1.0, with numeric version 1.0.0.
  • Built on the tested OOT integration at 4dafb0b5c1, incorporating upstream
    snapshot 372b8d70611b1c2e7179e2a8bdea1897209540e0 and reviewed OOT/supporting PRs.
  • Added numerical fork-version ordering and exact versioned update-asset selection.
    Fork releases use their own repository and do not select upstream build-N updates.
  • Preserved access to the existing Eden/Eglantine settings, saves, keys, firmware
    and caches. Portable installations retain the user directory.

Validation and limits

Windows and Linux GUI/CLI builds and all seven CTest groups passed on both platforms.
Packages were checked for archive integrity, checksums, runtime dependencies and
version/source metadata. The included release-manifest.json records the tested
source commit and build details. SHA256SUMS covers the packages and audit files.

oot-integration-audit.json records the selected PRs, adaptations and exclusions;
branding-audit.json records retained upstream attribution and compatibility identifiers.
Protected vendor sources and generated recompilation directories were not edited.

This remains an experimental emulator. These are automated checks, not gameplay
validation or a compatibility/performance guarantee. Optional upscaler runtimes are
user-supplied. Games, keys and firmware are not included.

Credits and source

Thanks to Lichii, Eglantine, Eden, yuzu, Sudachi and their contributors. Original
copyright notices and licenses remain in the source. Original fruit artwork is by
YOB (yobslab); the fork wordmark is an imagegen text adaptation, with provenance in
dist/branding/lichii-tgm-artwork.json.

Source and issues.