Installation & Berechtigungen

Nach der Installation und korrekten Berechtigungen bleiben globale Hotkeys und Spracheingabe zuverlässig. Die Abbildungen sind automatisch erzeugte UI-Vorschauen (HTML-Szenen + Live-Releases); PNGs unter public/screenshots/ können jederzeit durch echte Aufnahmen ersetzt werden.

Voraussetzungen

• macOS 14 oder neuer
• Apple Silicon oder Intel
• Optional: ASR- / LLM-API-Schlüssel (BYOK)
• Für echte Spracheingabe nötig: Mikrofon + Bedienungshilfen
• Mit Apple-Systemsprache zusätzlich: Systemeinstellungen → Datenschutz & Sicherheit → Spracherkennung

1. Installer herunterladen

1. Releases öffnen
   Gehen Sie zu VoiceHotkey-releases · Latest.

2. DMG herunterladen
   Wählen Sie das macOS-.dmg-Asset. Verwenden Sie die Source-code-Archive nicht als App.

3. Disk-Image öffnen
   Doppelklicken Sie die DMG und warten Sie auf das Installationsfenster.

Abb. 1 · Releases-Seite (UI-Vorschau · install-01-releases.webp)

2. An einen stabilen Pfad installieren

1. In Programme ziehen
   Ziehen Sie VoiceHotkey.app in Programme bzw. ~/Applications.

2. DMG auswerfen (optional)
   Bewahren Sie die DMG bei Bedarf als Backup auf.

3. Pfad merken
   Starten Sie die App immer vom selben Speicherort, z. B.

   • /Applications/VoiceHotkey.app
   • oder ~/Applications/VoiceHotkey.app

Abb. 2 · DMG-Installationsfenster (UI-Vorschau · install-02-dmg.webp)

Abb. 3 · App-Pfad bestätigen (UI-Vorschau · install-03-path.webp)

Nicht dauerhaft aus Downloads starten

Starten aus ~/Downloads oder einem temporären Ordner führt dazu, dass macOS Bedienungshilfen nach Verschieben oder erneutem Download als andere App behandelt — Hotkeys „funktionieren plötzlich nicht mehr“. Installieren Sie zuerst in Programme und erteilen Sie dann den Zugriff.

3. Erster Start

1. App öffnen
   Über Launchpad oder Finder. Wenn Gatekeeper blockiert, unter Datenschutz & Sicherheit zulassen (notarized Builds sind unkomplizierter).

2. Menüleiste prüfen
   Rechts sollte ein Mikrofon-ähnliches Symbol erscheinen. Fehlt es, Overflow der Menüleiste prüfen oder ob die App noch läuft.

3. Onboarding abschließen
   Beim ersten Start erscheint die Schnelleinrichtung (Willkommen → Berechtigungen → Plan → Fertig). Zugriff können Sie dort oder später in den Systemeinstellungen erteilen.

Abb. 4 · Menüleistensymbol (UI-Vorschau · install-07-menubar.webp)

Abb. 5 · Onboarding-Berechtigungen (UI-Vorschau · install-06-onboarding.webp)

4. Bedienungshilfen erteilen

Nötig für globale Hotkeys, das Einfügen von Text an der Einfügemarke und Tastatureingaben. Ohne diese Berechtigung reagiert der Hotkey in der Regel gar nicht.

1. Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen.
2. Klicken Sie auf + (oder entsperren) und fügen Sie VoiceHotkey.app hinzu.
3. Stellen Sie sicher, dass der Pfad mit der tatsächlich gestarteten App übereinstimmt.
4. Schalten Sie den Schalter ein.
5. Bei mehreren „VoiceHotkey“-Einträgen: alte Einträge entfernen, nur den aktuellen Pfad behalten, dann App beenden und neu starten.

Abb. 6 · Bedienungshilfen (UI-Vorschau · install-04-accessibility.webp)

Aus der App öffnen

Unter Einstellungen → Allgemein (oder im Onboarding) gibt es in der Regel einen Button, der zu den Bedienungshilfen springt. Nach der Freigabe sollte die Menüleiste nicht mehr „Need Accessibility“ / Bedienungshilfen erforderlich warnen.

5. Mikrofon erteilen

Erforderlich für echte Spracheingabe. Der Demo-Modus kann das Mikrofon überspringen; im produktiven Einsatz brauchen Sie diese Berechtigung.

1. Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon.
2. Aktivieren Sie VoiceHotkey.
3. Beim ersten Aufnehmen ggf. die Systemabfrage bestätigen.
4. Bei externen Mikrofonen: Systemeinstellungen → Ton → Eingabe prüfen. Dasselbe Gerät ggf. in der App unter Allgemein wählen, falls ein Mikrofonwähler angezeigt wird.

5b. Spracherkennung (nur Apple-Engine)

Bei Apple Speech / SpeechAnalyzer verlangt das System zusätzlich die Berechtigung Spracherkennung (SFSpeechRecognizer). Cloud-Engines (Doubao, Whisper usw.) hängen in der Regel nicht davon ab.

1. Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Spracherkennung.
2. Erlauben Sie VoiceHotkey.
3. Fehlt eine Sprache, laden Sie das entsprechende Sprachpaket in den Systemeinstellungen herunter oder wechseln Sie die Engine.

Abb. 7 · Mikrofon (UI-Vorschau · install-05-microphone.webp)

6. Berechtigungs-Checkliste

Prüfung	Erwartung
Menüleistensymbol	Sichtbar, Menü öffnet sich
Einstellungen → Allgemein · Berechtigungen	Bedienungshilfen + Mikrofon erteilt; bei Apple-Engines auch Spracherkennung
Hotkey-Druck	Overlay / Statuswechsel (auch im Demo-Modus)
Installationspfad	Entspricht dem Eintrag unter Bedienungshilfen

Immer noch Probleme? Siehe Fehlerbehebung.

Weiter

ErsteinrichtungDemo-Modus, Engine, Tastenkürzel und ein echter Tipptest.

Tastenkürzel & AufnahmeTippen / Halten, Quick Send, Abbrechen.