> ## Documentation Index
> Fetch the complete documentation index at: https://docs.facebetter.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Install on Mac

> Install the Facebetter OBS plugin on a Mac.

Facebetter is a realtime beauty filter for OBS Studio. Skin, face shape, makeup, color filters, stickers, body, and background are processed on this computer.

It does not affect the whole OBS window by itself. Add **Facebetter Beauty** to the source you want, and the sliders in the side panel start working. A camera, image, or video source all work.

The OBS screenshots on these pages use the English interface. The installer screenshots use Chinese macOS. The English names of those buttons are in the steps below.

Before you start:

* macOS 13 or later. Use the Intel build of OBS on an Intel Mac, and the Apple silicon build on Apple silicon.
* OBS Studio 28 or later, 64-bit.

Download: [facebetter.net/obs](https://facebetter.net/obs). For Windows, see [Install on Windows](/obs/install-windows).

## Download and unzip

Download the macOS zip and double-click it. Inside are the installer `Facebetter-OBS-*-macos-universal.pkg` and two short guides, `README.zh.txt` and `README.en.txt`.

<Frame>
  <img src="https://mintcdn.com/facebetter/8-QG_hBISFqsZt9s/images/obs/pkg.png?fit=max&auto=format&n=8-QG_hBISFqsZt9s&q=85&s=68d6100a34993f54c2565446c870cb99" alt="Unzipped installer and readme files" width="1458" height="430" data-path="images/obs/pkg.png" />
</Frame>

Quit OBS completely first, including the OBS icon in the menu bar. If OBS is running during install, that session will not load the new plugin.

## If macOS says the package cannot be opened

The package is not notarized yet. The first double-click is often blocked. The dialog title is “未打开” (the package was not opened) and one button is “移到废纸篓” (Move to Trash).

<Frame>
  <img src="https://mintcdn.com/facebetter/8-QG_hBISFqsZt9s/images/obs/gatekeeper.png?fit=max&auto=format&n=8-QG_hBISFqsZt9s&q=85&s=6fd5b0f39a16452fe0c97a88cd4d6d4e" alt="macOS cannot verify the package. Do not move it to the Trash." width="648" height="610" data-path="images/obs/gatekeeper.png" />
</Frame>

<Warning>
  Click Done (完成). Do not click Move to Trash (移到废纸篓).
</Warning>

Then:

1. Open System Settings → Privacy & Security (系统设置 → 隐私与安全性).
2. Scroll to the Security section and find the row that says Facebetter was blocked to protect the Mac.
3. Click Open Anyway (仍要打开).

<Frame>
  <img src="https://mintcdn.com/facebetter/8-QG_hBISFqsZt9s/images/obs/privacy.png?fit=max&auto=format&n=8-QG_hBISFqsZt9s&q=85&s=a176a1f4037583dbec919413e7e3012b" alt="Open Anyway in Privacy and Security" width="1446" height="1626" data-path="images/obs/privacy.png" />
</Frame>

After you confirm, the installer continues. You can also Control-click the pkg, choose Open, and click Open again in the confirmation dialog.

## Finish the installer

The first installer page is the introduction. Click Continue (继续).

<Frame>
  <img src="https://mintcdn.com/facebetter/8-QG_hBISFqsZt9s/images/obs/install-intro.png?fit=max&auto=format&n=8-QG_hBISFqsZt9s&q=85&s=b1c41a48b0246358efdb877266a803e4" alt="Installer introduction" width="1240" height="896" data-path="images/obs/install-intro.png" />
</Frame>

On the disk confirmation page, click Continue again. On Installation Type (安装类型), keep the default and click Install (安装). Do not click Change Install Location (更改安装位置). The plugin is installed for the current user only. Other accounts on this Mac are left alone.

<Frame>
  <img src="https://mintcdn.com/facebetter/8-QG_hBISFqsZt9s/images/obs/install-type.png?fit=max&auto=format&n=8-QG_hBISFqsZt9s&q=85&s=10564b986103e00a370d028baf0777e4" alt="Installation type page. Click Install." width="1240" height="896" data-path="images/obs/install-type.png" />
</Frame>

macOS may ask for your password or Touch ID. When it finishes, the plugin is here:

```text theme={null}
~/Library/Application Support/obs-studio/plugins/facebetter.plugin
```

Open OBS, then [sign in and add the filter](/obs/login).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.