hearbit-ai-app/README.md

Hearbit AI 🦉🎙️

Hearbit AI is your professional meeting assistant for macOS. It records both your microphone and system audio (e.g., Teams, Zoom), transcribes it with high precision using Infomaniak's Whisper API, and generates intelligent, structured summaries.

✨ Features

• 🎙️ Dual-Channel Recording: seamlessly capture your voice and meeting audio from apps like Microsoft Teams, Zoom, or Google Meet.
• 📁 Import Audio Files: Upload existing recordings (MP3, MP4, WAV, M4A, FLAC, OGG, AAC, WMA) for transcription and summarization.
• ⏱️ Long Meeting Support: Record meetings up to 2+ hours with automatic MP3 conversion and chunking.
• 🎵 Smart Auto-Stop:
  • Voice Memo Mode: Automatically stops after 20 seconds of silence
  • Meeting Mode: No auto-stop to capture full discussions
• 📅 Microsoft 365 Integration:
  • Upcoming Meetings: View your daily schedule and join with one click.
  • Meeting Details: View full agenda and invited attendee status (Accepted/Declined).
• 💾 Persistent History: Automatically saves all transcripts and summaries to disk. Search and review past meetings anytime.
• ✉️ Email Summaries: Send professional, formatted HTML summaries (with preview) directly to attendees via your own SMTP server.
• 🧠 Powered by Infomaniak AI:
  • Precision Transcription: Standard-compliant formatting with second-by-second timestamps.
  • Smart Summaries: Uses Smart Templates to automatically select the best format (Business Protocol vs. 1:1) based on meeting content.
• 🔇 Smart VAD: Automatically filters out silence and stops recording when you stop talking.
• 🔒 Privacy-First: Data is processed securely via your own Infomaniak API keys.

---

🚀 Getting Started

Required

• macOS (tested on macOS Monterey and later)
• BlackHole 2ch Driver (Download here)
  • MANDATORY for system audio capture (MS Teams, Zoom, etc.)
  • Without this, you can only record microphone input
• ffmpeg for audio processing

  brew install ffmpeg
  

• Infomaniak AI Account: You need an API Key and Product ID from the Infomaniak Developer Portal.

2. Installation

1. Download the latest .dmg file from the Releases page.
2. Open the .dmg and drag Hearbit AI to your Applications folder.
3. Launch the app.

---

🎧 Recording System Audio (Teams, Zoom, etc.)

We've made this easy! Note: You must have the BlackHole driver installed.

1. Create "Hearbit Audio" Device:

   • Open the app and select Meeting mode.
   • If you don't have the device yet, click the "🪄 Create Hearbit Audio Device" button.
   • This creates a specialized "Multi-Output Device" that routes audio to both your headphones/speakers AND the app.

2. Configure Teams / Zoom / Webex:

   • Speaker / Output: Change this to Hearbit Audio.
     • Why? This ensures the audio goes to the recording app and your ears.
   • Microphone / Input: Leave this as your normal microphone (e.g., MacBook Pro Mic).
     • Note: Do not select Hearbit Audio as your microphone in Teams.

3. Start Recording:

   • In Hearbit AI, ensure Hearbit Audio is selected as the input.

---

🛠️ Usage Guide

1. Configuration:

   • Click the Settings (gear icon).
   • Enter your Infomaniak API Key and Product ID.

2. Connect M365 (Optional):

   • Copy the Application (client) ID.
   • Click the Meetings tab.
   • Enter your Client ID and click "Connect".
   • Proceed with MS login.
   • View your upcoming meetings.

3. Recording:

   • Choose your Template (e.g., "Meeting Protocol").
   • Select your Input Device.
   • Click Start Recording.

4. Processing:

   • Click Stop when finished.
   • The app will transcribe the audio (with timestamps!) and generate a summary based on your selected template.
   • You will be automatically taken to the Transcription tab to review the results.

---

❓ 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:

   sudo xattr -cr /Applications/Hearbit\ AI.app
   

3. Enter your password.
4. Open the app again.

Long Meetings (> 1 hour)

Automatic Handling: The app automatically handles long recordings:

• MP3 Conversion: All recordings are converted to MP3 (64kbps) for 10x compression
• Chunking: Files ≥18 MB are automatically split into 10-minute segments
• Processing: Each segment is transcribed separately and merged with timestamps

Example: A 2-hour meeting:

1. Records as WAV (~120 MB)
2. Converts to MP3 (~12 MB)
3. Stays under limit → No chunking needed!

Very long meetings (e.g., all-day workshops):

• Automatically chunks into segments
• Shows progress: "Processing chunk 1/15..."
• Merges all transcriptions seamlessly

No Audio / Can't Hear Meeting Participants

---

👨‍💻 Development

Built with Tauri, React, and TypeScript.

Setup

npm install

Run Locally

npm run tauri dev

Build for Production

npm run tauri build

The build artifact will be located in src-tauri/target/release/bundle/dmg/*

---

📄 License

Property of Livtec. All rights reserved.