macOS Guide

Fully supported - a couple of Gatekeeper quirks to know about.

← All guides

Standalone app (recommended)

Grab TS4RLS-macos.zip from the Releases page, unzip it, and drag TS4RLS.app wherever you like - no Python install needed.

Gatekeeper

The app isn't notarized or code-signed, so macOS will refuse to open it with a plain double-click the first time ("TS4RLS.app" can't be opened because Apple cannot check it for malicious software"). Either:

  • Right-click (or Control-click) the app → Open, then confirm Open in the dialog that appears - only needed once.
  • Or clear the quarantine flag from a terminal: xattr -d com.apple.quarantine /path/to/TS4RLS.app

Running from source

git clone https://github.com/TS4RLS/Engine.git
cd Engine
pip install -r requirements.txt
python gui.py

Install Python 3 first if you don't have it - Homebrew's brew install python-tk is the easiest route (the plain python formula doesn't include Tkinter, which the GUI needs). Add --generate to run headlessly (one-shot, no GUI) instead.

Finding your Mods folder

TS4RLS tries to guess your Sims 4 Mods folder automatically (~/Documents/Electronic Arts/The Sims 4/Mods) when you first open the Build tab. If it's somewhere else, browse to it manually - it's wherever your game actually reads mods from.