# FlowVoice

**Lokale Sprache-zu-Text für macOS — komplett offline, kein Abo, keine Cloud.**

Drücke einen Hotkey, sprich, und der Text erscheint genau dort, wo dein Cursor steht. FlowVoice läuft vollständig auf deinem Mac — kein Account, keine API-Keys, keine Kosten.

---

## Installation

### 1. DMG öffnen und App installieren

Öffne `FlowVoice.dmg` und ziehe **FlowVoice** in deinen Programme-Ordner.

### 2. FlowVoice starten

Da FlowVoice nicht aus dem Mac App Store kommt, zeigt macOS beim ersten Start einen Sicherheitshinweis. Das ist normal für alle Apps außerhalb des App Stores — FlowVoice ist Open Source und quelloffen einsehbar.

**So gehst du vor:**

1. Öffne den **Finder** → **Programme**
2. **Rechtsklick** auf FlowVoice → **Öffnen**
3. Im Dialog auf **Öffnen** klicken

> Falls nur "Schließen" oder "In den Papierkorb legen" erscheint:
> 1. Gehe zu **Systemeinstellungen** → **Datenschutz & Sicherheit**
> 2. Scrolle nach unten — dort siehst du den Hinweis auf FlowVoice
> 3. Klicke auf **Trotzdem öffnen** und bestätige nochmal
> 4. FlowVoice startet jetzt und das Onboarding führt dich durch die Einrichtung

Dieser Schritt ist **einmalig** — danach startet FlowVoice immer ganz normal per Doppelklick.

### 3. Einrichtung im Onboarding

FlowVoice führt dich automatisch durch:

- **Mikrofon-Zugriff** erlauben (für die Aufnahme)
- **Bedienungshilfen** aktivieren (damit Text eingefügt werden kann)
- **Sprachmodell** herunterladen (~500 MB, einmalig, dann 100% offline)

---

## Bedienung

| Aktion | Standard-Hotkey |
|--------|----------------|
| Aufnahme starten / stoppen | `⌥ Space` |
| Letzten Text korrigieren | `⌥ Z` |

Beide Hotkeys sind in den Einstellungen frei konfigurierbar.

---

## Systemanforderungen

- macOS 15 Sequoia oder neuer
- Apple Silicon (M1 oder neuer)
- ~500 MB freier Speicherplatz (für das Standard-Modell)

---

## Datenschutz

FlowVoice verarbeitet alles lokal auf deinem Mac:

- Keine Cloud-Verbindung während der Nutzung
- Keine Telemetrie, kein Tracking
- Kein Account erforderlich
- Quellcode öffentlich auf GitHub einsehbar

---

## Modelle

| Modell | RAM | Latenz | Empfehlung |
|--------|-----|--------|------------|
| Tiny | ~100 MB | ~0,3s | Sehr schnell, weniger genau |
| Base | ~180 MB | ~0,5s | Guter Kompromiss |
| **Small** | **~500 MB** | **~1-2s** | **Empfohlen für DE/EN** |
| Large v3 Turbo | ~2 GB | ~3-5s | Maximale Genauigkeit |

Das Modell wird einmalig heruntergeladen und lokal gespeichert.

---

## Support & Fragen

Website: [flow-voice.de](https://flow-voice.de)
