AssetRipper_AssetRipper/docs/articles/RunningOnMac.md

Running AssetRipper on macOS

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

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 releases page.

2. Choose the AssetRipperGUI_mac64.zip file.

   

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 AssetRipperGUI_mac64.

   

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

   

Step 3: Open Terminal in the AssetRipper Folder

1. Select the AssetRipperGUI_mac64 folder.

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

   

Step 4: Run AssetRipper

1. In the Terminal, enter the following command:

./AssetRipper

2. You may encounter a "Permission denied" error.

3. To fix this, enter the following command:

chmod +x AssetRipper

4. Now, try running AssetRipper again:

./AssetRipper

Step 5: Handle Security Prompts

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

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

5. Run the ./AssetRipper command again in Terminal.
6. Click "Open" when prompted.

7. 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 AssetRipperGUI_mac64 folder.
2. Double-click the AssetRipper file to launch the application.

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