Skip to content

Unrestricted Open-source alternative to AI video platforms — Free AI image & video generation studio with 600+ models (Flux, Midjourney, Kling, Sora, Veo). No content filters. Self-hosted, MIT licensed.

Add macOS and Windows installation troubleshooting to README

Anil Matcha71a53c945168
diff --git a/README.md b/README.md
index f885eaa3..7f98b064 100644
--- a/README.md
+++ b/README.md
@@ -12,11 +12,37 @@ One-click installers — no Node.js or terminal required.
| macOS Intel (x64) | [Open Higgsfield AI-1.0.0.dmg](https://github.com/Anil-matcha/Open-Higgsfield-AI/releases/download/v1.0.0/Open.Higgsfield.AI-1.0.0.dmg) |
| Windows (x64 + ARM64) | [Open Higgsfield AI Setup 1.0.0.exe](https://github.com/Anil-matcha/Open-Higgsfield-AI/releases/download/v1.0.0/Open.Higgsfield.AI.Setup.1.0.0.exe) |
-> **macOS:** If you see an "unidentified developer" warning, right-click the app → **Open**.
-> **Windows:** If SmartScreen warns, click **More info → Run anyway**.
-
All releases: [github.com/Anil-matcha/Open-Higgsfield-AI/releases](https://github.com/Anil-matcha/Open-Higgsfield-AI/releases)
+### macOS Installation — "damaged and can't be opened" fix
+
+Because the app is not code-signed, macOS Gatekeeper will block it with a **"damaged and can't be opened"** message. This is expected — the file is fine. Fix it with one Terminal command:
+
+**Step 1** — Open the DMG (it will mount even if the warning appears)
+
+**Step 2** — Open Terminal and run:
+```bash
+xattr -cr "/Volumes/Open Higgsfield AI/Open Higgsfield AI.app"
+```
+
+**Step 3** — Drag the app to `/Applications`, then open it normally.
+
+If you already copied it to Applications before running the command:
+```bash
+xattr -cr "/Applications/Open Higgsfield AI.app"
+```
+
+> Alternatively: after attempting to open, go to **System Settings → Privacy & Security** → scroll down → click **"Open Anyway"**.
+
+### Windows Installation — SmartScreen warning fix
+
+Windows SmartScreen may show a warning because the installer is not code-signed:
+
+1. Click **More info** on the SmartScreen dialog
+2. Click **Run anyway**
+
+The app will install silently to `%LocalAppData%` with a Start Menu shortcut.
+
---
Open Higgsfield AI is an open-source AI image, video, cinema, and lip sync studio that brings Higgsfield-style creative workflows to everyone. Powered by [Muapi.ai](https://muapi.ai), it supports text-to-image, image-to-image, text-to-video, image-to-video, and audio-driven lip sync generation across models like Flux, Nano Banana, Midjourney, Kling, Sora, Veo, Seedream, Infinite Talk, LTX Lipsync, Wan 2.2, and more — all from a sleek, modern interface you can self-host and customize.