Hydra 4.2.0 (macOS)

Unsigned macOS build of the Hydra fork (arm64 + x64). After installing, clear the quarantine attribute:

xattr -cr /Applications/Hydra.app

---

Epic Games integration is not available on macOS. v4.2.0 brings upstream's Epic support, but it is Linux/Windows-shaped: launches go through Legendary/umu with Wine prefixes. There is no macOS path for it, and this fork does not add one. Nothing to do on your side — just don't expect Epic to appear.

macOS keeps working as before: Windows games via CrossOver or Steam Play (NotProton), per-game CrossOver bottle settings, Wine-prefix cloud saves, real .app shortcuts, and update notifications pointed at this fork's releases.

Changes since v4.1.6-macos

5d77e97 macOS: Stub fork imports in upstream cloud-save context test
0d5a1d8 macOS: Document why test exclusions silently no-op
985748a macOS: Correct the Epic test hang workaround
58203d0 macOS: Document v4.2.0 sync and upstream Epic test failures
a22ec02 ci: remove epic prerequisite supervisor job (hydralauncher#2925)
f3b48fa ci: install Windows Rust target for Linux release build
b8e88c5 chore: update version to 4.2.0 in package.json
1b900e1 fix: stop Epic artwork retry loops and show linked achievement totals (hydralauncher#2921)
92c1105 fix(souvenirs): stop endless upload retries (hydralauncher#2902)
30f274f feat(chat): send images, report messages, and show hidden ones (hydralauncher#2918) (hydralauncher#2923)
d38a68f fix: use sync validity in Epic catalogue fallback
d139c29 fix(epic): keep Hydra auto sync off while Epic save sync is enabled
c54ab2b fix(epic): sync Hydra saves after the Linux prefix exists and serialize toggles
f361ac9 fix(epic): guard save comparison against running game and surface errors
42347f6 feat(epic): enable Hydra cloud save v2 for managed Epic games
c153aa6 feat(chat): add direct messages between friends (hydralauncher#2875)
cab6736 fix(epic): restore legendary error regex and merge duplicate imports
c7167f3 feat(epic): implement auto-import for Epic Games Store installations and add verification timeout
2c83409 fix(epic): skip save conflicts when remote matches local
8d8b840 fix: show catalogue achievements for empty Epic imports (hydralauncher#2917)
a056987 fix: refresh Epic library icons and no-logo artwork (hydralauncher#2913)
22f5662 test: cover busy reset DELETE retry
1a8d52c fix: bound achievement retry delays
86bc7ea refactor: retry reset delete recursively
27050e1 test(epic): name supervisor and process test wait budgets
11c0c0a fix(cloud-save): resolve the managed Epic prefix for Hydra Cloud on Linux
23bf385 fix: send legacy hardcore flag in achievement sync
142cacb refactor: drop achievement sync code comments
2be82b3 fix: retry busy achievement reset deletes
75d4bfd test: drop branch-only download tests
118f1fb fix: render Epic descriptions as sanitized Markdown (hydralauncher#2912)
a3bc1bc Merge pull request hydralauncher#2907 from hydralauncher/codex/steam-epic-achievement-union
13c78b3 fix(epic): finish sync without rechecking removed imports
511ced9 refactor(epic): name Legendary diagnostic tail limit
7031f45 test: stop fixture timers when responses end
84df508 fix(epic): select cloud saves by remote upload time
15978a9 fix(epic): request reconnection for revoked sessions
44d8eec fix(epic): animate account disconnection progress
3860b0f fix(game-details): launch selected copy without store selection modal
ff5f9db fix(library): share game projections across sidebar rows and menus
7bd7a1e fix(cloud-save): expose Epic V2 saves without legacy controls
5c3f399 fix: let prepared transfers run during extraction
c4490df docs(epic): remove obsolete sync and cloud save specifications
f3939f5 fix(epic): retain and retry failed Linux preparation cleanup
ce1517e fix: adjust min-height for filter items on classics
b4e8637 fix(epic): advance the queue after accepted preparation fails
0fa5b2b fix(epic): retain Linux launch ownership through cancellation
5044b85 fix: preserve pending achievement work
72ca1f3 fix: preserve pending debrid queue positions
7cf795c fix: address follow-up download review
ea0bf81 fix(epic): report Linux launch failures and preserve translations
81c5fd6 fix(epic): preserve save cancellation after dependency update
57179a3 fix(epic): decouple Linux downloads from compatibility preparation
112157f fix(epic): tolerate exiting processes during Linux enumeration
043b859 fix(epic): avoid false Linux Wine prefix locks
6ed2c99 fix(epic): cancel connection capture before launch cleanup waits
3fc218f fix(epic): harden Linux validation and process guards
284edb4 fix(epic): retry closed session cleanup without repeating saves
387ae3b docs(epic): record Linux validation and dependency rebase
1082467 fix(epic): cancel queued Linux preparation and save work

Hydra 4.1.6-macos-experimental-4 (macOS)

Experimental build

Unsigned macOS build of the Hydra fork (arm64 + x64). After installing, clear the quarantine attribute:

xattr -cr /Applications/Hydra.app

Epic Games integration — not yet active

This build includes upstream's new Epic Games integration (connection flow in Settings, store artwork lookup, and Legendary-based launch support).

It will not connect yet. The integration requires a backend endpoint that Hydra's production API has not deployed:

• Client calls GET/POST/DELETE /profile/integrations/epic
• That route currently returns HTTP 404, so the app shows "Epic Games connections are unavailable on this Hydra server."

This is a server-side rollout gap, not a defect in this build. Verified directly against the live API:

Endpoint	Status	Meaning
/profile/integrations/steam	401	route exists, auth required
/profile/integrations/epic	404	route not deployed

No action needed. The feature will start working as soon as Hydra ships the Epic backend — no rebuild or update required on your side, since it is entirely server-side. Everything else in this build is unaffected: CrossOver per-game settings, NotProton Windows-game launching, Wine-prefix cloud saves, and macOS .app shortcuts all work as before.

Upstream sync

This build merges upstream main through 1d204b3d2, which brings the Epic Games integration, Linux Legendary rework, and assorted Epic store-metadata fixes. No merge conflicts were required manual resolution.

Your fork's version is unchanged at 4.1.6 to match upstream.

macOS fixes in this build

• Reverted the production sourcemap change — it saved no measurable load time (.map files are only fetched by DevTools) while making Sentry production stack traces and session replays unreadable. Sentry symbolication is working again.
• Release notes are now generated from the previous release tag rather than upstream/main, so upstream changes actually appear in the notes instead of being silently filtered out.
• Documented a local build:native toolchain blocker (see AGENTS.md) — the Rust native addon produced by Xcode 27 + Homebrew rustc 1.98.1 is rejected by dyld; this build reuses the CI-produced binaries, which come from byte-identical source.

---

Full changelog

Changes since v4.1.6-macos:

00ca1c0 macOS: Build release changelog from previous release tag
a8d6718 Revert "macOS: Disable production sourcemaps for faster renderer load"
af0c0b9 fix(epic): preserve artwork across partial failures and sync
6f5349d fix(epic): sanitize store links and reuse SGDB artwork
cc3043f macOS: Document local native build blocker and workarounds
bd3f613 chore: bump version to 4.1.6
f844575 fix(epic): sanitize summaries and preserve audio support
4af31a5 feat(epic): add external link icon to connection button in settings
d8147c2 feat(epic): add connection ID validation and enhance related tests
2f1c579 feat(epic): enhance timeout and output buffer configurations in legendary scripts
b6ac779 test: enhance EpicConnectionStore tests for error handling and invalid record recovery
52074b2 fix: add comments for chmod usage in downloadVerifiedArtifact function
4fdabda feat: implement trimTrailingSlashes function and update related tests
cdc0f25 fix: update Epic error messages and account validation
2b8f385 macOS: Disable production sourcemaps for faster renderer load
9cedbda fix(epic): identify the actual description locale
24ebd5e fix(epic): sanitize content and preserve details on media failures
eed0e4c feat(epic): load store details with API fallback
ff1d325 macOS: Confirm CI has no branch trigger so upstream/main sync is safe
499fc59 macOS: Remove branch push trigger from CI
dbe3cb6 ci: commit prebuilt torrent bridge binaries (hydralauncher#2878)
d58431e macOS: Auto-generate release changelog from commits
3c98ae1 macOS: Add agent context for the fork
0757b8c feat(epic): implement memory database and refactor store logic
751029c macOS: Merge upstream/main and fix formatting
d25be8a macOS: Support numbered experimental tags
2f0ff26 fix: use live progress for disk check and skip while verifying (hydralauncher#2870)
e48970a macOS: Show CrossOver settings in Big Picture mode
198b750 macOS: Log CrossOver bottle settings applied at launch
8d11c17 feat: enhance Epic integration with vault availability checks and update settings UI
f678f1a feat: add integration logos for Epic Games and Steam
0d47fa9 fix(cloud-save): let RPCS3 game data restores create a missing game directory
a949704 chore: enhance Linux Legendary integration with runtime scripts and resources
ccedb96 chore: remove user data core service and associated tests
b84992e chore: remove Legendary GitHub Actions workflow
d8583e9 test: remove deprecated Legendary test files
7cb38c6 test: enhance Linux Legendary tests with runtime hashing and symlink validation
f8a1879 test: add comprehensive tests for Linux Legendary preparation and authentication
bae7e47 macOS: Publish experimental tags as pre-releases
71fc4db macOS: Hide ray tracing setting on M1/M2 Macs
6f6b638 macOS: Streamline CrossOver settings layout
acca585 macOS: Add per-game CrossOver bottle settings
9cdf1e0 chore: update translations and .gitignore for Epic Games integration
4c4c3dd fix(cloud-save): restore RPCS3 saves into users missing on this machine
0dbbd5b chore: integrate Legendary support into the build process
a3ad495 fix(launcher): polish compatibility setup status
894fb1f fix(linux): report umu exits before game detection and show setup early
0569991 fix(launcher): mark fire-and-forget window IPC calls as ignored
9f50d3d fix(linux): address umu launcher review feedback
b1e9f89 fix(linux): keep launcher ready once the game is running
5c81f42 fix(linux): address umu setup review feedback
a7a6d5b fix(linux): update umu-launcher and surface runtime setup progress
cfe770e macOS: Point update notifications at fork releases
2982fef macOS: Link prebuilt releases from README
ac16d62 macOS: Document release process and fork workflow disabling
9c37ff7 macOS: Add tag-triggered release automation
70437e0 feat(cloud-save): sync RPCS3 game data profiles and keep saves per PS3 user

Hydra 4.1.6-macos-experimental-3 (macOS)

Unsigned macOS build of the Hydra fork (arm64 + x64). After installing, clear the quarantine attribute:

xattr -cr /Applications/Hydra.app

Hydra 4.1.6-macos-experimental-2 (macOS)

Unsigned macOS build of the Hydra fork (arm64 + x64). After installing, clear the quarantine attribute:

xattr -cr /Applications/Hydra.app

Hydra 4.1.6-macos-experimental (macOS)

Unsigned macOS build of the Hydra fork (arm64 + x64). After installing, clear the quarantine attribute:

xattr -cr /Applications/Hydra.app

Hydra 4.1.6 (macOS)

Hydra 4.1.6 for macOS

Unsigned macOS build of the macOS fork of Hydra Launcher. Both Apple Silicon and Intel builds are attached.

Note: builds are unsigned and not notarized. After installing, run:

xattr -cr /Applications/Hydra.app

Downloads

File	Architecture	Notes
Hydra-4.1.6-arm64.dmg	Apple Silicon	Recommended for M-series Macs
Hydra-4.1.6-x64.dmg	Intel	Runs natively on Intel Macs
Hydra-4.1.6-arm64-mac.zip	Apple Silicon	Zip, if you prefer not to use the DMG
Hydra-4.1.6-mac.zip	Intel	Zip, if you prefer not to use the DMG

SHA256SUMS.txt contains checksums for every asset.

What's different from upstream Hydra

• Windows games on macOS — run .exe titles through Steam Play / NotProton, CrossOver, or Bottles, with automatic runtime detection.
• CrossOver & Bottles support — detects your bottles and reuses their Wine prefixes.
• Wine-prefix cloud saves — cloud saves are mapped to the correct Windows prefix (cloud-save-platform).
• Real macOS application shortcuts — "Create Application Shortcut" writes a proper .app bundle that relaunches the game through Hydra.
• Automatic Steam shortcuts — non-Steam Windows games get Steam shortcuts wired to the right prefix.
• DMG, zip, and .app bundle layout as documented in docs/macos.md.

Staying in sync with upstream

The main branch mirrors upstream, and macos-native carries the macOS changes. To pull in upstream updates:

git fetch upstream
git checkout main && git merge --ff-only upstream/main
git checkout macos-native && git merge main

---

All code changes live on the macos-native branch. This release was cut from commit 0e6a69e7.