v1.5.2

Gentleman v1.5.2

This update focuses on improving Modern Mode game lists, especially for multi-disc games and folder handling.

Changes

• Added optional grouping for multi-disc games in Modern Mode.
• Multi-disc games can now appear as a single game entry with a disc selection dialog.
• Multi-disc grouping works for both games inside folders and loose disc files.
• Modern Mode game lists now sort games alphabetically by their displayed title, including scraped titles.
• Normal folders still stay at the top of game lists.
• Grouped multi-disc games are sorted like normal games instead of folders.
• After scraping a single game, Gentleman now returns the highlight to that game after the list refreshes.
• Normal folders in Modern Mode game lists now use a theme-colored folder icon.
• Highlighted folders now also show the folder icon in the boxart preview area.

v1.5.1

Gentleman v1.5.1

Small patch release for Modern Mode scraping.

Fixes

• Fixed manual single-game scraping so the selected ScreenScraper match is used correctly.
• Previously, selecting a different suggestion could still scrape the first result.

v1.5.0

Gentleman v1.5.0 Released

Gentleman v1.5.0 is here, and this is a major update focused on the brand-new Modern Mode.

Modern Mode adds a more visual way to browse your game library, with boxart, metadata, summaries, multiple view layouts, resolution-aware presentation, and ScreenScraper integration while keeping the controller-first feel of Gentleman.

Highlights

New Modern Mode

A new Modern game list has been added.

Modern Mode can show scraped game information directly in the game browser, including boxart, metadata, and summaries. This makes browsing larger libraries easier and gives Gentleman a richer visual presentation while still keeping the classic menu style available.

New ScreenScraper Integration

ScreenScraper integration has been added to Modern Mode.

Gentleman can now scrape game metadata, summaries, and boxart for your library. Scraping supports both full library scraping and single-game scraping from the game list.

Large scrape jobs now open the progress dialog immediately and show an indexing status while games are being prepared. Single-game scraping can fetch similar game matches in the background, so the match picker appears quickly and stays responsive.

Modern View Options

Modern Mode includes multiple view layouts:

• Detailed List, shows the game list with boxart, metadata, and summary.
• Simple List, shows the game list with larger boxart while hiding metadata and inline summary text.
• Grid, shows boxart tiles with the game title or filename underneath.

The Modern View option is available in Display settings when Modern Mode is enabled.

Grid View

Grid View adds a cover-based browsing layout.

It shows boxart with the game title underneath, or the filename when a game has not been scraped yet. Long titles scroll when selected, and the grid adjusts to the current resolution while only showing artwork that fully fits on screen.

Boxart is loaded in the background, so the grid appears quickly while still allowing the user to browse.

Resolution-Aware Modern Layouts

Modern Mode introduces resolution-aware layouts for the game browser.

Detailed List, Simple List, and Grid adjust their layout based on the available screen space. Grid calculates how many rows and columns can fit, while only showing complete boxart tiles so artwork is not cut off.

Modern Mode also keeps its content inside a centered widescreen area on ultra-wide displays. Extra space is filled by the background or wallpaper instead of stretching the list, boxart, and metadata too far apart.

New Metadata and Artwork Storage

Modern Mode adds local storage for scraped metadata and artwork.

Scraped game metadata and boxart are saved locally using clean ROM-based filenames. When duplicate ROM filenames exist in different folders, Gentleman uses a stable duplicate suffix so metadata and artwork remain correctly matched without relying on random or scan-order-based names.

Dialog and Input Improvements

Several dialogs now better support both controller and keyboard input.

Dialog footer text now switches correctly depending on whether a controller or keyboard is being used, and dialogs can widen or wrap footer text when needed so controls are not cut off.

Changelog

• Added Modern Mode game browsing.
• Added ScreenScraper integration for Modern Mode.
• Added full library scraping for metadata, summaries, and boxart.
• Added single-game scraping from the game list.
• Added local metadata storage for scraped games.
• Added local artwork storage for scraped boxart.
• Added ROM-based filenames for metadata and artwork.
• Added stable duplicate suffix handling for duplicate ROM filenames.
• Added Detailed List modern layout.
• Added Simple List modern layout.
• Added Grid modern layout.
• Added Modern View option to Display settings.
• Added larger boxart display for Simple List.
• Added async boxart loading for Grid View.
• Added vertical row-based Grid navigation.
• Added resolution-aware Modern Mode layouts.
• Added resolution-aware Grid rows and columns.
• Added centered widescreen boundary for ultra-wide displays.
• Added metadata above the summary dialog when opening a game summary.
• Added background workers for library indexing and match fetching.
• Added indexing status while preparing games for scraping.
• Hid the scrape name field unless Use Custom Name is enabled.
• Improved controller and keyboard footer text in dialogs.
• Removed unused old dialog files.

Pre-release

v1.5.2

v1.4.2

Gentleman v1.4.2

This update adds custom theme support and improves the Settings menu layout.

Changelog

• Added custom .json theme support.
• Added a built-in Default theme that is always available.
• Added a themes folder where users can place their own theme files.
• Added simple user-facing theme color fields for menu, background, highlight, and text colors.
• Reorganized Settings:
  • Moved Menu Size and Auto Hide Menu to Display
  • Moved Wallpapers to Display
  • Renamed Menu to Menu Items

v1.4.1

Gentleman v1.4.1

This is a small polish update focused on improving the Settings menu layout.

Changelog

• Improved text wrapping for Settings descriptions.
• Fixed Menu Size description text getting too close to the edge of the menu.
• Fixed Auto Hide Menu description text exceeding the menu panel edge.
• Improved overall readability of longer Settings menu descriptions.

v1.4.0

Gentleman v1.4.0 Released

Gentleman v1.4.0 focuses on better menu management, cleaner settings, and faster navigation.

Highlights

Contextual Search

Search can now be opened with R1 on controller or Ctrl + F on keyboard.

Search is context-aware:

• From the root menu, it searches all menu folders and launchers
• From a folder, it searches that folder and its subfolders
• From inside a launcher or game list, it searches that launcher/list

Improved Menu Management

User-created menu folders now support optional subfolders.

The Save Folder picker is now a folder browser, allowing users to browse folders, create new folders with the onscreen keyboard, and select where launchers should be saved.

Folder and Launcher Options

The Y button now opens options for folders and launchers.

Folder options include:

• Open Folder
• Remove Folder

Launcher options include:

• Open Launcher
• Edit Launcher
• Remove Launcher

Removing folders or launchers requires confirmation first.

Settings Cleanup

Settings have been reorganized into categories:

• Display
• Menu
• Controls
• System

Menu Size has been moved to the Menu category and now shows the current value, for example Menu Size: 100%.

Auto Hide Menu

Added an optional MiSTer-style auto-hide feature.

When enabled, the menu and top bar hide after a selected idle time. The logo stays visible when enabled.

Available options:

• Disabled
• 10 sec
• 15 sec
• 20 sec
• 30 sec
• 45 sec
• 1 min

Changelog

• Added contextual search with R1 and Ctrl + F
• Added optional subfolder support for user-created menu folders
• Reworked Save Folder into a folder browser
• Added folder creation through the onscreen keyboard
• Added Save Folder editing to Edit Launcher
• Added launcher/folder options with the Y button
• Added Edit Launcher and Remove Launcher to Launcher Options
• Added Remove Folder with confirmation
• Reorganized Settings into categories
• Moved Menu Size into Menu settings and added current value display
• Added optional Auto Hide Menu setting

v1.3.0

Gentleman v1.3.0

Gentleman v1.3.0 improves system-based browsing, launcher organization, and the API structure for future third-party integrations and Gentleman Remote support.

What's New

PC Game Launcher Type

Added a new PC Game launcher type.

This works like the existing Application launcher, but uses PC as the system instead of Application.

This makes PC games show up correctly in system-based views while keeping the same simple .exe launch behavior.

Systems Menu

Added a new optional Systems menu.

The Systems menu only shows systems currently used by existing launcher files.

When opening a system, Gentleman now shows one flat alphabetical game list for that system instead of repeating the launcher/folder structure.

Example:

Systems → PlayStation 2 → all PlayStation 2 games

The Systems menu is disabled by default for new users and can be enabled from Settings.

Improved API Structure

The API now has a clearer split between system-based browsing and launcher-based browsing.

Systems API = flat library view
Launchers API = launcher/folder structure view

Changes include:

• GET /api/systems now returns systems currently in use
• GET /api/games-by-system now returns a flat alphabetical game list for the selected system
• Game entries include their source launcher for reliable launching
• Added GET /api/launchers
• Existing launcher/folder browsing remains available through /api/menu, /api/launchers, and /api/games

The API documentation has also been updated.

Update Popup Improvements

Improved the update message window:

• Renamed Changelog to Release Notes
• Release Notes button now has better spacing
• Release notes are now scrollable when the text is too large
• Pressing Back from Release Notes now returns to the update message instead of closing it immediately

Updater Note

The Gentleman Updater was improved in the previous release. If you have not updated the updater yet, it is recommended to download the latest updater as well.

Summary

This release makes the Systems menu and API more useful by treating systems as a flat game library, while keeping the original launcher/folder structure available for users and apps that need it.

v1.2.2

Gentleman v1.2.2

Focus

This update focuses on making large game libraries faster to browse and making launcher setup easier, especially for emulators and PC games that work better through Windows shortcuts.

Important Updater Note

It is highly recommended to download the latest Gentleman Updater with this release. The updater has been redesigned for controller-first use and now better matches the frontend experience.

Frontend Changes

• Improved ROM list browsing performance.
• Added background scanning for ROM folders.
• Added caching for unchanged ROM folders.
• Added new Shortcut launcher type for launching single Windows .lnk files.
• Added new Shortcut Folder launcher type for browsing folders containing .lnk shortcuts.
• Shortcut Folder launchers can be tied to a system.
• Application launchers now use Application as their internal system type.
• Launcher type selection can now be changed with Left/Right while highlighted.
• Pressing the launcher type field still opens the full type list.
• RetroArch launchers now show RetroArch Path instead of Emulator Path.
• Improved internal caching for favorites, network status, and wallpaper scaling.

Updater Changes

• Redesigned for controller-first use.
• Updated style to better match the Gentleman frontend.
• The updater can now optionally launch Gentleman after completing an update.

v1.2.1

Gentleman v1.2.1

This update focuses on controller input and list behavior improvements.

Changes

• Improved controller D-pad support for different controller types.
• Fixed incorrect D-pad direction behavior on some Bluetooth controllers.
• Fixed the top bar input icon so it switches correctly between keyboard and gamepad input.
• Recent games no longer allow duplicate entries.
• Starting a game already in Recent now moves it back to the top.
• Favorites are now sorted alphabetically.
• Recent and Favorites now use normalized arcade names when Arcade ROM Names is enabled in Settings.
• Lists now start the highlight on the first real entry instead of ....