Running AssetRipper on macOS

⚠️ Disclaimer: The project developer does not have access to a Mac. This guide is community-contributed and might be outdated.

This guide will help you run AssetRipper on macOS. Before proceeding, ensure you have all the necessary requirements.

Running the GUI Version

Step 1: Download AssetRipper

  1. Download the GUI release from the AssetRipper downloads page.

  2. Choose AssetRipper_mac_x64.zip or AssetRipper_mac_arm64.zip, depending on your computer architecture. M2 processors are arm64.

    Download AssetRipper

Step 2: Extract the Archive

  1. Right-click the downloaded file and select "Open" to extract its contents.

    Extract AssetRipper

  2. You should now see a folder named AssetRipper_mac_x64.

    AssetRipper folder

  3. Inside this folder, you'll find various files, including the AssetRipper executable.

    AssetRipper contents AssetRipper executable

Step 3: Open Terminal in the AssetRipper Folder

  1. Select the AssetRipper_mac_x64 folder.

  2. Go to Finder > Services > New Terminal at Folder.

    Open Terminal

Step 4: Run AssetRipper

  1. In the Terminal, enter the following command:
./AssetRipper.GUI.Free
  1. You may encounter a "Permission denied" error.

Permission denied

  1. To fix this, enter the following command:
chmod +x AssetRipper.GUI.Free
  1. Now, try running AssetRipper again:
./AssetRipper.GUI.Free

Step 5: Handle Security Prompts

  1. You may see a security prompt. Click "Cancel" for now.

Security prompt

  1. Open System Preferences (⌘ + Space, search for "System Preferences").
  2. Go to "Security & Privacy" > "General" tab.
  3. At the bottom, click "Allow Anyway" for AssetRipper.

Allow AssetRipper

  1. Run the ./AssetRipper.GUI.Free command again in Terminal.
  2. Click "Open" when prompted.

Open AssetRipper

  1. You may see additional security prompts. Click "OK" and allow them as needed.

Additional prompts More prompts

Step 6: AssetRipper GUI

After completing these steps, the AssetRipper GUI should open:

AssetRipper GUI

Reopening AssetRipper

Once you've gone through the initial setup, you can easily reopen AssetRipper:

  1. Navigate to the AssetRipper_mac_x64 folder.
  2. Double-click the AssetRipper.GUI.Free file to launch the application.

Reopen AssetRipper

Congratulations! You've successfully set up and run AssetRipper on macOS.

AssetRipper running