ContextQMD
Back to Assetripper

Running AssetRipper on macOS

docs/articles/RunningOnMac.md

1.3.143.0 KB
Original Source

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.

Step 2: Extract the Archive

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

  2. You should now see a folder named AssetRipper_mac_arm64.

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

Step 3: Open Terminal in the AssetRipper Folder

  1. Select the AssetRipper_mac_arm64 folder.

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

Step 4: Run AssetRipper

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

  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.

  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.

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

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

Step 6: AssetRipper GUI

After completing these steps, the AssetRipper GUI should open:

Reopening AssetRipper

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

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

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