Add System Audio/BlackHole setup guide to README

README.md

@@ -20,10 +20,37 @@ Hearbit AI is a powerful macOS desktop application designed to record system and
 ## Installation
 
 1.  Download the latest release (`.dmg` or `.app`).
-2.  Drag **Hearbit AI** to your `Applications` folder.
+## Recording System Audio (Teams, Zoom, etc.)
-3.  (Optional) To record system audio, install the [BlackHole 2ch Driver](https://existential.audio/blackhole/).
 
-## Usage
+To record meetings from apps like Microsoft Teams, Zoom, or Google Meet, you need to route the computer's audio into Hearbit AI. This requires **BlackHole 2ch**.
+
+### 1. Install BlackHole
+1.  Download and install [BlackHole 2ch](https://existential.audio/blackhole/).
+2.  Restart your computer if required.
+
+### 2. Create a Multi-Output Device (To hear audio while recording)
+1.  Open **Audio MIDI Setup** (search in Spotlight).
+2.  Click the `+` icon and select **Create Multi-Output Device**.
+3.  Check **BlackHole 2ch** AND **MacBook Pro Speakers** (or your headphones).
+4.  Set "Master Device" to **BlackHole 2ch**.
+    
+    ![Multi-Output Setup](docs/screenshots/multi_output_setup.png)
+
+### 3. Create an Aggregate Device (For Hearbit AI Input)
+1.  In Audio MIDI Setup, click `+` and select **Create Aggregate Device**.
+2.  Name it "Hearbit-AI" (or similar).
+3.  Check **BlackHole 2ch** AND **MacBook Pro Microphone**.
+4.  Ensure "Drift Correction" is enabled for the Microphone.
+
+    ![Aggregate Device Setup](docs/screenshots/aggregate_device_setup.png)
+
+### 4. Setup in Hearbit AI
+1.  Open **Hearbit AI**.
+2.  In the **Input Device** dropdown, select your Aggregate Device (e.g., "Hearbit-AI").
+3.  Start Recording.
+
+### 5. Setup in Teams/Zoom
+*   Set your **Speaker** output in Teams/Zoom to the **Multi-Output Device** you created in Step 2.
 
 1.  **Configure**:
     *   Click the **Settings** (gear icon) in the top right.