79db6adf45
- Add MP3 conversion and chunking for files >18MB - Support meetings up to 2+ hours - Add email button directly in history view - Implement custom logo upload in Settings for white-labeling - Add read_image_as_base64 Rust command - Update README with new features and ffmpeg requirement
152 lines
5.6 KiB
Markdown
152 lines
5.6 KiB
Markdown
# 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](https://existential.audio/blackhole/))
|
|
* **MANDATORY** for system audio capture (MS Teams, Zoom, etc.)
|
|
* Without this, you can only record microphone input
|
|
* **ffmpeg** for audio processing
|
|
```bash
|
|
brew install ffmpeg
|
|
```
|
|
* **Infomaniak AI Account**: You need an API Key and Product ID from the [Infomaniak Developer Portal](https://manager.infomaniak.com/).
|
|
|
|
### 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:
|
|
```bash
|
|
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
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
### Run Locally
|
|
```bash
|
|
npm run tauri dev
|
|
```
|
|
|
|
### Build for Production
|
|
```bash
|
|
npm run tauri build
|
|
```
|
|
*The build artifact will be located in `src-tauri/target/release/bundle/dmg/*`*
|
|
|
|
---
|
|
|
|
## 📄 License
|
|
Property of Livtec. All rights reserved.
|