Changelog
All notable changes to Retromind will be documented in this file.
The format is based on Keep a Changelog,
and this project (aims to) adhere to Semantic Versioning.
[0.2.5-alpha] - unreleased
Added
Changed
Fixed
- show the title text in the Cinematic theme only when no logo is available, avoiding duplicate titles
- no preview loading of images for videos/music/manuals in Media Editor
Added
- new Navigator BigMode theme with compact vertical library navigation, breadcrumbs, a fixed artwork/video preview and achievement progress
- new Cinematic BigMode theme with expansive artwork and video previews, a mixed category/media cover shelf, and a layout scaled for large screens
- select and download available ScreenScraper PDF manuals individually, including regional variants, with optional bulk import and automatic skipping of identical documents
Changed
- use Navigator as the default BigMode theme for new settings and categories while preserving saved theme choices
- shorten the shared BigMode system-menu hint while continuing to show custom controller and keyboard assignments
- reduce redundant artwork loading and bound cached artwork memory while browsing BigMode libraries
- publish only the current
Retromind-<version>-x86_64.AppImage.zsync update metadata; retire the legacy filename containing linux
Fixed
- allow GOG installations to be retried from the context menu after a cancelled or failed reinstall leaves the game folder without its launch executable
- prevent the first game in a newly opened BigMode category from briefly appearing in the previous theme
- make subcategories and directly contained media reachable together throughout BigMode, Home and System browsing, including Arcade and LivingRoom with Home disabled
- preserve mixed selections in nested search categories without accidentally including or excluding entire branches
- keep category artwork paths consistent during renames and moves, abort invalid category trees safely, preserve files when recovery is uncertain, and show a visible recovery notice after an incomplete drag-and-drop rollback
- show separate bulk-scraping totals for imports, missing matches, skipped items and failures, with accurate cancellation and provider-limit completion messages
- keep controller navigation consistent when using multiple controllers or combining the D-pad and stick, and release held directions on disconnect, focus loss and monitoring shutdown
- limit remote artwork downloads and reject excessive image dimensions to reduce memory spikes while browsing
- preserve existing multi-disc playlists when updates fail and fall back to the primary disc instead of launching an incomplete or outdated playlist
- keep metadata-import error messages readable below the results and explain when a manual download returns no valid PDF
- display scraped quotation marks, apostrophes, umlauts and other HTML-encoded characters correctly in metadata previews and imports across scraper providers
Added
- optionally synchronize achievements and completed playtime for linked GOG games and display GOG progress, rarity, unlock times, and privacy-safe hidden achievements in the desktop details and BigMode
- new PlayStation 2 system theme
- a separate Help window with practical guides for common workflows including nodes, emulators, Windows games, stores, metadata, portability, backups, and launch diagnostics
Changed
- keep the last successful Steam and GOG achievement progress and downloaded icons available for offline viewing after restarting Retromind while avoiding repeated service requests during normal library browsing
- improve Linux display stability, HiDPI window sizing, native Wayland scrolling, and UI resource cleanup
Fixed
- hide achievement panels in supported themes and desktop details until the selected game has confirmed achievements, including GOG and Steam titles with no achievements
- prevent GOG Windows installations from creating prefixes without their required C: and Z: drives, and keep cancellation responsive when Wine setup outlives the installer launcher
- explain Epic uninstall messages about a nonempty game folder when Retromind confirms that subsequent cleanup removed the folder successfully
- warn when assets cannot be fully restored after a failed item move, list the affected locations, and avoid deleting the only remaining copy during rollback
- keep Retromind-managed Wine and Proton prefixes portable when Wine assigns an external device to the previous games drive letter, and create portable prefix folder names consistently across filesystems
- keep complete context menus visible without unexpected scroll controls on X11
- refresh the context menu after a game is assigend to the GOG-Store
- keep node and per-game environment, working-directory, and XDG paths portable when editing launch settings
- keep usable ComicVine search results and available cover artwork when one of its comic resource searches fails temporarily
- keep copied Proton prefixes independent from the original Retromind installation when both locations remain available
- re-enable launch and Store actions promptly after a GOG game closes while Comet cleanup and playtime synchronization continue in the background, with a bounded grace period when exiting Retromind
Added
- import owned Epic Games titles directly through bundled Legendary without requiring Heroic Games Launcher
- install Epic Games titles directly through Retromind with install-location selection, free-space checks, progress output, and cancellation
- view Epic Games installation status and installed versions, check for and apply updates, and repair managed installations from the media editor
- manage owned Epic Games DLCs through Legendary, including installation, updates, and removal
- uninstall Retromind-managed Epic Games installations without removing their library items, media, or metadata
- install uninstalled GOG and Epic Games titles directly from their item context menus
- link existing library items to GOG or Epic Games, switch stores after uninstalling a managed copy, and migrate legacy Heroic entries without losing launch settings, media, or metadata
- display Steam achievement progress, unlock times and privacy-safe hidden achievements in the desktop details and BigMode
- automatically track imported Steam game sessions for playtime and achievement updates without requiring a manually configured process name
- download video assets through ScreenScraper
- randomly select among multiple videos when random playback is enabled
- filter game metadata searches by system with ScreenScraper, IGDB, and TheGamesDB
- access direct contact links and privacy-conscious diagnostic information from the Help tab
Changed
- remove the obsolete Heroic/Epic path settings; Epic libraries are now imported directly through Legendary while existing Heroic launch entries remain usable
- include readable game titles in the prefix folder names of newly installed Epic Games titles
- make Epic Games installation, repair, and removal safer by protecting temporary credentials, preserving user environment overrides, rechecking managed paths immediately before changes, and retaining damaged installations for recovery
- remove Legendary registrations and exclusive Wine/Proton prefixes when uninstalling managed Epic Games titles while preserving shared prefixes, mods, saves, and other unrecognized files
- check available storage before downloading and installing GOG games, updates, and DLCs while accounting for reusable installer files
- protect GOG installations from oversized installer downloads and checksum metadata, and isolate temporary installer files from other users on Linux
- protect managed GE-Proton installs and removals against unsafe paths, untrusted release sources, oversized downloads and archives, and corrupted files
- reject malformed or oversized metadata-backup entries before they can consume excessive memory
- keep runtime theme files and assets inside their assigned theme folders and reject oversized theme definitions
- store scraper API keys, passwords, and client secrets in the system keyring; portable scraper profiles require their credentials to be entered again on each new computer
- organize item and category context menus consistently, with compact Store actions and direct access to imports and per-item searches
- import GOG games into any category through the regular picker instead of restricting categories to dedicated GOG nodes
- use Steam’s quiet system-tray mode when launching imported Steam games on Linux to reduce unwanted client windows
- improve BigMode responsiveness on high-resolution displays, especially while rapidly browsing artwork-heavy libraries and playing previews
- load desktop cover grids faster while keeping BigMode artwork loading responsive
- make the Default BigMode cover transition smoother while preserving its clearly visible entrance
- give Prism descriptions more room by using the empty space below their metadata chips
- stop inheriting BigMode themes from parent categories; new categories start with the Default regular and system themes
- show the category game-system assignment under General instead of keeping a separate Integrations tab
Fixed
- keep fallback logos in a stable position while browsing games in the desktop details panel
- prevent the Arcade theme from crashing while creating its logo rail and keep the layout stable while artwork is loading
- prevent the previous system’s fallback artwork from flashing while switching BigMode system themes
- refresh replaced media previews immediately and restore live asset updates in the main view while editing
- keep global search scopes, search results, and media filters current when nested categories or edited items change
- recognize existing native Linux GOG offline installations when linking games, refresh Store actions immediately and retain their previous folder for later reinstalls
- display the GOG badge immediately after linking a library item to a GOG title
- preselect the currently configured Wine or Proton runner when updating or reinstalling a GOG game
- keep showing cached Steam achievement progress when downloading an updated response is interrupted
- preserve existing achievement credentials when updated integration settings cannot be saved completely and report failures when stored credentials cannot be removed
- prevent reused Linux process IDs from hiding newly started Steam games from automatic playtime tracking
- allow Retromind to close promptly while startup sorting or asset scanning is still running
- avoid rebuilding the current library view when toggling parental protection for a single item
Added
- customize BigMode controller and keyboard bindings, including page navigation and a confirmation-protected shortcut for stopping running games
- open a controller-operated system menu from any BigMode theme to review bindings or safely exit Retromind
- scrape ROM metadata and artwork with ScreenScraper using optional securely stored account credentials, exact file identification, localized title fallback and quota-aware bulk processing
- link existing library items to owned GOG games and safely bring recognized offline installations under Retromind management without losing their media or metadata
Changed
- protect game folders and Wine/Proton prefixes shared with other library items from destructive GOG operations
- show the installed GOG version in the media editor when it is known
- improve Archive Atlas browsing in large libraries with smoother scrolling, clearer mode-specific details, readable long descriptions and better media fallbacks
- improve the Wheel theme with continuous carousels, stronger selected artwork and a unified media and detail presentation
- improve HorizontalRow with smoother artwork changes, screenshot fallbacks, clearer selection and more readable text
- give the System host and Default system subtheme consistent navigation, responsive artwork and video, scrolling descriptions and clearer game counts
- refresh the Default BigMode theme with better couch readability, distinct category and game views, reliable artwork and video fallbacks, smoother transitions and faster large-library browsing
- group the GOG media action directly behind the regular add-media action in main-view context menus
- continue first-run guidance into empty categories and open setup directly on the emulator tab
- make bulk scraping faster and more reliable by requesting only selected content and avoiding unnecessary use of provider quotas
- make large ROM-folder imports faster, show live scanning progress and allow cancellation before the library is changed
Fixed
- keep managed Wine/Proton runner files intact when updated game assignments cannot be saved during removal
- keep Linux files and directories that differ only by letter case distinct during imports, runner and store configuration, theme and media loading, and Wine-prefix handling
- recover the last valid settings backup when the current settings file contains unusable data
- prevent GOG operations from unexpectedly losing authorization when the current sign-in is about to expire
- launch nested wrappers correctly when their executable paths or arguments contain spaces
- reject incomplete or damaged GOG offline-installer downloads instead of reusing them as complete files
- preserve the active theme when installing or updating a shipped theme fails
- leave media and node artwork unchanged when editing is cancelled
- keep the BigMode system-menu shortcut hint from obscuring metadata in the Arcade and LivingRoom themes
- prevent stale BigMode video frames and reliably start or resume previews when changing games, switching systems or returning from interrupted navigation
- play a selected category’s own preview video independently of its contained games
- remember the previously selected category and each category’s last selected game while navigating BigMode
- stop attract mode immediately on user input and restart its idle timer after returning from a game
- pause secondary BigMode background videos while a game is running
- remember the left navigation pane width between sessions
- recover the last valid library backup when the current library file contains unusable data
- keep saved libraries portable by excluding generated absolute asset paths
- show the correct RetroAchievements progress when rapidly changing the selected game
- avoid counting a cancelled game launch as a completed play session
- prevent simultaneous Retromind instances from overwriting the same portable library
- handle scraper quota exhaustion and recovery cleanly for TheGamesDB and ScreenScraper
- improve automatic book and comic matching when titles contain authors, subtitles, release years or issue names
- avoid incorrect automatic matches between related but distinct platforms
Added
- show resolved emulator paths and Wine versions
- Add per-game launch diagnostics
- add a configurable BigMode Home screen with recently played, favorites, and library rows across all shipped themes
- add unobtrusive getting-started help
- allow retaining manually downloaded GOG DLC installer packages for backup or reuse
- add a read-only library check for missing references, orphaned media and inconsistent entries
Changed
- shorten settings tab labels and group backups and library maintenance under Data
- remove the redundant
linux segment from AppImage filenames while preserving legacy update discovery
- publish a curated BigMode screenshot through the AppImage’s AppStream metadata
- allow selecting which installed GOG DLCs are restored by a clean reinstall
- improve Prism carousel and background-loading performance and add smoother wallpaper crossfades
- synchronize Prism logo and wallpaper crossfades
- synchronize Prism preview cover, screenshot, and new-video fade durations with its wallpaper transition
Fixed
- repair relocated Proton-prefix runtime links before launching games or installing later GOG updates and DLCs
- respect the leading-article sorting setting for explicit sort titles
- prevent stale cover or screenshot frames from appearing underneath the video preview after changing the selected BigMode item
- reveal BigMode after its initial layout and artwork setup pass to avoid a visible second rebuild
- keep installed GOG DLCs synchronized when updating or reinstalling their main game
- update all Prism game details when selecting a carousel cover with the mouse
- honor the GOG installer-retention choice for automatically reinstalled DLC packages
- restore live stdout/stderr forwarding for launched games while retaining early-failure diagnostics
- validate selected runners before launch
- restore BigMode focus after tracked game sessions
- avoid treating Steam, Heroic, and URI launcher handoffs as completed game sessions
- keep delegated store launches guarded while the external game is starting
- restore Home selection highlight and page favorites
Added
- make shortcut creation optional for GOG Wine/Proton installation
- configurable BigMode theme for the virtual library root
- experimental RetroAchievements integration for supported systems
- RetroAchievements progress summaries in BigMode themes
- controller-friendly RetroAchievements detail browser in BigMode
- added store badges on Game Covers
- new Nintendo Game Boy Advance and Sega Mega Drive system themes
- new cinematic Prism BigMode theme
- dynamic artwork-derived accent colors for opt-in BigMode themes
- install and update GOG DLCs
- playtime params are editable
- available GOG updates can now be checked manually
- search/filter for missing media items
Changed
- make information dialogs copyable
- reorganized media editor launch settings
- reorganized settings editor launch settings
- removed global wrappers
- load RetroAchievements badge images only when the achievement list is expanded
Fixed
- themed busy cursor on native Wayland
- ignore cue-referenced disc image files
- select newly imported GOG library item
- add RetroAchievements CHD hashing support
- preserve RetroAchievements identities in library snapshots
- symlink safety checks for GOG game uninstallation
- track structural changes as dirty
Added
- new arcade system theme
- Multiediting implemented
- opus audio support
- automatic backup/restore functionality for metadata and editor settings
Changed
- Protect settings from overwrite after load failure
- centralized GOG media item state checks
- replaced the GOG WebKitGTK login with an embedded WPE dialog and system-browser fallback
- removed the old redundant global theme-path fallback
Fixed
- correct selection when starting BigMode
- limit GOG update sweep to relevant items
- respect separate primary and secondary video settings
- store GOG Windows games as manual runner launches
- made GOG login cancellable and prevented unavailable embedded-browser runtimes from crashing the application
Added
- experimental native Wayland opt-in with X11 initialization fallback
- mass switching of proton versions
- drag & drop for items is now possible
- option to test launch items (without game time played counter)
- statistics for Library
- new system theme for Playstation 1
- user gets feedback when the game launch fails
Changed
- updated Avalonia to 12.1.1 and Avalonia WebView to 12.1.0
- expand and unify item context menus
- stop music playback when encountering defect music files
Fixed
- wayland starts in fullscreen
- cleaned up code and fixed a few small bugs
Added
- new System theme ‘PC Games’
- text completion for custom fields, custom fields are shown before the item description
- new console system theme
- language support for texts in default system theme
- zsync metadata and embedded GitHub Releases update information for AppImage delta updates
Changed
- removed Prefix architecture / selection is not used in Wine/Proton and misleading
- hardened GOG installer/ safety procedures for install/deinstall in system folders
- better name comparison for mass scraping
- unified save/abort handling for menus
- node names are now case sensitive
- use appimagetool 1.9.1 and static Type-2 runtime for build process
Fixed
- theme sync didnt work correctly for system themes
- better error handling when saving data
- only load backup if the main file is missing/not readable/damaged
- a few small bugs and changes
- GOG installations are now portable when installed under dataroot
Added
- new system themes for the Commodore 64 and Amiga (more will follow soon)
- SteamGridDB as a new artwork scraper
- Added support for empty media entries without a launch file
Changed
- Reworked the metadata and artwork import workflow with per-field selection
- Improved multi-disc filename detection and handling
- Improved GE-Proton runner management, sorting, registration and removal
- Improved video transitions when switching system themes
Fixed
- crash when cancelling bulk scraping or opening the metadata dialog
- several smaller issues and removed unused code
Added
- you can now save search terms for quick reuse
- metadata autocomplete
Changed
- removed Heroic GOG import functionality, since GOG is now supported natively
- only the x86_64 release of GE-Proton is now offered
Fixed
Added
- GOG integration (experimental):
Update, deinstall and cancel installation of GOG titles directly in Retromind.
Previously only Heroic‑based imports were supported.
This implementation is currently experimental, so expect bugs.
See the README for setup requirements and usage instructions.
Changed
- small improvements to the search functionality
Added
- native GOG support, previous versions only supported GOG through Heroic import.
This implementation is currently experimental, so expect bugs.
See the README for setup requirements and usage instructions
- improved and more logical library sorting
- pressing Esc can now deselect the current item
Fixed
- several smaller bugs and internal cleanup
Added
- management for wine and proton versions, download and refresh of GE-Proton releases
Changed
- dynamic custom field handling and year comparison for search function
Fixed
- a few small bug fixes and changes
Added
- Scraper support for the new metadata (if available)
- Scrapers are now configurable in the settings
Changed
- separate metadata tab in edit medium dialog for cleaner menus
Fixed
- included SDL2 library in AppImage, reworked build process to only use Debian 12 bookworm libraries
- a few small bugs
Added
- emulator-level XDG/HOME override logic in Emulator Settings (standard is that all emulators use system home/Xdg)
- Screenshot as a new media asset type for media items
- parental controls
- an explicit Tmds.DBus.Protocol dependency to address the transitive security issue in Avalonia.FreeDesktop:
GHSA-xrw6-gwf8-vvr9
- metadata fields: Release Type, Max Players, Publisher, Series, Play Mode, Source, Sort Title, Custom Fields
Fixed
- AppImage environment sanitization (DocumentService and Winetricks are now included).
Added
- new scraper TheGamesDB
- scraper language selection where available
- support for XDG environment variable overrides in Emulators
Changed
- manual metadata search dialog reworked (more results and richer info)
Fixed
- included SDL2 library in AppImage, reworked build process to only use Debian 12 bookworm libraries
- a few small bugs
Added
- Heroic/Epic integration.
- Node settings can now apply a default emulator to existing items, including subcategories.
- Support for .cbz files in manuals.
- New HorizontalRow theme.
- Deferred startup warmup for faster initial loading.
Changed
- Random music is now selected on each media-item selection (when randomization is active and multiple music files are available).
- BigMode key handling was reworked and optimized.
Fixed
- Effective default emulator resolution now works correctly in subnodes with inherited settings.
- Several memory leaks were removed, plus many smaller fixes.
Removed
- EmuMovies scraper is temporarily disabled until the new API is rolled out.
Added
- added: new theme LivingRoom
Changed
- changed: music files and manuals keep their original name now in the ui
- improved: performance in themes
- changed: updated Avalonia to 11.3.11
Fixed
- fixed: crash after switching in themes between items with movies
- fixed: Comic Vine scraper now works
also a lot of small fixes and changes
Added
- added Crossfade for Wallpapers and Logos in the CoreApp
- added Crossfade for Wallpapers/Logos/Covers/Videos in BigMode (depending on used theme)
- added possibility to set portable Home/XDG usage in Settings
- added possibility to manually set steam and Heroic/GOG folders, hardened automatic import
- added possibility to set fallback Logos/wallpapers/videos through Node Settings
Changed
- changed User Settings, added miscellaneous tab
Fixed
- fixed a few bugs regarding theme settings in the Tree (System theme can now be set on root, Drag/Drop now takes duplicates into account)
Added
- „XDG‑Overrides for native titles“ + Working‑Directory‑Default
Changed
- updated inheritance logic in Nodes/Emulators for env. variables and wrappers and made it more clear now
- optimized edit media dialog settings, made it simpler to set an emulator
Fixed
- fixed bugs in Arcade-Theme (no sound in videos, centered logo view works now)
- added missing dependency in AppImage (bundled libidn for libvlccore)
- fixed a few small bugs
Added
- Added the ability to create 32‑bit / 64‑bit Wine/Proton prefixes
- Added Winetricks integration
Changed
- Massive memory optimizations
Fixed
- Fixed a large number of bugs
- Optimized and fixed the search function/view
Added
- Use relative paths internally when creating Wine prefixes.
- Allow changing the primary executable in media settings.
- Add wrapper support for emulators and native programs.
- Add per-item environment overrides.
- Allow marking items as favorites.
- Allow attaching documents/manuals to media items.
Changed
- Optimized themes for better usability on smaller screens.
- Cleaned up themes.
- Some small changes to the ui.
Fixed
- Correct handling of profiles when switching emulator/native.
- Theme cleanup after switchting between themes in BigMode.
0.0.1 - 2025-01-01
Added
- Initial BigMode implementation with:
- Arcade theme (cabinet + logo rail + per-item video preview).
- System host theme with right-hand system layout slot (
SystemLayoutHost).
- Default system layout sub-theme (system video preview on the right).
- Node settings:
- Per-node artwork (logo, wallpaper, video) based on
MediaNode.Assets.
- Per-node BigMode theme selection (
ThemePath).
- Per-node system preview theme selection (
SystemPreviewThemeId).
- LibVLC-based video preview pipeline:
- Main preview channel (
MainVideoSurface) for per-item/system videos.
- Secondary background channel (
SecondaryVideoSurface) for theme-level videos.
- Gamepad navigation in BigMode (up/down/left/right/select/back).
- Attract mode support (idle timer that spins through games after inactivity).
Changed
Fixed
Versioning
0.0.x – early alpha versions, APIs and themes may change at any time.
- Once the project stabilizes, versions will move to
1.0.0, 2.0.0, etc.