Xenia Manager Version 5.0.0

Xenia Manager v5.0.0 has been released to enhance the Xenia Emulator experience for Xbox 360 games. Key features include a new Game Files Explorer for easier navigation of game data, improved achievement handling, and an artwork pipeline for better visuals. The Big Screen Mode offers a console-style interface accessible via a gamepad. The update also introduces streamlined library management, enhanced file format support, and various bug fixes. Documentation is now available on a new wiki to aid users. Overall, this version strives to streamline gameplay and installation of patches, making it more user-friendly.

Xenia Manager v5.0.0 has been released. Xenia Manager is a tool crafted to streamline the usage of the Xenia Emulator. The goal is to simplify game playing and the installation of specific game patches while providing a user-friendly interface for modifying Xenia settings. Xenia serves as an experimental emulator for the Xbox 360.

Xenia Manager Changelog:
✨ New Features
Game Files Explorer (replaces Open Game Location) (30b607e, e3c0798, 940ef75, 707b562, 82dea3a, bdd154a, 3428730, fb4b946, 1eaafd3, 5d0ed3f, de12efd, ba8ddbc, b8337ef)
Replaces the Open Game Location feature with a built-in, read-only browser for a game’s container, accessible from the library context menu and supporting multi-disc. A preloaded directories-first tree with live search, reveal-in-tree, and multiselect is positioned next to a details pane that displays parsed XEX metadata (title/media IDs, version, disc, image size, module flags), the SPA summary (title, achievement count, gamerscore, icon), STFS metadata with thumbnail for CON/LIVE/PIRS packages, embedded image previews (PNG/JPG/BMP), and every SPA achievement with localized name/description, icon, and gamerscore badge. A bottom panel provides a summary of the container format, file count, and total size. Double-clicking files opens them smartly: text files in a viewer with a selectable encoding footer, .gpd files in a read-only viewer showing achievements and an entry table, and unknown files probe for STFS magic in a nested dialog. The XEX details dialog loads in two cancellable stages (fast header first, full details on demand) and displays base version, executable type (Retail/Debug), icon export to PNG, and a per-language achievement selector. Any selected files, folders, or mixed choices can be extracted with traversal-safe writes and a progress dialog showing extracted/failed counts, while the game folder remains accessible in Explorer.

Achievements from game files (ef8297c, ac20c1d, 9e2c370, ac1543d, 8fd6db2, 1305606, 15c3243, 6fb17b9, 2833253)
A new AchievementGpdBuilder backend fills in missing achievement GPDs directly from the game disc’s SPA data, utilizing the selected account and its language with a fallback mechanism, ensuring the FFFE07D1 title entry. Both the desktop app and Big Screen feature a Fetch button (Y on Big Screen) that generates a missing GPD from the disc, retrieves achievement images (missing-only, unlocked-only, or overwrite-all), and refetches names and descriptions while retaining unlock states — multi-disc games prompt for the disc to read.
Locked achievements are rendered in black and white, while unlocked ones retain color (missing artwork shows lock icons), and Big Screen still completely hides locked secret achievements.

Artwork pipeline (3fac724, 44b6a32, b04d4d7f, ef45bdb, 2273a44, b460919)
When adding a game, embedded artwork is prioritized — STFS thumbnails, SVOD GOD header+data, and XEX SPA/XDBF icons extracted through a newly managed LZX decoder with retail/devkit AES-CBC decryption and Basic/LZX decompression (ISO/ZAR delegates to the embedded XEX with a *.xex fallback) — before falling back to an XboxDatabase download, and lastly to the local template, all controlled by the new UseEmbeddedArtwork setting (default is on). Containers are also searched case-insensitively for an inner nxeart package’s nxebg.jpg (JPEG/PNG, including a filesystem sibling next to the XEX) as a prioritized background respecting the toggle, and the game editor can fetch artwork from game files or x360db on demand.

Big Screen Mode (0507eac, 5d2a931, 4edcd29 by @SBUplakankus)
A new console-style Avalonia app that is fully operable with a gamepad: a dashboard with game cards (toggle box art/icon), dynamic backgrounds, and header stats; a library featuring grid/list views, sorting, and disc selection; game details displaying installed content, achievements, patch downloads, per-version XConfig settings, and screenshots; a gallery with thumbnails and per-version filtering; and settings with profile management, controller cards, and RGB sliders — driven by SDL-based gamepad input with a button mapper, plus bitmap caching and threaded background loading. A new UI Scale setting (25%–200%) adjusts the interface size, and Start in Big Screen will open Big Screen directly on startup.

Library and Content (c425379, 80826e6, c6b1f5f, 5ec0b83, 1987e53, 01f1ba4)
Since xenia-canary b11458e can load CON/LIVE/PIRS packages preserved in the content directory, the single Install button is now Install (Extract) and Install (Package): package installation copies the file as-is into the content tree with byte-progress, lists entries via embedded STFS metadata (with embedded thumbnails), and deletes the file when the entry is removed, while extraction remains an option for older Xenia builds and forks. Refreshing the UI now scans the games folder, allowing newly added games to be recognized, and the installed content menu is divided into four per-type entries with dedicated entry points in the content viewer (localized in en/hr, while the rest are unsynchronized as untranslated), plus content rows display installation size and version instead of just filenames in both the desktop viewer and Big Screen.

File format backend (ffdba14, 5aef693, 14c8cf7, 1dff939, 6231caf, aa58543, aff9ec7, 2964191, 00c0051, 6300630, c6d7224, fb7e7fb)
A new SVOD/GOD parser (volume descriptor, header+data layout, GDFX traversal with sector mapping, thumbnail-first icons with XEX SPA fallback) is integrated into game detection for both file and directory paths, and STFS/SVOD now reaches parity with the ISO/ZAR browsing contract through a single IGameFileSource entry point with a magic-bytes factory, so the UI never switches based on container type — even extracted directories are covered, with a containment guard in place. Full XDBF/SPA parsing includes title headers, per-language string tables with an English fallback, contexts, properties, presence, matchmaking, stats, and total gamerscore, while XLAST support reads the XSRC payload and exposes titles, product info, and localized strings merged with the SPA tables. Additional updates include: a public ISO browsing API over a shared GDFX walker, GPD RemoveTitle/FillTitlePlayedData with a resize write-back fix, profile-tile PNG helpers, XEX1/XEX25 support with per-format security info and both retail/devkit keys, expanded FileIdentifier signatures (XEX variants, ELF, XBE, MZ, XSF, CON/LIVE/PIRS, ZAR footer, XISO fallback), and XEX parsing that is header-only with decompression capabilities to prevent full extraction whenever a game is opened.

🐛 Fixes
Steam Shortcut deleting titles (bc462ad)
Mixing Manager-created and Steam-created shortcuts no longer results in the deletion of titles for all shortcuts within Steam.
LZX Decoding (cae2875)
Corrects the managed LZX decoder (wide bit-buffer splits, 24-bit block length as 16+8 bits, 32 KiB frame decompression, per-frame E8 post-processing) with a BitWriter-based test harness.
Storage and disc parsing (STFS hash walk, ISO probe, SVOD/XSF layout, ZAR ranges) (7a07e2a)
Fixes the STFS big-endian hash chain and multi-block file-table walk, loops XGD descriptor probes with a root-size guard, distinguishes XSF vs enhanced-GDF layouts, decodes filenames as Windows-1252 without requiring extra dependencies, and rejects ZAR footers that point outside the file.
64-bit STFS offsets, truncation errors, streamed extraction (4fcf159)
Large packages now implement 64-bit offsets, truncated inputs generate appropriate errors, and extraction streams instead of buffering.
Repair ISO split discovery, correct HeaderFile title_id offsets, patch-file hash/media_id arrays (9c784d0, 25dd554, 6a7c971)
Split ISOs now gather base and numeric parts from any slice and serve lookups from cached entries; title_id readings are at the correct offset with legacy fallback (written at both); patch files now accept single-line hash/media_id arrays and integer F32 values.
Guard short-buffer title read in headers and verify Account layout (56497cc)
Truncated headers are no longer read out of bounds, and the subscription-tier bit-range comment has been corrected.
Scan XEX headers only and dispose of rejected install content (898e841)
Install-content scanning now reads only XEX headers and disposes of rejected packages, ensuring installations remain fast and leak-free.
NavigationView selection, MessageBox owner, content input listener (b34a3d9, d715ecc, 8718c8e)
Open Xenia and Big Screen Mode items no longer remain selected in the NavigationView; MessageBox dialogs now anchor to the right window; the content input listener operates only while achievements are displayed.
Big Screen Language & Localization (855b340)
Big Screen now aligns with the language selected in the desktop app, and its remaining hardcoded strings have been localized.

♻️ Refactors and Infrastructure
New class libraries (a6b8c2d, e2c6257, 3b198d3, df05fee)
File-format code has been extracted into XeniaManager.Files, database clients into XeniaManager.Database, and the logger into XeniaManager.Logging, keeping Files from depending on Avalonia and Database leaf-independent. Namespaces have been renamed to match, projects have been organized into source/tests solution folders, and hardcoded paths have been consolidated into AppPaths/XeniaPaths constants.
Tests have been restructured to reflect the new libraries and expanded across file formats (SPA, XEX header-only, STFS/SVOD/ISO/ZAR browsing and icons, LZX, GPD builder, XLAST, FileIdentifier), databases, and converters; linter scripts have been added and expanded.

🚀 Improvements
Performance
STFS packages now load stream-backed with ranged reads and per-block range serving; GPD achievements/images/titles and image lookups are memoized; container XEX headers are parsed lazily; the ZAR zstd context is reused; the SVOD layout probes share a single locked reader; ContentViewer now loads account contents off the UI thread while redundant profile GPD loads are skipped, and the game files search filter is debounced.

📚 Documentation
New official wiki is live at xenia-manager.github.io/wiki, built with Zensical and deployed via GitHub Pages. Huge thanks to @SBUplakankus for assistance. Utilize it to navigate through the features of Xenia Manager, both old and new.

🎉 Thank You
A heartfelt thank you to all contributors for reporting, testing, and building this release, especially to @SBUplakankus for their work on Big Screen Mode with gamepad navigation (#572, #584) and major assistance on the new wiki (Big Screen docs and site style).
Download: Xenia Manager v5.0.0
Source: Here