Skip to content

Instantly share code, notes, and snippets.

@Sal7one
Last active August 21, 2025 18:07
Show Gist options
  • Save Sal7one/9a7ee3d98b5ba71bd38781da12695544 to your computer and use it in GitHub Desktop.
Save Sal7one/9a7ee3d98b5ba71bd38781da12695544 to your computer and use it in GitHub Desktop.
Heroic games launcher external drive, games updating, permissions, mac os

⚠️ WARNING: This process can affect your Heroic game installs. In rare cases, if paths/manifests are broken, you may need to repair or reinstall a game. Proceed carefully and back up anything important first.


1. Identify your external drive

Run:

    diskutil list

Look for your external disk (usually marked as "external, physical"). Example:

    /dev/disk4 (external, physical)
        #:                       TYPE NAME       SIZE       IDENTIFIER
        2:                  Apple_HFS Backup     500.0 GB   disk4s2

In this example, the identifier is `disk4s2` and the volume name is `Backup`. or `Game Library external drive`.


2. Enable ownership on the drive

🔹 Replace "Backup" with your actual volume name.

sudo vsdbutil -d /Volumes/Backup

3. Unmount + remount

diskutil unmount /Volumes/Backup
diskutil mount /Volumes/Backup

If the volume does not remount automatically, mount it by identifier:

diskutil mount /dev/disk4s2   # replace with YOUR identifier

4. Create Heroic library folder

mkdir -p "/Volumes/Backup/Games/Heroic"

5. Fix ownership and permissions

🔹 Replace USERNAME with your macOS username (find it with `whoami`).

sudo chown -R USERNAME:staff "/Volumes/Backup/Games/Heroic"
chmod -R u+rwX,g+rwX "/Volumes/Backup/Games/Heroic"

6. Verify everything

mount | grep "/Volumes/Backup"
ls -ldOe "/Volumes/Backup/Games/Heroic"

✅ After this, in Heroic go to Settings → Game Install Path and set it to: /Volumes/Backup/Games/Heroic

⚠️ If Heroic still shows a game as "installed" but the folder doesn’t exist, that’s when you may need: legendary uninstall -y to clear the broken entry (this will require a reinstall of that game only).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment