RATT — Record All The Time

A native Mac menu bar app that continuously records audio, transcribes locally using Whisper, and saves daily markdown files. All processing is local — no cloud dependencies.

Features

• Continuous recording via menu bar icon (green=recording, yellow=paused, red=error)
• Local transcription using WhisperKit (Apple Silicon optimized, ~30s latency)
• Daily markdown files with YAML frontmatter at ~/Documents/RATT/YYYY/MM/YYYY-MM-DD.md
• Basic speaker detection with energy-based segmentation (Speaker 1, 2, 3)
• Calendar integration — annotates transcript segments with active meeting names
• Privacy-first — raw audio is never saved, only transcripts

Requirements

• macOS 14.0+ (Sonoma)
• Apple Silicon (M1 or later)
• ~500MB disk for Whisper model (downloaded on first launch)

Setup

1. Open RATT.xcodeproj in Xcode 15+
2. Build and run (⌘R)
3. Grant microphone permission when prompted
4. Optionally grant calendar access for meeting annotations

Architecture

See docs/architecture.md for technical details.

Output Format

---
date: 2026-03-08
speakers: 3
duration: 8h 23m
meetings:
  - name: Sprint Planning
    time: "09:15-10:00"
    attendees: [Alice, Bob, Carol]
---

# 2026-03-08

## 09:15 — Sprint Planning

**Speaker 1:** Good morning, let's get started.

**Speaker 2:** I've got the backlog pulled up.