Hilfe und Einrichtung
Alles, was du für den Start brauchst.
Einrichtung, Berechtigungen, der Groq-Schlüssel, deine Lizenz, Absturzberichte, Lösungen für häufige Probleme und das Deinstallieren. Keine Antwort gefunden? Schreib dem Support.
Erster Start
- Öffne das Image und zieh Soffio in deinen Ordner „Programme“. Öffne es von dort.
- Soffio lädt sein Sprachmodell einmal (etwa 613 MB). Lass die App geöffnet, bis es fertig ist. Danach funktioniert das Diktieren offline.
- Erteile die Berechtigungen unten, wenn Soffio danach fragt. Du kannst sie jederzeit in Soffio unter Einstellungen > Berechtigungen prüfen.
- Klick in ein beliebiges Textfeld, drück Fn, sprich und drück Fn erneut. Zum Abbrechen drück stattdessen Esc.
Deine 14-tägige Testphase beginnt mit deinem ersten Diktat.
Berechtigungen
macOS verwaltet diese Schalter unter Systemeinstellungen > Datenschutz & Sicherheit. Soffio braucht die ersten drei. Die vierte ist optional.
| Berechtigung | Wofür Soffio sie braucht |
|---|---|
| Mikrofon | Um dich beim Diktieren zu hören. Audio wird nur aufgenommen, solange die Leiste zu sehen ist. Ohne sie gibt es nichts zu transkribieren. |
| Bedienungshilfen | Um deine Diktiertaste zu erkennen und den Text in die App einzusetzen, die du gerade nutzt, so als würdest du ⌘V drücken. |
| Eingabeüberwachung | Um die Diktiertaste zu bemerken, während eine andere App im Vordergrund ist. Soffio achtet nur auf die eigenen Tasten und zeichnet nicht auf oder sendet, was du tippst. |
| Automation | Optional. Nur damit Soffio Spotify oder Musik anhalten kann, während du diktierst. Lehnst du ab, funktioniert alles andere. |
Wenn eine Berechtigung nicht hält
- Öffne die passende Liste in den Systemeinstellungen und schalte Soffio aus und wieder ein. Wirkt der Eintrag festgefahren, wähle ihn aus, klick auf die Minustaste und füge Soffio mit der Plustaste erneut hinzu.
- Beende Soffio über sein Symbol in der Menüleiste und öffne es wieder. macOS übernimmt Bedienungshilfen und Eingabeüberwachung erst nach einem Neustart der App.
- Hängt es immer noch? Setz die Einträge zurück und erteile sie erneut. Im Terminal:
tccutil reset All com.robertocinetto.soffio
Die Fn-Taste (Globus-Taste)
Auf den meisten Macs ist die Fn-Taste zugleich die Globus-Taste, und macOS nutzt sie womöglich für etwas anderes, etwa die Emoji-Auswahl oder Apples eigenes Diktieren. Dann kann Soffio sie nicht sehen. Stell es einmal um:
- Öffne Systemeinstellungen > Tastatur.
- Wähle neben Beim Drücken der Globus-Taste die Option Keine Aktion.
Soffio sagt dir auch Bescheid, wenn die Globus-Taste mit etwas anderem belegt ist. Willst du die Globus-Taste nicht hergeben, wähle in Soffio unter Einstellungen > Tastenkürzel ein anderes Diktierkürzel.
Groq-Schlüssel (optional)
Groq ist ein Cloud-Dienst, der Sprache transkribiert. Soffio funktioniert vollständig ohne ihn, und Groq bleibt aus, bis du einen Schlüssel speicherst und es einschaltest. Mit deinem eigenen Schlüssel kann Soffio Groq auch für die Transkription und für Befehle nutzen. Du zahlst Soffio nichts extra, und Soffio schlägt nichts auf.
Einen kostenlosen Schlüssel holen
- Geh auf console.groq.com/keys und melde dich an oder leg ein Konto an.
- Wähle Create API Key, gib ihm einen beliebigen Namen und kopier den Schlüssel. Groq zeigt ihn nur einmal.
- Öffne in Soffio Einstellungen > Cloud & KI, füg den Schlüssel ein und lass Soffio ihn testen. Er wird im macOS-Schlüsselbund gespeichert. Soffio fragt dann, ob Groq jetzt genutzt werden soll, und sagt dir, dass Aufnahmen an Groq gehen. Sagst du Nein, wird nichts gesendet.
Groq bietet einen kostenlosen Tarif mit Nutzungslimits. Limits und Bedingungen legt Groq fest, prüf sie also auf der Website von Groq.
Was gesendet wird
- Nichts, solange Groq aus ist oder keinen Schlüssel hat.
- Mit eingeschalteter Cloud-Transkription: jede Aufnahme und deine Wörterbuch-Wörter gehen an Groq unter
api.groq.com. Du kannst die Cloud-Transkription ausschalten und den Schlüssel behalten. - Mit eingeschalteter KI-Formatierung: der diktierte Text, deine Wörterbuch-Wörter und der Stil-Prompt der App.
- Befehle nutzen Groq, sobald du Groq einschaltest, und haben einen eigenen Groq-Schalter unter Einstellungen > Befehle. Mit Groq senden sie den markierten Text und deine gesprochene Anweisung. Mit Ollama auf deinem Mac verlässt nichts den Mac.
- Dein Schlüssel selbst geht nur an Groq.
Um Groq nicht mehr zu nutzen, lösch den Schlüssel unter Einstellungen > Cloud & KI oder widerruf ihn in der Groq-Konsole.
Befehlszeile, Links und Agenten
Soffio enthält einen soffio-Befehl und einen MCP-Server, damit Claude Code, andere Agenten und Skripte dein Wörterbuch, deine Snippets und Statistiken nutzen können. Beides ist standardmäßig aus.
- Um den Befehl zu installieren, wähle Befehlszeilen-Tool installieren im Soffio-Menü. Es verlinkt
~/.local/bin/soffio. Findet deine Shell ihn nicht, füg~/.local/binzu deinemPATHhinzu. Führsoffio helpim Terminal aus, um alle Befehle zu sehen. - Damit Werkzeuge den Verlauf lesen dürfen, schalte Einstellungen > Allgemein > Automation > Agenten erlauben, den Verlauf zu lesen ein.
- Damit Agenten und die Befehlszeile das Diktieren starten und stoppen dürfen, schalte an derselben Stelle Agenten und der Befehlszeile erlauben, das Diktat zu steuern ein. Für Links schalte Links erlauben, das Diktat zu steuern ein. Beides ist standardmäßig aus.
- Der Befehl spricht mit der laufenden App über eine private Datei, die nur dein Benutzer öffnen kann. Nichts geht übers Netzwerk.
soffio://-Links
Soffio reagiert auf soffio://-Links. soffio://dictate/start und soffio://dictate/stop starten und stoppen das Diktieren und funktionieren nur, wenn Links erlauben, das Diktat zu steuern eingeschaltet ist. soffio://licence/DEIN-SCHLÜSSEL öffnet Einstellungen > Lizenz mit deinem Schlüssel schon eingetragen. Aktiviert wird nie von selbst: Den Knopf drückst du.
Fehlerbehebung
Beim Drücken von Fn passiert nichts
- Prüf die Einstellung der Globus-Taste.
- Prüf Bedienungshilfen und Eingabeüberwachung unter Einstellungen > Berechtigungen. Siehe Wenn eine Berechtigung nicht hält.
- Eine andere App hat vielleicht die sichere Eingabe aktiv, zum Beispiel ein ausgewähltes Passwortfeld. Klick aus dem Feld heraus und versuch es erneut.
Der Text wurde nicht eingesetzt
Manche Felder, etwa Passwortfelder, lehnen eingesetzten Text ab. Das Diktat ist nicht verloren. Es steht im Verlauf, und Letztes Diktat kopieren in der Menüleiste legt es in die Zwischenablage.
Kein Ton oder das falsche Mikrofon
Wähle unter Einstellungen > Diktat den richtigen Eingang. Soffio bietet auch Mikrofon wechseln an, wenn es keinen Ton hört. Prüf, dass Soffio in den Systemeinstellungen unter „Mikrofon“ eingeschaltet ist.
Ein VPN liefert den Fehler 403, und Soffio wechselt auf lokal
Manche VPNs und geteilten Netzwerke werden von Groq blockiert, das mit dem Fehler 403 antwortet. Soffio nutzt dann sofort die lokale Engine, zeigt einen kurzen Hinweis und versucht es mit Groq nach 30 Sekunden erneut, dann nach 2 Minuten, dann alle 5 Minuten. Nichts geht verloren, und das Diktieren funktioniert weiter. Um die Cloud wieder zu nutzen, schalte das VPN aus oder nimm api.groq.com davon aus. Um den Hinweis abzustellen, schalte die Cloud-Transkription unter Einstellungen > Cloud & KI aus.
Das Sprachmodell lädt nicht
- Prüf deine Internetverbindung und schalte VPN, Proxy oder Inhaltsfilter kurz aus.
- Stell sicher, dass der Mac mindestens 2 GB freien Speicher hat.
- Beende Soffio, lösch den Ordner
~/Library/Application Support/Soffio/Modelsund öffne Soffio wieder. Der Download beginnt von vorn. - Klappt es immer noch nicht? Schreib dem Support und gib an, was der Hinweis sagt.
macOS meldet, dass die App nicht geöffnet werden kann
Soffio ist signiert und notarisiert, das sollte also nicht passieren. Lade das Image erneut von dieser Website und vergleich seine Prüfsumme mit der im Download-Bereich. Führ shasum -a 256 aus und zieh die Datei ins Terminal. Klappt es immer noch nicht, schreib dem Support.
Das Diktieren wirkt langsam
Auf deinem Mac ist der Text meist etwa 125 ms nach dem Loslassen da (Median), mit der Cloud in 100 bis 300 ms. Das erste Diktat nach längerer Pause kann etwas länger dauern. Lange Diktate auch. Ist es immer langsam, prüf, ob die Cloud-Transkription nur an ist, wenn du sie willst, und ob kein VPN Groq ausbremst.
Lizenz
Eine Lizenz gilt für eine Person auf bis zu 3 Macs. Die Testphase dauert 14 Tage ab deinem ersten Diktat, ohne Karte. Deinen Lizenzschlüssel bekommst du nach dem Kauf per E-Mail von Polar.
Schlüssel eingeben
- Öffne Einstellungen > Lizenz und wähle Lizenz eingeben. Du kannst auch auf den Link
soffio://licence/…in deiner Kauf-E-Mail klicken, der dieselbe Stelle mit eingetragenem Schlüssel öffnet. - Füg den Schlüssel ein und drück den Knopf zum Aktivieren. Soffio braucht dafür Internet. Der Mac belegt dann einen deiner 3 Plätze.
Auf einem neuen Mac oder nach einer Neuinstallation wiederherstellen
Installier Soffio und gib denselben Schlüssel erneut ein. Dein Verlauf und deine Einstellungen kommen zurück, wenn du den Datenordner behalten hast. Schlüssel verloren? Öffne die E-Mail von Polar, schau mit der Kaufadresse im Kundenportal von Polar nach oder schreib dem Support.
Einen Mac deaktivieren
Wähle unter Einstellungen > Lizenz die Option Diesen Mac deaktivieren. Das macht den Platz frei, sodass du den Schlüssel anderswo nutzen kannst. Tu das, bevor du einen Mac verkaufst oder löschst. Macs verwalten öffnet das Kundenportal, wo du einen Mac entfernen kannst, den du nicht mehr erreichst. Sind alle 3 Plätze belegt, sagt Soffio es dir.
Offline nutzen
- Die Testphase funktioniert offline und sendet nichts.
- Nach der Aktivierung prüft Soffio deine Lizenz etwa einmal pro Woche im Hintergrund, nie während du diktierst.
- Schlägt eine Prüfung fehl, weil du offline bist, hinter einem VPN sitzt oder der Dienst nicht erreichbar ist, ändert sich nichts. 30 Tage lang wird nichts angezeigt. Danach siehst du einen dezenten Hinweis, dich einmal zu verbinden, und Soffio funktioniert weiter.
- Eine Lizenz endet nur, wenn Polar eindeutig meldet, dass sie erstattet, widerrufen oder abgelaufen ist, und zwar bei zwei Prüfungen im Abstand von mindestens 7 Tagen.
Wenn die Testphase endet
Diktieren und Befehle stoppen. Verlauf, Wörterbuch, Snippets und Einstellungen bleiben offen, und du kannst sie exportieren. Nichts wird gelöscht. Gib eine Lizenz ein, und das Diktieren geht wieder.
Updates
- Soffio sucht selbst nach Updates und fragt, bevor es eines installiert. Du kannst auch Nach Updates suchen im Soffio-Menü wählen. Updates für Version 1 sind gratis.
- Die Prüfung lädt eine kleine Datei und sendet keine persönlichen Daten. Du kannst sie in den Einstellungen ausschalten.
Absturzberichte und Diagnose
Soffio sendet nie von selbst einen Absturzbericht und hat keine Analyse.
- Nach einem Absturz bietet Soffio beim nächsten Öffnen womöglich an, den Bericht zu senden. Du kannst ihn vorher lesen. Der Name deines Benutzerordners wird durch
~ersetzt. Per E-Mail senden öffnet eine E-Mail an support@getsoffio.app mit der Datei im Anhang, und du sendest sie selbst aus deiner Mail-App. Entscheidest du dich dagegen, verlässt nichts deinen Mac. - Diagnose kopieren legt eine kurze Zusammenfassung in die Zwischenablage: die Versionen von Soffio und macOS und dein Mac-Modell. Füg sie in eine E-Mail an den Support ein oder wo immer du willst. Sie enthält keinen diktierten Text.
- Ein Absturzbericht ist technisch. Er sollte keine Diktate enthalten, aber lies ihn, bevor du ihn sendest.
Deinstallieren
Beende zuerst Soffio. Entferne dann, was du entfernen willst. Löschst du nur die App, bleiben deine Daten erhalten, und eine spätere Neuinstallation findet sie wieder.
Die App
- Zieh
Soffio.appaus „Programme“ in den Papierkorb. - Entferne sie unter Systemeinstellungen > Allgemein > Anmeldeobjekte, falls sie bei der Anmeldung startete.
Was Soffio auf deinem Mac speichert
| Wo | Was darin liegt |
|---|---|
~/Library/Application Support/Soffio/ | Dein Verlauf, Wörterbuch, Snippets und Statistiken (Soffio.store), die gespeicherten Aufnahmen (Recordings, standardmäßig 14 Tage; änderbar unter Einstellungen > Allgemein), Protokolle nur mit Zeitmessungen und ohne diktierten Text (Logs), das Sprachmodell (Models, etwa 613 MB), eine Kopie deines Testbeginns und die Socket-Datei für Agenten. |
~/Library/Preferences/com.robertocinetto.soffio.plist | Deine Einstellungen. |
~/Library/Caches/com.robertocinetto.soffio | Temporäre Dateien. |
| Schlüsselbund, in der App „Schlüsselbundverwaltung“ | Dein Groq-Schlüssel und deine Lizenz, falls du sie eingegeben hast. Such nach com.robertocinetto.soffio. |
~/.local/bin/soffio | Links für das Befehlszeilen-Tool, falls es installiert war. |
~/Library/Logs/DiagnosticReports/ | Absturzberichte, die macOS für Soffio geschrieben hat (Soffio-*.ips), falls es je abgestürzt ist. Lösch sie, wenn du willst. |
| Datenschutz & Sicherheit | Die Einträge der Berechtigungen. Zum Löschen: tccutil reset All com.robertocinetto.soffio |
Um alles auf einmal zu entfernen, kopier das ins Terminal, nachdem du Soffio beendet und die App in den Papierkorb gelegt hast. Das löscht deinen Verlauf endgültig, exportier also vorher, was du brauchst.
rm -rf "$HOME/Library/Application Support/Soffio" \
"$HOME/Library/Caches/com.robertocinetto.soffio" \
"$HOME/Library/Preferences/com.robertocinetto.soffio.plist" \
"$HOME/.local/bin/soffio"
tccutil reset All com.robertocinetto.soffio
Bevor du endgültig deinstallierst, wähle Diesen Mac deaktivieren unter Einstellungen > Lizenz, damit der Platz frei wird. Andernfalls entferne den Mac im Kundenportal von Polar oder schreib dem Support, und wir geben ihn für dich frei. Die Schlüsselbund-Einträge für deine Lizenz und deinen Groq-Schlüssel entfernt der Befehl oben nicht: Lösch sie in der Schlüsselbundverwaltung.