Duktus Schritt für Schritt

1Installieren

Duktus läuft auf Macs mit Apple-Chip (M1 und neuer) ab macOS 13. Die App ist von Apple geprüft (notarisiert) und signiert.

Duktus für macOS laden

1. Datei ladenLade die Installationsdatei (Endung „.dmg“). Sie landet im Ordner „Downloads“.
2. Datei öffnenDoppelklicke die Datei. Es öffnet sich ein Fenster mit dem Duktus-Symbol und dem Ordner „Programme“.
3. In „Programme“ ziehenZieh das Duktus-Symbol auf den Ordner „Programme“. Das Kopieren dauert ein paar Sekunden.
4. AufräumenSchließ das Fenster und wirf das Laufwerk „Duktus“ im Finder aus (Auswerfen-Symbol in der Seitenleiste). Die geladene Datei kannst du danach löschen.
5. StartenÖffne Duktus aus dem Ordner „Programme“, mit Spotlight (⌘ + Leertaste, „Duktus“ tippen) oder über das Launchpad.

Duktus

Duktus

Programme

2Erster Start und Freigaben

Beim ersten Start führt dich ein Einrichtungsassistent durch drei Freigaben und den Download des Sprachmodells. Danach bist du startklar.

Warum braucht Duktus Freigaben?

• Mikrofon: damit Duktus hören kann, was du sagst. Aufgenommen wird nur, solange du diktierst.
• Bedienungshilfen: damit Duktus die Fn-Taste erkennt und den Text an der Cursor-Position einfügen kann. Ohne diese Freigabe kann keine App in andere Programme schreiben. Duktus achtet dabei nur auf Sondertasten wie Fn, nicht auf das, was du tippst.
• Automation: macOS kann beim ersten Diktat fragen, ob Duktus die App steuern darf, in die du gerade schreibst (zum Beispiel Notizen). Damit holt Duktus diese App wieder nach vorn und fügt den Text ein.

Schritt 1 von 3: Mikrofon

1. Mikrofon testenDer Assistent fragt das Mikrofon an. macOS zeigt dazu einen Dialog.
2. ErlaubenKlick im Dialog auf „Erlauben“ bzw. „OK“.
3. Falls abgelehntÖffne Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon, schalte Duktus ein und klick im Assistenten auf „Erneut testen“.

Schritt 2 von 3: Bedienungshilfen

1. Einstellungen öffnenKlick im Assistenten auf „Einstellungen öffnen“. macOS öffnet Datenschutz & Sicherheit → Bedienungshilfen.
2. Duktus einschaltenAktiviere den Schalter neben „Duktus“. Je nach macOS-Version musst du dafür dein Passwort oder Touch ID bestätigen.
3. Duktus fehlt in der Liste?Klick auf „+“ und wähle Duktus im Ordner „Programme“ aus.
4. Zurück zum AssistentenKlick auf „Erneut prüfen“. Ein Neustart ist nicht nötig: Duktus wartet einige Minuten auf die Freigabe und erkennt die Fn-Taste danach von selbst.

„Duktus“ möchte auf das Mikrofon zugreifen.

Duktus benötigt Mikrofonzugriff für die Sprachaufnahme.

Nicht erlaubenErlauben

AllgemeinTastaturDatenschutz & Sicherheit

Datenschutz & Sicherheit › Bedienungshilfen

Andere App

Duktus

Weitere App

Schritt 3 von 3: Automation

Dieser Schritt passiert beim ersten Diktat. Fragt macOS, ob Duktus die App „Notizen“ (oder die App, in der du gerade schreibst) steuern darf, klick auf „OK“. Hast du versehentlich „Nicht erlauben“ gewählt: Systemeinstellungen → Datenschutz & Sicherheit → Automation, bei Duktus die Schalter einschalten.

Sprachmodell laden

Duktus erkennt deine Sprache auf deinem Mac. Dafür braucht es einmalig ein Sprachmodell. Der Assistent empfiehlt „Beste Qualität“ (574 MB). Duktus lädt es von Hugging Face, der üblichen Quelle für diese Modelle. Der Download lässt sich unterbrechen und später fortsetzen; Duktus prüft vorher den freien Speicher und danach, ob die Datei vollständig und unverändert ist.

3Das erste Diktat

Am einfachsten probierst du es in der App Notizen aus. Später funktioniert es überall, wo ein Cursor blinkt.

1. Textfeld wählenÖffne Notizen und klick in eine Notiz, sodass der Cursor blinkt.
2. Fn gedrückt haltenUnten am Bildschirm erscheint die Duktus-Leiste. Sobald sie die Wellenlinie zeigt (und, wenn eingeschaltet, der Startton erklingt), hört Duktus zu.
3. SprechenSprich ganz normal, zum Beispiel: „Morgen um zehn treffen wir uns im Büro Punkt“.
4. LoslassenDie Leiste zeigt kurz einen drehenden Kreis. Meist ein bis zwei Sekunden später steht der Text in der Notiz. Deine Zwischenablage bleibt, wie sie war.

4Die Duktus-Leiste

Die Leiste unten in der Bildschirmmitte zeigt dir jederzeit, was Duktus gerade tut. In den Diktat-Zuständen zeigt sie Symbole statt Text; fährst du mit der Maus darüber, steht die Bedeutung im Tooltip.

Hinweise, die du sehen kannst

Braucht die KI-Glättung länger als vier Sekunden oder ist sie gerade nicht erreichbar, fügt Duktus den auf dem Mac bereinigten Text ein und weist in der Leiste darauf hin. Dein Diktat geht nicht verloren.

5Halten, Einrasten, Automatisch

Wie Fn das Diktat steuert, legst du an einer Stelle fest: Einstellungen → Diktat → Modus → „Einrastmodus“. Die Startseite der App zeigt den gewählten Modus nur an.

6Sprache einstellen

Duktus erkennt 33 Sprachen. Von Haus aus ist „Auto-Erkennung“ eingestellt: Duktus findet bei jedem Diktat selbst heraus, welche Sprache du sprichst.

1. Einstellungen öffnenEinstellungen → Diktat → „Standard-Diktatsprache“.
2. Sprache wählenWähle die Sprache, in der du meistens diktierst, zum Beispiel „Deutsch“.

Alle Diktatsprachen

• Arabisch
• Bulgarisch
• Chinesisch
• Dänisch
• Deutsch
• Englisch
• Finnisch
• Französisch
• Griechisch
• Hebräisch
• Hindi
• Indonesisch
• Italienisch
• Japanisch
• Koreanisch
• Kroatisch
• Niederländisch
• Norwegisch
• Polnisch
• Portugiesisch
• Rumänisch
• Russisch
• Schwedisch
• Serbisch
• Slowakisch
• Spanisch
• Thai
• Tschechisch
• Türkisch
• Ukrainisch
• Ungarisch
• Vietnamesisch
• Auto-Erkennung (zusätzlich wählbar)

7Gesprochene Befehle

Satzzeichen setzt Duktus meist von selbst. Willst du es genau bestimmen, sprichst du sie einfach mit. Ein- und ausschalten: Einstellungen → Diktat → Befehle.

Satzzeichen und Absätze (von Haus aus an)

• Nach Punkt, Frage- und Ausrufezeichen sowie nach einem neuen Absatz schreibt Duktus das nächste Wort groß.
• Zwischen Zahlen wird „Komma“ bzw. „Punkt“ zum Dezimalzeichen: „1 Komma 5“ ergibt „1,5“.
• Steht ein Artikel davor, bleibt das Wort ein Wort: „ein Punkt“, „auf den Punkt bringen“ oder „der Standpunkt“ werden nicht ersetzt.
• Hat die Erkennung schon ein Satzzeichen gesetzt, gewinnt das stärkere – es entsteht kein doppeltes.

Emoji-Befehle (von Haus aus aus)

Einschalten unter Einstellungen → Diktat → „Emoji-Befehle“. Einige eindeutige Ausdrücke wirken direkt: „Daumen hoch“, „Daumen runter“, „Herz“, „Augen rollen“, „Fragezeichen Emoji“ und „Ausrufezeichen Emoji“. Alle anderen sagst du mit dem Wort „Emoji“ davor, zum Beispiel „Emoji Kaffee“ oder „Emoji einfügen Kaffee“. So wird aus einem normalen „Kaffee“ im Satz kein Bildzeichen.

* wirkt auch ohne das Wort „Emoji“ davor.

Enter-Befehl (von Haus aus aus)

Endet dein Diktat mit „Eingabe drücken“, „Enter drücken“ oder „press enter“, fügt Duktus den Text ein und drückt danach die Eingabetaste – praktisch, um eine Chatnachricht direkt abzuschicken. Die Phrase selbst wird nicht eingefügt. Einschalten unter Einstellungen → Diktat → „Enter-Befehl“; dort kannst du auch eigene Phrasen ergänzen oder entfernen.

8Füllwörter

Der Füllwort-Filter streicht typische Verlegenheitswörter, bevor der Text eingefügt wird. Er arbeitet auf deinem Mac und ist von Haus aus eingeschaltet.

Die Liste unter Einstellungen → Diktat → „Füllwörter-Filter“ enthält zu Beginn: ähm, äh, also, halt, sozusagen, quasi, irgendwie. Du kannst Wörter entfernen und eigene ergänzen. Gefiltert werden nur ganze Wörter: „ähm“ trifft nicht „Ähnlichkeit“.

9Wörterbuch

Namen, Fachbegriffe, Abkürzungen: Was Duktus falsch schreibt, bringst du ihm im Wörterbuch einmal bei.

1. Wörterbuch öffnenIn der Seitenleiste der App auf „Wörterbuch“ klicken.
2. Eintrag hinzufügen„Hinzufügen“ wählen, unter „Begriff“ eintragen, was gesprochen bzw. erkannt wird, und unter „Ersetzung“, was im Text stehen soll.
3. Typ und Geltung wählenTyp: Ersetzen, Immer-korrekt, Eigenname oder Abkürzung. „Gültig für“: alle Apps oder nur eine bestimmte App.
4. FertigAb dem nächsten Diktat gilt der Eintrag. Einträge lassen sich bearbeiten, löschen und vorübergehend ausschalten.

Ersetzt wird nur das ganze Wort, Groß- und Kleinschreibung spielen dabei keine Rolle. Außerdem gibt Duktus die Begriffe aus dem Wörterbuch der Spracherkennung als Hinweis mit – dadurch werden Eigennamen schon beim Erkennen öfter richtig geschrieben.

Importieren und exportieren

• Import: CSV (eine Zeile je Eintrag: wort,ersetzung, Kopfzeile optional) oder JSON ([{"from": "…", "to": "…"}]). Datei auswählen oder ins Fenster ziehen.
• Vorschau: Vor dem Übernehmen zeigt Duktus, welche Einträge neu sind, welche es schon gibt, welche einen anderen Inhalt hätten und welche doppelt in der Datei stehen.
• Export: als CSV oder JSON. Die Datei landet im Ordner „Downloads“; vorhandene Dateien werden nicht überschrieben.

10Snippets

Snippets sind Textbausteine: Du sagst einen kurzen Auslöser, Duktus fügt einen ganzen Block ein.

1. Snippets öffnenIn der Seitenleiste auf „Snippets“ klicken.
2. Auslöser festlegenEinen kurzen, eindeutigen Ausdruck wählen, zum Beispiel „meine Adresse“.
3. Inhalt eintragenDen Text, der eingefügt werden soll, gern mit mehreren Zeilen. Eine Kategorie ist optional.
4. DiktierenSag den Auslöser im Diktat – an seiner Stelle steht dann der Inhalt.

Zum Start sind drei Beispiele angelegt: „meine Signatur“, „neue Aufgabe“ und „meeting template“.

Import und Export funktionieren wie beim Wörterbuch: CSV mit auslöser,inhalt,kategorie oder JSON mit [{"trigger": "…", "content": "…"}].

11Stil und App-Profile

In der Seitenleiste unter „Stil“ legst du fest, wie dein Text klingen soll – je nachdem, wo du gerade schreibst. Duktus erkennt die App, in der du diktierst, und wählt den passenden Stil.

Der Stil wirkt über die KI-Glättung. Unter „Stil“ → „KI-Cleanup“ wählst du, wie stark sie eingreift:

Eigene App-Profile

Unter „Stil“ kannst du für einzelne Apps abweichende Einstellungen anlegen: Stil, Bereinigungsstufe und KI-Modell. Sie haben Vorrang vor der Kategorie. Duktus ordnet über den App-Namen zu.

12Writing Tools

Die Writing Tools bearbeiten vorhandenen Text mit KI: umschreiben, umformen, prüfen, übersetzen. Du öffnest sie über die Seitenleiste oder im Menüleisten-Menü mit „Writing Tools öffnen“.

1. Text einfügenLinks den Text einfügen, den du bearbeiten willst.
2. Werkzeug wählenOben einen Bereich wählen und dann das Werkzeug anklicken.
3. Ergebnis übernehmenRechts erscheint das Ergebnis. Mit „Kopieren“ übernimmst du es.

Die Writing Tools arbeiten über den Duktus-Server mit Anthropic, brauchen also Internet und zählen zu den täglichen KI-Aufrufen. Nach Ablauf der Demo und im Privatmodus stehen sie nicht zur Verfügung.

13Notizblock

Der Notizblock in der Seitenleiste ist ein schlichter Schreibbereich für Entwürfe, direkt in Duktus.

• Mehrere Dokumente als Tabs; mit „+“ legst du ein neues an.
• Alles wird automatisch auf diesem Mac gespeichert.
• Schließt du einen Tab mit Inhalt, fragt Duktus vorher nach.
• Export als TXT oder Markdown (MD) in den Ordner „Downloads“.
• „In Writing Tools öffnen“ übergibt den Text zum Umschreiben, Prüfen oder Übersetzen.
• Unten siehst du Wortzahl und ungefähre Lesezeit.

14Verlauf und Export

Auf der Startseite der App („Home“) findest du deine Statistik und alle bisherigen Diktate.

• Statistik: Wörter, Diktate, Aufnahmezeit und Wörter pro Minute – für heute, die Woche, den Monat, das Jahr oder insgesamt.
• Verlauf: nach Tagen gruppiert, mit Uhrzeit und App. Ein Klick zeigt den ganzen Text; du kannst ihn kopieren, im Notizblock öffnen oder löschen.
• Suche: Das Suchfeld über dem Verlauf filtert während du tippst.
• Export: den ganzen Verlauf als TXT oder JSON, gespeichert im Ordner „Downloads“.

Unter Einstellungen → Allgemein → Verlauf schaltest du „Diktat-Verlauf speichern“ ein oder aus und wählst, wie lange er aufbewahrt wird: 7, 30 (Standard) oder 90 Tage oder unbegrenzt. Unter Einstellungen → Daten & Datenschutz kannst du alle Daten als JSON exportieren, den Verlauf löschen oder die App zurücksetzen (Wörterbuch und Snippets bleiben dabei erhalten).

15Konto, Demo und Verlängerungen

Duktus startet mit einer 14-tägigen Demo – ohne Konto, ohne Kreditkarte. Wie viele Tage noch übrig sind, zeigt die Statuszeile in der Seitenleiste („Demo – noch X Tage“). Alles Weitere findest du unter Einstellungen → Konto.

Jede Verlängerung gibt es nur einmal, auch je E-Mail-Adresse und Telefonnummer.

Nach der Demo

Duktus läuft weiter: Du diktierst auf dem Mac bis zu 500 Wörter am Tag, ohne Ablaufdatum. KI-Glättung und Writing Tools sind dann nicht enthalten. Unbegrenzt diktieren kannst du mit einem der Pläne.

Was ein Konto zusätzlich bringt

Mit Konto stehen dir mehr KI-Aufrufe am Tag zur Verfügung, und du kannst die optionale Cloud-Erkennung nutzen. Wie viele KI-Aufrufe heute noch frei sind, zeigt die Kontoseite.

Bewertungen auf duktus.app

Bewertungen aus der App erscheinen erst nach einer Prüfung auf duktus.app/bewertungen – mit Vorname und dem ersten Buchstaben des Nachnamens (ohne Konto als „Duktus-Nutzer“). Änderst du deine Bewertung, wird sie erneut geprüft.

Passwort ändern und Konto löschen

Beides findest du unter Einstellungen → Konto. Zum Löschen gibst du dein Passwort ein und tippst zur Bestätigung „LÖSCHEN“. Dein Konto und die zugehörigen Daten auf dem Duktus-Server werden dann gelöscht; Verlauf, Wörterbuch und Sprachmodell auf deinem Mac bleiben erhalten.

16Privatmodus

Für vertrauliche Diktate gibt es den Privatmodus. In der App heißt er „Privacy Mode“: Einstellungen → Daten & Datenschutz.

• Erkannt wird nur auf diesem Mac, auch wenn die Cloud-Erkennung gewählt ist.
• Keine KI-Glättung, keine KI-Aufrufe.
• Diktate werden nicht im Verlauf gespeichert.
• Duktus meldet keine Wortzahlen an den Server.
• Das Mikrofon wird nach jedem Diktat sofort geschlossen.

17Mikrofon-Tipps

Ein gutes Mikrofon macht den größten Unterschied. Welches Duktus nutzt, wählst du unter Einstellungen → Diktat → Mikrofon → „Gerät“.

Bluetooth-Kopfhörer

AirPods und andere Bluetooth-Kopfhörer brauchen etwa ein bis zwei Sekunden, bis ihr Mikrofon bereit ist. In dieser Zeit zeigt die Leiste das bernsteinfarbene Mikrofon. Erst wenn die Wellenlinie erscheint, nimmt Duktus auf – sonst fehlt dein Satzanfang.

„Mikrofon bereit halten“

Damit Folgediktate sofort beginnen, lässt Duktus das Mikrofon nach einem Diktat eine Weile offen. Einstellbar unter Einstellungen → Diktat → Mikrofon:

18Updates

Neue Versionen holst du direkt in der App: Einstellungen → Updates.

1. PrüfenKlick auf „Prüfen“. Ist eine neue Version da, zeigt Duktus sie an.
2. InstallierenKlick auf „Jetzt installieren“. Duktus lädt das Update, beendet sich und startet neu.

Mit „Automatisch prüfen (täglich)“ schaut Duktus selbst nach. Du kannst die neueste Version auch jederzeit hier auf der Website laden und die App in „Programme“ ersetzen – deine Einstellungen, dein Wörterbuch und das Sprachmodell bleiben dabei erhalten.

19Fehlerbehebung

Die meisten Probleme haben mit einer Freigabe oder dem Mikrofon zu tun. Einen ersten Überblick gibt Einstellungen → Hilfe → Diagnose.

Der Text erscheint nicht

• Stand der Cursor in einem Textfeld? Klick vor dem Diktat in das Feld.
• Bedienungshilfen: Ist Duktus unter Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen eingeschaltet? Wird nach einem Update nichts mehr eingefügt, schalte den Eintrag aus und wieder ein; notfalls Duktus mit „–“ entfernen und mit „+“ neu hinzufügen.
• Automation: Unter Datenschutz & Sicherheit → Automation müssen die Schalter bei Duktus an sein.
• Meldet die Leiste „Ziel-App nicht gefunden – Text liegt in der Zwischenablage“, füge den Text mit ⌘ + V selbst ein.

Fn reagiert nicht

• Läuft Duktus? Das Symbol muss in der Menüleiste stehen. Im Menü siehst du „Duktus — Bereit“.
• Bedienungshilfen prüfen (siehe oben). Ohne diese Freigabe kann Duktus die Fn-Taste nicht erkennen.
• macOS kann der Fn- bzw. Globustaste eine eigene Aufgabe geben. Stell unter Systemeinstellungen → Tastatur die Option für das Drücken der Globustaste auf „Nichts tun“, damit sich nichts überschneidet.
• Hilft das nicht: Duktus über das Menüleisten-Menü beenden und neu starten.

Kein Ton / „Kein Mikrofonsignal“

• Mikrofon-Freigabe prüfen: Datenschutz & Sicherheit → Mikrofon → Duktus an.
• Richtiges Gerät gewählt? Einstellungen → Diktat → Mikrofon → „Gerät“.
• Ist das externe Mikrofon stummgeschaltet oder der Kopfhörer mit einem anderen Gerät verbunden?
• Bei Bluetooth: Wellenlinie abwarten, siehe Mikrofon-Tipps.

Wörter werden falsch erkannt

• Diktatsprache fest einstellen statt Auto-Erkennung (Sprache einstellen).
• Namen und Fachbegriffe ins Wörterbuch eintragen.
• Sprachmodell „Beste Qualität“ verwenden (Einstellungen → Diktat → Spracherkennung).

Die Logdatei

Duktus schreibt ein Protokoll nach ~/Library/Logs/app.duktus.app/duktus.log. Es enthält Abläufe und Zeiten, aber keine diktierten Texte und keine Schlüssel. So öffnest du es: Im Finder ⇧ + ⌘ + G drücken, den Pfad einfügen, Eingabetaste. Wenn wir dir bei einem Problem helfen, kann die Datei sehr nützlich sein – schick sie bitte nur, wenn wir dich darum bitten, an duktus@jost-elektro.de.

20Deinstallation

Duktus passt nicht zu dir? Das Entfernen dauert eine Minute. Es gibt nichts zu kündigen.

1. Konto löschen (falls vorhanden)Wenn du ein Konto angelegt hast und auch die Daten auf dem Duktus-Server löschen willst: Einstellungen → Konto → „Konto löschen …“. Das geht nur aus der App heraus.
2. Duktus beendenIm Menüleisten-Menü auf „Beenden“ klicken.
3. App löschenIm Ordner „Programme“ Duktus in den Papierkorb ziehen.
4. Daten entfernen (optional)Im Finder mit ⇧ + ⌘ + G die Ordner ~/Library/Application Support/app.duktus.app (enthält das Sprachmodell) und ~/Library/Logs/app.duktus.app öffnen und löschen. Weitere App-Daten können unter ~/Library/WebKit/app.duktus.app und ~/Library/Caches/app.duktus.app liegen.
5. Freigaben und Schlüsselbund (optional)Duktus in den Listen Mikrofon, Bedienungshilfen und Automation mit „–“ entfernen. In der Schlüsselbundverwaltung kannst du die Einträge „app.duktus.app“ löschen.