Skip to content

MetalSharp 1.4: game settings for every library, MetalVR headsets, Liquid Glass, MetalSharp Wine 8.0 - #806

Merged
aaf2tbz merged 25 commits into
mainfrom
feat/1.4-ui
Nov 18, 2026
Merged

aaf2tbz merged 25 commits into
mainfrom
feat/1.4-ui

Conversation

@aaf2tbz

@aaf2tbz aaf2tbz commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

MetalSharp 1.4: one game settings panel for every library, MetalVR headsets, Liquid Glass, and MetalSharp Wine 8.0.

Game settings

  • One panel, opened from a game's gear, for Steam, GOG, Epic, Battle.net, Ubisoft, Rockstar and Windows programs, laid out like Settings (ui_game_settings.rs; the row, switch, choice and navigation helpers now live on PagePalette and Settings uses them too).
  • Graphics: msync, MetalFX, x87 acceleration (x86_64 build), MoltenVK ray tracing (FEX build), and per game the OpenGL renderer (WineMetalGL or Zink) and Vulkan renderer (MoltenVK or KosmicKrisp, macOS 26 and later). The renderers are MetalSharp Wine 8.0's SharpGL_Switch and SharpVK_Switch, kept in /game-tuning (openglRenderer, vulkanRenderer) and set where MetalSharp starts the game.
  • Runtime: the Metal HUD with a list of its metrics (metalHudElements, validated against Apple's MTL_HUD_ELEMENTS names), launch executable, Steam emulator, controller input. The HUD is now applied from every library's game launch (ms_config_apply_metal_hud_env), not only Steam's.
  • Advanced: standalone app, a Windows program's launch arguments, environment variables, DLL overrides, Windows version, CPU cores, low priority.
  • Presentation: name, display mode, resolution, frame rate limit, and a game's own Retina for a game in a bottle of its own (Sharp Library: High Resolution (Retina) per game setting #797).

MetalVR

  • A game on the MetalVR route has a Headset tab: the headset (Rift CV1 and S, Quest 1 to Pro, Steam Frame, Index, Vive, Vive Pro, Vive Pro 2, PlayStation VR2), saved in ~/.metalsharp/metalvr/headset.json (GET/POST /metalvr/headset) for every MetalVR game.
  • One Setup button opens a guided setup per headset, from MetalVR's guides (POST /metalvr/setup): install MetalVR 0.2.1 (checked against its SHA-256), let macOS show the headset's display, SteamVR, pairing, and trusting a streamed headset's ALVR client.
  • The VR server starts with that headset's driver (--driver, --headset, --trust).

Liquid Glass (macOS 26 and later)

  • Settings > General > Liquid Glass; earlier macOS and Low Performance Mode keep the classic look.
  • AppKit's glass under GPUI's view (glass/MSGlass.swift, compiled by build.rs; liquid_glass.rs): the desktop blurred through the window, the hero's art, and NSGlassEffectView surfaces that GPUI marks as it paints, in several strengths (panels, controls, the primary action, the selected card, deep glass for settings and dropdowns).
  • The theme tints the glass and its controls; the sidebar, shelf and footer are glass panes; panels show over the art alone.

Layout and motion

  • The header has the sidebar button in the corner, without the logo and name.
  • Panels, settings tabs and the hero's art ease in; the sidebar slides more softly. Low Performance Mode keeps them still.
  • The window stops at 720x640. In a short window the shelf's cards, then the hero, shrink so the page fits, and the cards only ever shrink as the window gets shorter. A wide shelf with small cards shows up to four more cards on each side.
  • Lava is a red theme.

Issues

Other

  • MetalSharp Wine 7.0 → 8.0 (MS_WINE_RELEASE_VERSION, Release CI's METALSHARP_WINE_TAG).
  • An updated MetalSharp Wine leaves no earlier copy behind: its download is removed once installed, and an earlier release's download or a set-aside app goes at start.

Testing

  • make test in app/src-c (new cases in game_tuning_test.c for the renderers and HUD metrics) and cargo test in app-gpui (146 tests, new layout cases in library_layout.rs) pass.
  • A 1.4.0 FEX build from this branch, carrying MetalSharp Wine 8.0, is installed locally: the backend reports 1.4.0, loads the Steam library, and installed the 8.0 runtime.
  • Not tested: launching a game from the build, the MetalVR setup steps with a headset, and the x86_64 app variant. Liquid Glass was checked from screenshots during development, not by automated tests.

#797)

- The library header starts with the sidebar toggle: the MetalSharp logo
  and name before it are gone.
- Retina (RetinaMode and its DPI) reaches a game in a bottle of its own:
  at launch the bottle gets the game's own setting, or else Settings >
  Graphics', imported only when its user.reg differs. Game settings take
  "retina": "default", "on" or "off". The app's per-game control and
  the restart prompt are still to come.
…VR headsets

- Game settings: openglRenderer (WineMetalGL or Zink, SharpGL_Switch) and vulkanRenderer (MoltenVK or
  KosmicKrisp, SharpVK_Switch), set in the environment of the game MetalSharp starts.
- metalHudElements: the Metal HUD's metrics (MTL_HUD_ELEMENTS, validated against Apple's names), applied
  with MTL_HUD_ENABLED by ms_config_apply_metal_hud_env from every store's game launch, not only Steam's.
- MetalVR: the chosen headset and its trusted ALVR client (GET/POST /metalvr/headset) start the VR server
  with the right driver, --headset and --trust; POST /metalvr/setup runs a headset's setup steps.
- A bottle Wine has not made yet needs no Retina write when Retina is off (#797).
…quid Glass, motion

- Game settings: one panel for Steam, GOG, Epic, Battle.net, Ubisoft, Rockstar and Windows programs, laid
  out like Settings (shared setting_row, switch, choice and nav_item on PagePalette): Graphics (msync,
  MetalFX, x87, MoltenVK ray tracing, OpenGL and Vulkan renderers), Runtime (Metal HUD with its metrics,
  launch executable, Steam emulator, controller input), Advanced (standalone app, launch arguments,
  environment, DLL overrides, Windows version, CPU cores, low priority) and Presentation (name, display
  mode, resolution, frame rate limit, per-game Retina, #797).
- A game on the MetalVR route: a Headset tab (the headset list, saved for every MetalVR game) with a guided
  setup per headset from MetalVR's guides, and the msync, MetalFX and Metal HUD it keeps.
- Liquid Glass on macOS 26 and later (Settings > General, off in Low Performance Mode): a blurred window,
  frosted header, hero controls, shelf and footer, and translucent panels.
- Motion: panels, tabs and the hero's art ease in (ease-out quint); the sidebar slides softer.
- Settings > Retina: while Wine Steam runs with the old setting, a Restart Wine Steam button beside it (#797).
The desktop blurred through the window, the hero's art in it, and NSGlassEffectView surfaces GPUI marks as
it paints (liquid_glass.rs): panels, controls, the primary action and the selected card, each its own
strength. Panels (game settings, Settings, the VR setup) show over the art alone; the sidebar, the runtime
switch, the launcher buttons and the empty library pages are glass too.
A veil under the glass evens a bright or dark desktop toward the theme, and the footer's, search field's and
runtime switch's quiet text is white on glass. The launcher button and its options are one capsule again, the
docked sidebar's glass runs to the window's bottom with the footer beside it, the shelf's arrows draw over the
cards, panels are deep glass, and the hero's art follows the window's width while it is resized.
The theme's page color and accent tint the glass (veil, panels, controls, deep glass), and a selected surface
glows the accent (electric blue on the default theme). The sidebar is a pane of deep glass floating over the
page, wide enough to wrap the header's launcher button, with larger rows. The primary action carries its own
light over the glass, which darkens itself over bright art. The shelf's previous arrow stays at its left.
Under Liquid Glass the sidebar is a pane of glass beside the page (never over it), as wide as the header's
launcher button reaches; the footer is a bar of glass across the window's bottom; the Logs page has no fill
of its own.
The primary action is the theme's accent, lit, with text that reads on it; the header's and hero's controls
and the footer carry a wash of the accent over their glass. The footer is the sidebar's glass. The window
stops at 720x640, and a narrow sidebar says Programs.
…elected

The launcher button's label no longer depends on the width the sidebar leaves the page (the sidebar ends
where that button does: the two chased each other). A glass view is moved only when its place changes, so a
turned card's frame no longer keeps AppKit rebuilding the window's mouse tracking. The primary action's light
is GPUI's alone, and the launcher capsule's hover follows its shape.
It scales in both directions together (NSWindow.contentAspectRatio, 720:640), so widening it at its smallest
height no longer squashes the shelf's cards.
The shelf's cards are sized by the width they share, but no taller than the hero's minimum leaves them; with
the cards at their smallest, the hero gives up the rest down to what its title and buttons need. Widening the
window at its smallest height no longer pushes the cards under the footer.
The spacing and the hero's minimum ease toward their compact values over the 240 points of height before
compact turns on, instead of jumping there: the jump gave the cards room back mid-shrink, and they grew.
Five cards, and up to four more on each side where the window has the room (LibraryLayout::dock_slots, always
odd); paging, the arrows and the arch follow that count.
The shelf takes the height the hero leaves, so it always reaches the footer, and a surface's glass is clipped
to what clips its element (a scrolling page), so it never shows under the footer.
Under Liquid Glass the graphics route, theme, launcher, art and collection menus are deep glass under a veil
of the theme's menu color. The shelf's arrows are 46 by 80.
A download is removed once the runtime is installed from it, instead of staying in downloads/ as a second
copy; at start, a download from another MetalSharp Wine release and an app an interrupted swap set aside
(<app>.old) are removed. With no download, the installed app of this release is its own source, so the
runtime switch and setup still find it.
@aaf2tbz
aaf2tbz merged commit f06931e into main Nov 18, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant