diff --git a/README.md b/README.md index 1c350f8..5ad51ab 100644 --- a/README.md +++ b/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. -3. (Optional) To record system audio, install the [BlackHole 2ch Driver](https://existential.audio/blackhole/). +## Recording System Audio (Teams, Zoom, etc.) -## 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. diff --git a/docs/screenshots/aggregate_device_setup.png b/docs/screenshots/aggregate_device_setup.png new file mode 100644 index 0000000..f23a141 Binary files /dev/null and b/docs/screenshots/aggregate_device_setup.png differ diff --git a/docs/screenshots/multi_output_setup.png b/docs/screenshots/multi_output_setup.png new file mode 100644 index 0000000..55f28a4 Binary files /dev/null and b/docs/screenshots/multi_output_setup.png differ