Files
hearbit-ai-app/README.md

4.1 KiB

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.

App Icon

Features

  • 🎙️ Dual-Channel Recording: seamlessly capture your voice and meeting audio from apps like Microsoft Teams, Zoom, or Google Meet.
  • 📅 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

1. Prerequisites

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! Hearbit AI includes a built-in helper to set up your audio devices.

  1. Open Audio MIDI Setup: Click the "Open Audio MIDI Setup" button in the recorder view.
  2. Create "Hearbit Audio" Device:
    • If you don't have a virtual device, click "🪄 Create Hearbit Audio Device" in the app (appears in Meeting mode if no device is found).
    • This will automatically configure a Multi-Output Device so you can record and hear at the same time.
  3. Select "Hearbit Audio" in Teams/Zoom:
    • In your meeting app settings (Teams/Zoom), set your Speaker to Hearbit Audio.
    • In Hearbit AI, select Hearbit Audio (or BlackHole) as your 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.

👨‍💻 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.