EDHM-UI for Mac is an independent macOS/CrossOver fork of EDHM_UI, the configuration and theme manager for EDHM in Elite Dangerous. The repository remains named EDHM-UI-Mac.
It is intended for macOS users running the Windows game through CrossOver. EDHM-UI for Mac itself runs natively on macOS; it is not installed or run inside the Wine prefix (CrossOver bottle). It is not an official upstream macOS release.
Using EDHM with CrossOver Preview on Apple Silicon? Download the experimental ARM64EC DXMT package. It is for ARM/FEX bottles and installs into a separate CrossOver app copy.
The 3.1.5 release renames the app to EDHM-UI for Mac and retains the refreshed 3.1.4 audit fixes. It selectively integrates upstream EDHM_UI fixes reviewed through commit b31f65a (v3.0.74 era) and bundles Odyssey EDHM v22.04 for the Anaconda Mk II game update. Version 3.1.3 remains available with EDHM v22.02 for rollback. macOS/CrossOver paths, themes, TPMods, native UI, and signed/notarized packaging are preserved.
The product branch is macos; main mirrors upstream EDHM-UI. This repository is a fork/adaptation, not an official upstream macOS release. Upstream project and mod credits remain with Blue Mystic, psychicEgg, and the EDHM contributors.
Download the ZIP for your Mac from the GitHub Releases:
- arm64 — Apple Silicon Macs (M-series)
- x64 — Intel Macs
Version 3.1.5 provides separate architecture-specific downloads rather than a universal ZIP. The arm64 build is launch-tested locally; x64 packaging, signing, and notarization are verified, but Intel hardware testing remains separate. The older 3.1.4 universal release remains available.
Releases are Developer ID signed, Apple-notarized, and stapled. After unzipping, move EDHM-UI for Mac.app to Applications and open it normally in Finder. Quit the old EDHM-UI-Mac.app before upgrading. The new name does not change the bundle identifier, Electron storage identity, settings, themes, or cache paths. Keep only the desired app copy in Applications to avoid launching the old version accidentally.
- macOS
- CrossOver with Elite Dangerous installed in a CrossOver bottle (Wine prefix)
- Elite Dangerous Horizons or Odyssey installed through CrossOver
- The game must remain a Windows installation; do not copy it to a native macOS location
| Component | Location |
|---|---|
| EDHM-UI for Mac application | Native macOS app, outside the bottle |
| Elite Dangerous | Windows executable inside the CrossOver bottle |
| EDHM files and DLLs | The Elite game directory inside drive_c |
| EDHM-UI for Mac settings/themes | ~/Library/Application Support/EDHM-UI-V3 |
| EDHM-UI for Mac cache/temp files | ~/Library/Caches/EDHM-UI-V3 |
- Install and launch Elite Dangerous through CrossOver once.
- Launch the native EDHM-UI for Mac app.
- Open Settings.
- Set the following independently:
- Game folder — the folder containing
EliteDangerous64.exeinside the bottle. - CrossOver Bottle Root — the CrossOver bottle folder containing
drive_canduser.reg. - Player Journal Location — the folder containing the Elite
Journal.*.logfiles. - Graphics Config XML Folder — the folder containing
GraphicsConfiguration.xmland/orGraphicsConfigurationOverride.xml.
- Game folder — the folder containing
- You can browse to the executable manually, or use the localization assistant while Elite is running at the main menu. The assistant can infer the bottle root from the running CrossOver process.
The usual bottle layout resembles:
<your bottle>/drive_c/Program Files (x86)/Frontier/EDLaunch/Products/elite-dangerous-odyssey-64
Do not assume this exact path; select the path belonging to your own bottle.
- Close Elite Dangerous.
- In EDHM-UI for Mac, select the configured game instance.
- Choose Install EDHM.
- Confirm the CrossOver bottle and game paths.
- The installer copies the bundled EDHM files, creates the required CrossOver-safe links for
EDHM-iniandShaderFixes, installs themes, and configures the CrossOver DLL overrides when possible.
The installer uses temporary extraction and copies through symlink targets. This is intentional and avoids the macOS/CrossOver failure where archive extraction treats EDHM-ini as “not a directory”.
For the tested CrossOver configuration, set these bottle-level overrides to:
d3d11 native,builtin
d3dcompiler_47 native,builtin
EDHM-UI for Mac can configure these from the EDHM DLL override control in Settings. Restart CrossOver/Elite after changing them. These are bottle-level settings and may affect other Windows programs in that bottle; uninstalling EDHM does not remove them automatically.
The tested working renderer is DXMT. D3DMetal may launch Elite, but EDHM themes did not apply reliably and could crash in the tested bottle. Steam/Epic launcher combinations and other CrossOver bottles still need separate validation.
- Start Elite and leave it at the menus when testing setup.
- Select a theme in EDHM-UI for Mac and choose Apply Theme.
- Theme selection supports mouse and keyboard navigation: Arrow keys, Home, End, and Enter.
- The app now reports EDHM status and can enable/disable the paired EDHM proxy DLLs without uninstalling the mod.
- Install TPMods from the TPMods manager after EDHM has been installed for the selected game instance.
Do not delete the CrossOver bottle's unrelated DXMT backup/version files. EDHM uninstall removes EDHM-owned files but intentionally preserves CrossOver DLL override configuration.
This package is the native macOS build and should not need Wine rendering flags. If you are running the Windows EDHM-UI executable inside CrossOver, use:
--use-angle=swiftshader --enable-unsafe-swiftshader --in-process-gpu --no-sandbox
Those flags are automatically applied by the Windows build when it detects Wine/CrossOver; they are not applied to the native macOS app.
- Confirm Elite is fully closed before installing or toggling EDHM.
- Confirm
d3d11andd3dcompiler_47arenative,builtinin the correct CrossOver bottle. - Use DXMT rather than D3DMetal for the tested setup.
- Verify that the selected game folder is the one containing
EliteDangerous64.exe. - Reinstall EDHM from the app if the DLL pair or symlink targets are incomplete.
Re-open Settings and select the actual host-side folders. The game folder, journal folder, graphics XML folder, and bottle root are separate inputs.
The current Electron/Vue source is in source_v3. Development builds use Node 22:
cd source_v3
npm install
npx -y -p node@22 -c 'npm run make'This project remains licensed under GPL-3.0+.
This optional DXMT ARM64EC release is for Apple Silicon users running Elite through a CrossOver Preview ARM/FEX bottle with EDHM/3Dmigoto. It packages unmodified upstream DXMT 50102f99 with NVAPI/NGX enabled. The maintainer reports this build working; it remains experimental, not an official or general compatibility guarantee.
It does not replace DXMT files in your bottle or your installed CrossOver app. Instead, its installer creates a separate app copy in ~/Applications with the matched Windows and Unix DXMT modules.
Use the matched Windows and Unix modules supplied by the installer. A DXGI-only override is not the supported deployment for this package. Never overwrite EDHM's game-local d3d11.dll with DXMT's DLL. The native UI and DXMT are separate downloads.
-
Fully quit Elite and CrossOver.
-
Download
dxmt-arm64ec-edhm-crossover-50102f99-nvext.zipand verify it with the accompanying.sha256file. -
Unzip it and run:
cd dxmt-arm64ec-edhm-crossover-50102f99-nvext ./install-dxmt-arm64ec-crossover.sh "/Applications/CrossOver Preview.app"
-
Launch your existing ARM bottle using the new
CrossOver Preview DXMT 50102f99 ARM64EC NVEXT.appcopy in~/Applications. -
For native Retina resolution reporting, import the included
enable-wine-retina-mode.reginto that bottle, then restart the bottle. -
Ensure the EDHM bottle overrides remain
d3d11=native,builtinandd3dcompiler_47=native,builtin.
To roll back, quit CrossOver and delete the copied DXMT CrossOver app; the original CrossOver installation and bottle DLLs are unchanged. See the full package instructions for requirements, provenance, troubleshooting, and rollback details.