From d266de942a582579c522ca36085406be8a84b601 Mon Sep 17 00:00:00 2001
From: "michael.borak" <michael.borak@isuit.ch>
Date: Tue, 20 Jan 2026 10:22:29 +0100
Subject: [PATCH] docs: add troubleshooting for app damaged error

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 282b35f..93b48ba 100644
--- a/README.md
+++ b/README.md
@@ -75,6 +75,21 @@ To record clear meeting audio from other applications, you need a "virtual cable
 
 ---
 
+## ❓ Troubleshooting
+
+### "Hearbit AI is damaged and can't be opened"
+This is a standard macOS warning for apps not signed with an Apple Developer Certificate. To fix it:
+
+1.  Open **Terminal**.
+2.  Run the following command:
+    ```bash
+    sudo xattr -cr /Applications/Hearbit\ AI.app
+    ```
+3.  Enter your password.
+4.  Open the app again.
+
+---
+
 ## 👨‍💻 Development
 
 Built with **Tauri**, **React**, and **TypeScript**.