Bereitstellung

Überblick#

Als Administrator legst du fest:

• wie TypeWhisper installiert wird: einmal pro Gerät mit dem MSI oder pro Benutzer mit dem Setup,
• wie es eingestellt ist: Lizenz, Modelle, Cloud-Verarbeitung, Downloads, Updates und Start über verwaltete Einstellungen,
• was es erreichen darf: die Netzwerk-Hosts unten und das Mikrofon.

Jeder Windows-Benutzer behält Einstellungen, Modelle und Plugins in seinem eigenen Profil. Der Richtlinienschlüssel gilt dagegen für das ganze Gerät und damit für jeden Benutzer.

Installer wählen#

Beide Dateien liegen im neuesten stabilen Release, jeweils mit einer .sha256-Datei zur Prüfung:

• TypeWhisper-win-x64.msi
• TypeWhisper-win-x64-Setup.exe

Get-FileHash .\TypeWhisper-win-x64.msi -Algorithm SHA256

Installation für alle Benutzer (MSI)#

Das MSI installiert TypeWhisper einmal für alle Benutzer eines Geräts nach C:\Program Files\TypeWhisper oder in den Ordner aus VELOPACK_INSTALLDIR. Es legt Verknüpfungen im Startmenü und auf dem Desktop für alle Benutzer an und registriert sich unter dem Deinstallationsschlüssel des Computers.

Wie das Setup ist auch das MSI von GitHub nicht codesigniert. Richtlinien zur Anwendungssteuerung, die eine Signatur verlangen, etwa App Control for Business oder AppLocker, brauchen dafür eine Ausnahme. Prüfe die Datei vorher mit ihrer SHA-256-Prüfsumme.

Voraussetzung: .NET 10 Runtime#

Das MSI braucht die .NET 10 Runtime (x64). Eine interaktive Installation bietet an, sie zu installieren; eine stille Installation tut das nicht. Verteile die Runtime daher zuerst, etwa als Abhängigkeit in Intune; dort muss sie selbst eine Win32-App sein. Den Installer gibt es bei dotnet.microsoft.com.

.\dotnet-runtime-10.0.<patch>-win-x64.exe /install /quiet /norestart

# oder
winget install Microsoft.DotNet.Runtime.10

Installieren und deinstallieren#

# Für alle Benutzer installieren
msiexec /i TypeWhisper-win-x64.msi /qn /norestart

# In einen anderen Ordner installieren
msiexec /i TypeWhisper-win-x64.msi /qn /norestart VELOPACK_INSTALLDIR="D:\Apps\TypeWhisper"

# Mit dem Produktcode der installierten Version deinstallieren
msiexec /x '{<product code>}' /qn /norestart

Der Produktcode ändert sich mit jeder Version. Du findest ihn in der Eigenschaft ProductCode des MSI oder auf einem Gerät mit installierter App im Wert QuietUninstallString unter HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MSI:TypeWhisper. Verpackst du das MSI für Intune, trägt Intune den Deinstallationsbefehl mit dem Produktcode selbst ein.

Updates#

Eine Installation für alle Benutzer wird über deine Softwareverteilung aktualisiert. Die App prüft nicht auf App-Updates, lädt und installiert keine, zeigt unter Einstellungen > Konto & Info „App-Updates werden über die Softwareverteilung deiner Organisation verwaltet.“ und sperrt den Update-Kanal. Dafür brauchst du kein UpdateMode. Setzt du es trotzdem, bleib bei 0 oder 1: Standardbenutzer können nicht nach Program Files schreiben, eine aus der App gestartete Installation unter 2 schlägt daher fehl. Plugin-Updates sind nicht betroffen, weil Plugins im Benutzerprofil liegen.

Für ein Upgrade verteilst du das neuere MSI auf dieselbe Weise, etwa über eine Ablösung (Supersedence) in Intune. Es ersetzt die installierte Version direkt. Ein Release Candidate zählt als niedrigere Version als das Stable-Release derselben Version.

Als Win32-App in Intune#

Installation pro Benutzer#

Das Setup installiert TypeWhisper für den Benutzer, der es ausführt: Es schreibt nach %LocalAppData%\TypeWhisper, registriert sich unter dem Deinstallationsschlüssel des Benutzers und startet die App, wenn es fertig ist.

# Für den aktuellen Benutzer installieren
.\TypeWhisper-win-x64-Setup.exe --silent

# Für den aktuellen Benutzer deinstallieren
& "$env:LOCALAPPDATA\TypeWhisper\Update.exe" --uninstall --silent

Als Win32-App in Intune#

Mit UpdateMode 0 liegen Updates bei deiner Organisation: Verteile neue Installer über dieselben Werkzeuge. Mit 1 kündigt die App neue Versionen unter Einstellungen > Konto & Info an, ohne Schaltfläche zum Installieren. Auf gemeinsam genutzten Geräten nimmst du das MSI oder lässt jeden Windows-Benutzer das Setup einmal ausführen; dein Verteilungswerkzeug kann es im Kontext des Benutzers installieren.

Netzwerk-Hosts#

TypeWhisper baut nur ausgehende HTTPS-Verbindungen auf und nutzt die Proxy-Einstellungen von Windows, einschließlich WPAD und PAC-Skripten; eine eigene Proxy-Konfiguration gibt es nicht. Die App selbst kontaktiert diese Hosts:

Cloud-Plugins kontaktieren ihren Anbieter. Die Tabelle nennt die Hosts der Plugins im Katalog, Stand TypeWhisper für Windows 1.2. Plugins mit dem Verarbeitungsort configurable erreichen den Endpunkt, den der Benutzer einträgt.

Mikrofon und Berechtigungen#

TypeWhisper ist eine Desktop-App. Windows fragt bei Desktop-Apps nicht einzeln nach dem Mikrofonzugriff, daher gibt es nichts vorab zu genehmigen. Die App kann aufnehmen, solange unter Einstellungen > Datenschutz & Sicherheit > Mikrofon zwei Schalter eingeschaltet sind (unter Windows 10: Einstellungen > Datenschutz > Mikrofon):

Die Gruppenrichtlinie „Windows-App-Zugriff auf das Mikrofon zulassen“ (englisch „Let Windows apps access the microphone“, unter Computerkonfiguration > Administrative Vorlagen > Windows-Komponenten > App-Datenschutz) gilt nur für paketierte Apps aus dem Store oder als MSIX. Sie betrifft die Microsoft-Store-Version von TypeWhisper, deren Paketfamilienname in die Liste der erzwungen zugelassenen Apps („Force Allow“) gehört, nicht aber die Installer von GitHub. Schaltet ein Benutzer einen Schalter aus, meldet TypeWhisper das fehlende Mikrofon in Status und Einrichtung, statt stumm zu scheitern.

Zum Ausführen braucht TypeWhisper keine Administratorrechte, keinen Treiber und keine Firewall-Ausnahme: Die App baut nur ausgehende Verbindungen auf, und die optionale HTTP-API lauscht nur auf der Loopback-Schnittstelle.

Modelle und Plugins bereitstellen#

• Modelle und Plugins liegen im Profil jedes Benutzers. Schaltest du AllowModelDownloads oder AllowPluginDownloads ab, lege die benötigten Pakete und Modelldateien im Benutzerprofil ab, bevor die Einschränkung greift. Kopiere nie Einstellungen, Zugangsdaten oder mit DPAPI geschützte Daten eines anderen Benutzers.
• Manche lokalen Plugins laden beim Laden eines Modells Laufzeitdateien nach. AllowModelDownloads hält das nicht auf; gib die Laufzeit-Hosts aus der Tabelle oben frei oder stelle die Dateien bereit.
• Die Richtlinie wird gelesen, bevor Plugins und Hintergrundaufgaben starten. Ist sie beim ersten Start schon vorhanden, gilt sie sofort.

Pilottest#

Prüfe vor dem Rollout auf ein oder zwei verwalteten Geräten:

1. Installiere die .NET 10 Runtime und das MSI still und starte TypeWhisper als Standardbenutzer.
2. Importiere die Gruppenrichtlinien-Vorlagen, setze einige Einstellungen und vergleiche sie mit Einstellungen > Erweitert > Verwaltete Einstellungen.
3. Verteile ManagedLicenseKey und prüfe Einstellungen > Premium > Lizenz in der Sitzung eines Standardbenutzers. Starte zweimal neu und stelle sicher, dass Polar keine zusätzlichen Aktivierungen zeigt. Wiederhole das mit einem zweiten Windows-Benutzer und mit einem ersten Start ohne Internet, gefolgt von „Aktivierung erneut versuchen“.
4. Prüfe den Mikrofonzugriff und die Modelle, die deine Einrichtung braucht, besonders wenn Downloads abgeschaltet sind.
5. Aktualisiere mit dem nächsten MSI und deinstalliere es wieder.