From f986c3ad111b57798908893d3a387dd85b1d6a30 Mon Sep 17 00:00:00 2001 From: danny Date: Thu, 10 Sep 2026 17:22:54 +0200 Subject: [PATCH] Squad Voice Activation 3.2 - Ausgangsstand Windows-Werkzeug, das die Sprechtaste in Squad haelt, solange man redet. - Hauptprogramm mit tkinter-Oberflaeche, Pegelanzeige und Diagnose - Auto-Updater gegen https://sva.tyrveil.com/version.json mit SHA-256-Pruefung - Inno-Setup-Installer und Build-Skript werkzeuge/baue_release.py - Projektuebergabe mit den bekannten Fallstricken Co-Authored-By: Claude Opus 5 --- .gitattributes | 13 + .gitignore | 11 + Design-Briefing.md | 255 ++++ PROJEKT-UEBERGABE.md | 314 +++++ README.md | 52 + Squad-Voice.png | Bin 0 -> 28886 bytes icon.ico | Bin 0 -> 28908 bytes icon.png | Bin 0 -> 28886 bytes installer/HOCHLADEN.txt | 88 ++ installer/einrichten.bat | 81 ++ installer/paketdateien/Fehlersuche.bat | 58 + installer/paketdateien/Starter.vbs | 49 + installer/setup.iss | 86 ++ make_icon.py | 147 +++ requirements.txt | 2 + squad_voice_activation.py | 1623 ++++++++++++++++++++++++ start.pyw | 28 + werkzeuge/baue_release.py | 232 ++++ werkzeuge/mictest.py | 53 + werkzeuge/screenshot.py | 48 + werkzeuge/strip.py | 49 + werkzeuge/umlaute.py | 99 ++ 22 files changed, 3288 insertions(+) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 Design-Briefing.md create mode 100644 PROJEKT-UEBERGABE.md create mode 100644 README.md create mode 100644 Squad-Voice.png create mode 100644 icon.ico create mode 100644 icon.png create mode 100644 installer/HOCHLADEN.txt create mode 100644 installer/einrichten.bat create mode 100644 installer/paketdateien/Fehlersuche.bat create mode 100644 installer/paketdateien/Starter.vbs create mode 100644 installer/setup.iss create mode 100644 make_icon.py create mode 100644 requirements.txt create mode 100644 squad_voice_activation.py create mode 100644 start.pyw create mode 100644 werkzeuge/baue_release.py create mode 100644 werkzeuge/mictest.py create mode 100644 werkzeuge/screenshot.py create mode 100644 werkzeuge/strip.py create mode 100644 werkzeuge/umlaute.py diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..27c7e11 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,13 @@ +# Windows-Skripte brauchen CRLF - mit LF brechen Sprungmarken und Bloecke +*.bat text eol=crlf +*.vbs text eol=crlf +*.iss text eol=crlf +*.txt text eol=crlf + +# Python einheitlich mit LF +*.py text eol=lf +*.pyw text eol=lf +*.md text eol=lf + +*.png binary +*.ico binary diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..b90922b --- /dev/null +++ b/.gitignore @@ -0,0 +1,11 @@ +# Laufzeitumgebung - enthaelt feste Pfade und wird bei jeder Installation neu angelegt +.venv/ + +# Erzeugte Dateien - entstehen durch werkzeuge/baue_release.py +dist/ +__pycache__/ +*.pyc + +# Editor +.idea/ +.vscode/ diff --git a/Design-Briefing.md b/Design-Briefing.md new file mode 100644 index 0000000..921d464 --- /dev/null +++ b/Design-Briefing.md @@ -0,0 +1,255 @@ +# Design-Briefing: Squad Voice Activation 3.0 + +Zwei Aufgaben, in dieser Reihenfolge: + +- **Teil A** — ein Design System (Farben, Schrift, Abstände, Bausteine) +- **Teil B** — die beiden Bildschirme des Programms, gebaut aus Teil A + +--- + +## Ausgangslage + +Ein Windows-Desktop-Werkzeug für den Taktik-Shooter **Squad**. Es misst +laufend den Mikrofonpegel und hält die Sprechtaste des Spiels automatisch +gedrückt, solange der Spieler redet — Voice Activation für ein Spiel, das +nur Push-to-Talk kennt. + +Kein Overlay, kein Spielinhalt: ein eigenständiges Fenster neben dem Spiel. +Es wird zum Einrichten geöffnet und im Betrieb nur kurz angeschaut, um +einen Zustand abzulesen. + +**Nutzer:** Squad-Spieler, überwiegend erwachsen, Mil-Sim-affin, technisch +interessiert. Vertraut mit Begriffen wie Local, Squad Radio, Command Radio, +WASAPI. Sie mögen nüchterne Werkzeuge und misstrauen verspielten +Oberflächen. + +**Anmutung:** Militärisch-funktional, nüchtern, dunkel. Nähe zur +Bildsprache des Spiels — gedecktes Olivgrün, Sandtöne, dunkles Metall, +Beschriftungen wie auf Gerätefronten. Kein Neon, keine Verläufe, keine +Spielereien. Eher Feldfunkgerät als Consumer-App. + +**Oberstes Ziel:** Ablesbarkeit. Der Nutzer kommt aus einem Vollbild-Spiel +und muss den Zustand in einer halben Sekunde erfassen. + +--- + +# TEIL A — Design System + +Gesucht ist ein kleines, konsequentes System für genau diese Art von +Werkzeug. Bitte als benannte Gestaltungsmerkmale anlegen, damit sie in +Teil B wiederverwendet werden können. + +## A1 Farben + +Als Rollen definieren, nicht nur als Werte. Benötigt werden mindestens: + +- Fensterhintergrund (dunkelste Ebene) +- Flächenfarbe für Eingabefelder und Kästen +- gehobene Fläche für aktiven Reiter und Mauskontakt +- Rahmen- und Trennlinienfarbe +- Textfarbe, Nebentextfarbe +- Akzentfarbe (Olivgrün) in normal und hell +- Signalfarben: Bernstein (Hinweis, Schwelle), Grün (aktiv/sendet), + Rot (gesperrt), Grau (untätig) + +Bisher verwendete Werte als Ausgangspunkt, gern verbessern: + +| Rolle | Wert | +|---|---| +| Fensterhintergrund | `#151814` | +| Fläche | `#1e231b` | +| Fläche gehoben | `#2a3125` | +| Linie | `#3d4634` | +| Text | `#c9cec0` | +| Nebentext | `#7f8874` | +| Akzent | `#6e8b3d` | +| Akzent hell | `#8cb04d` | +| Bernstein | `#d9a441` | +| Rot | `#b4472f` | +| Grün aktiv | `#9ed23f` | + +## A2 Schrift + +Zwei Familien, klar getrennt in der Aufgabe: + +- **Beschriftungen und Fließtext** — serifenlos, gut lesbar (bisher Segoe UI) +- **Messwerte, Diagnose, Zustandsanzeige** — dicktengleich (bisher Consolas) + +Gesucht ist eine Skala mit etwa fünf Stufen: Fenstertitel, Kastenüberschrift, +Beschriftung, Nebentext, Zustandsanzeige. Versalien sparsam einsetzen — +bisher nur für Fenstertitel und die Knöpfe der Statusleiste. + +## A3 Raster und Abstände + +Formularzeilen: links Beschriftung, rechts Bedienelement, konsistent +ausgerichtet. Bitte eine Abstandsskala festlegen (Innenabstand von Kästen, +Zeilenabstand, Abstand zwischen Gruppen) und durchhalten. + +## A4 Bausteine + +Für jeden Baustein die Zustände *normal*, *Mauskontakt*, *Fokus* und +*deaktiviert* mitdenken: + +1. **Knopf, primär** — nur einmal pro Fenster (STARTEN) +2. **Knopf, sekundär** — normale Aktionen, deaktivierbar +3. **Auswahlliste** — auch mit sehr langen Einträgen wie + `[WASAPI] Analogue 1 + 2 (Focusrite USB Audio)`; zusätzlich eine + schmale Variante für Tastenauswahl +4. **Textfeld** — einzeilig +5. **Zahlenfeld** mit Schrittpfeilen +6. **Schieberegler** mit Zahlenanzeige daneben +7. **Kontrollkästchen** mit ein- und zweizeiliger Beschriftung +8. **Reiter** — genau zwei, aktiver deutlich abgesetzt +9. **Gerahmter Kasten** mit Überschrift in der Rahmenlinie +10. **Diagnosefeld** — mehrzeilig, dicktengleich, gerahmt +11. **Pegelanzeige** — siehe A5 +12. **Zustandsanzeige** — siehe A6 +13. **Statuszeile** — dezente, mitlaufende Textzeile unter einem Element +14. **Hinweistext** — mehrzeilig, gedämpft + +## A5 Pegelanzeige — Kernstück + +Kein gewöhnlicher Fortschrittsbalken. Etwa 40 schmale senkrechte Segmente +in einem Rahmen. Gefüllte Segmente zeigen den aktuellen Pegel, leere +bleiben dunkel. Eine **senkrechte bernsteinfarbene Marke** steht an der +Position der Auslöseschwelle. + +Der Nutzen: Man sieht sofort, ob die eigene Stimme über die Schwelle kommt. +Bleiben die gefüllten Segmente links der Marke, löst nichts aus. Genau +daran scheitern Nutzer beim Einrichten — deshalb ist das der wichtigste +Blickfang des Fensters. + +Bitte auch entwerfen, wie die Anzeige im aktiven Zustand (es wird gerade +gesendet) anders aussieht als im horchenden. + +## A6 Zustandsanzeige + +Vier sich ausschließende Zustände, jeweils Punkt plus Text: + +| Zustand | Text | Farbe | Bedeutung | +|---|---|---|---| +| gestoppt | ● BEREITSCHAFT | grau | läuft nicht | +| bereit | ● HORCHT | bernstein | läuft, wartet auf Stimme | +| aktiv | ● SENDET | grün | Taste wird gerade gehalten | +| blockiert | ● GESPERRT | rot | pausiert, Grund steht daneben | + +Muss aus zwei Metern Abstand erkennbar sein. Farbe allein darf nicht das +einzige Unterscheidungsmerkmal sein. + +--- + +# TEIL B — Die Bildschirme + +Ein Fenster, Standardgröße **700 × 780 px**, verkleinerbar bis etwa +660 × 480. Aufbau von oben nach unten: Kopfbereich, zwei Reiter, +Statusleiste am unteren Rand (immer sichtbar, auch bei kleinem Fenster). + +## Kopfbereich + +- Titel **SQUAD VOICE ACTIVATION** +- Untertitel „Hält die Sprechtaste, solange du redest." +- Trennlinie darunter + +## Bildschirm 1 — Reiter „Mikrofon" + +Formularzeilen: + +| Beschriftung | Bedienelement | Anmerkung | +|---|---|---| +| Mikrofon | Auswahlliste + Knopf „Neu laden" | lange Einträge, Präfix `[WASAPI]` / `[MME]` | +| Schwelle | Schieberegler + Zahlenwert | 0.002 bis 0.100, dreistellig angezeigt | +| Pegel | **Pegelanzeige** + Zahlenwert | das Kernstück aus A5 | +| Nachlaufzeit | Zahlenfeld + „ms nach dem letzten Wort" | 100 bis 2000 | + +Darunter zwei gerahmte Kästen: + +**„Warum sendet es (nicht)?"** — Diagnosefeld, zwei bis vier Zeilen. +Beispielinhalt: + +``` +Pegel 0.0413 / Schwelle 0.0250 -> über Schwelle +Blockiert: Squad nicht im Vordergrund + -> Squad anklicken, oder den Haken im + Reiter 'Tasten und Verhalten' entfernen. +``` + +**„Eingabetest"** — Knopf „PTT-Taste testen (1 Sekunde halten)" plus +Ergebnistext daneben. + +Abschließend ein vierzeiliger Hinweistext in gedämpfter Farbe. + +## Bildschirm 2 — Reiter „Tasten und Verhalten" + +- Zeile **Sprechtaste**: schmale Auswahlliste (Zusatztaste), ein „+", + schmale Auswahlliste (Taste), dahinter grauer Hinweis +- Gerahmter Kasten **„Andere Sprechtasten — Automatik pausiert, solange + eine gehalten wird"** mit drei gleich aufgebauten Zeilen: + + | Beschriftung | Zusatztaste | | Taste | Hinweis | + |---|---|---|---|---| + | Squad Radio | (kein) | + | B | meist B | + | Command Radio | (kein) | + | G | meist G | + | Weitere Taste | (kein) | + | (keine) | optional | + +- Dreizeiliger Erklärtext +- Gerahmter Kasten **„Verhalten"**: + - Kontrollkästchen „Alles nur aktiv, solange dieses Programm im + Vordergrund ist:" — darunter eingerückt ein Textfeld mit dem + Prozessnamen und eine mitlaufende Statuszeile + („gerade im Vordergrund: SquadGame-Win64-Shipping.exe") + - Kontrollkästchen „Pausieren, solange ein Mauszeiger sichtbar ist + (Deploy-Screen, Menü, Karte)" — darunter mitlaufende Statuszeile + („Mauszeiger gerade ausgeblendet") + - Zeile „Stummschalt-Hotkey (nur im Spiel)" + schmale Auswahlliste + - Kontrollkästchen „Signalton beim Umschalten (hoch = aktiv, tief = stumm)" +- Zum Abschluss eine dezente Zeile „Alle Änderungen werden sofort + gespeichert." mit Zeitstempel der letzten Speicherung + +## Statusleiste + +Über die volle Breite, oben abgetrennt durch eine Linie. + +- Links: **STARTEN** (der einzige primäre Knopf im ganzen Fenster) und + **STOPPEN** (sekundär, im Ruhezustand deaktiviert) +- Rechts: Detailtext (etwa „Funk aktiv (B)" oder „WASAPI @ 48000 Hz") und + daneben die Zustandsanzeige aus A6 + +## Bitte zusätzlich zeigen + +Die Zustandsanzeige und die Pegelanzeige sind die einzigen Elemente, die im +laufenden Betrieb wirklich abgelesen werden. Deshalb wären hilfreich: + +1. Bildschirm 1 im Zustand **SENDET** — Pegel über der Schwelle +2. Bildschirm 1 im Zustand **GESPERRT** — Pegel über der Schwelle, aber + blockiert, mit Grund im Diagnosefeld +3. Die vier Zustände der Zustandsanzeige nebeneinander + +--- + +## Technische Rahmenbedingungen + +Die Oberfläche ist mit **Python und Tkinter/ttk** gebaut. Das begrenzt, was +sich unmittelbar umsetzen lässt: + +**Gut machbar:** freie Farben für Flächen, Text und Rahmen; eigene +Schriftarten und -größen; Rahmen und Trennlinien; beliebige Grafik auf +einer Zeichenfläche (die Pegelanzeige ist bereits so gebaut — dort ist +gestalterisch fast alles möglich); Bilder als Symbole. + +**Nicht oder nur mit erheblichem Aufwand:** abgerundete Ecken an +Standardelementen, Schlagschatten, Verläufe hinter Bedienelementen, +Transparenz, weiche Animationen, Platzhaltertexte in Eingabefeldern. + +Ein Entwurf darf gern darüber hinausgehen. Dann bitte kenntlich machen, +welche Teile über den Standardumfang hinausgehen — sie müssten dann als +selbstgezeichnete Flächen entstehen oder ein anderes Oberflächen-Werkzeug +erfordern. + +## Woran der Entwurf gemessen wird + +1. Der Zustand ist auf einen Blick erfassbar, auch aus zwei Metern. +2. Die Beziehung zwischen Pegel und Schwelle wird sofort verständlich — + das ist die häufigste Hürde beim Einrichten. +3. Der zweite Reiter mit seinen vielen Auswahlfeldern wirkt geordnet, + nicht überladen. +4. Es sieht nach Werkzeug aus, nicht nach Spielerei. diff --git a/PROJEKT-UEBERGABE.md b/PROJEKT-UEBERGABE.md new file mode 100644 index 0000000..7c5d8c0 --- /dev/null +++ b/PROJEKT-UEBERGABE.md @@ -0,0 +1,314 @@ +# Projektübergabe: Squad Voice Activation + +Stand: 10. September 2026 · Version 3.2 · Git-Repository im Quellordner + +Seit 3.2 wird über einen Inno-Setup-Installer und einen eingebauten +Auto-Updater verteilt (Server: https://sva.tyrveil.com), siehe Abschnitt 4. + +Dieses Dokument richtet sich an eine neue Claude-Sitzung ohne Vorwissen. +Es beschreibt, was das Projekt ist, wie es aufgebaut ist und vor allem: +welche Fallstricke bereits teuer gelernt wurden. Die Abschnitte +„Hart erkaufte Erkenntnisse" und „Offene Punkte" sind die wichtigsten. + +--- + +## 1. Was es ist + +Ein Windows-Desktop-Werkzeug in Python für den Taktik-Shooter **Squad**. +Es misst laufend den Mikrofonpegel und hält per simuliertem Tastendruck die +Sprechtaste des Spiels gedrückt, solange der Nutzer redet — also Voice +Activation für ein Spiel, das nur Push-to-Talk kennt. + +Kein Eingriff ins Spiel: kein Hook, keine DLL-Injektion, kein +Speicherzugriff, keine veränderten Spieldateien. Ausschließlich +`SendInput` und `GetAsyncKeyState` über `ctypes`. + +**Nutzer:** Ein einzelner Anwender (deutschsprachig, spielt Squad) und sein +Freundeskreis, an den er das Programm weitergibt. Sprache der Oberfläche +und aller Dokumente ist Deutsch. + +--- + +## 2. Ordner + +Es gibt drei getrennte Orte. Das zu verwechseln war bereits mehrfach die +Fehlerquelle. + +### `C:\Users\danie\Downloads\Squad_Local_Voice_Activation_v2\` — Quelle + +Arbeitsverzeichnis. Hier wird entwickelt. Der Code enthält hier +**Kommentare**, und Texte stehen teils in Ersatzschreibung („Haelt"). + +``` +squad_voice_activation.py Hauptprogramm, rund 1200 Zeilen, eine Datei +start.pyw Startskript ohne Konsolenfenster +make_icon.py erzeugt icon.ico aus icon.png +icon.png / icon.ico Programmsymbol (vom Nutzer geliefert) +requirements.txt numpy, sounddevice +werkzeuge/ Hilfsskripte für den Paketbau, siehe Abschnitt 4 +README.md kurze Orientierung im Ordner +PROJEKT-UEBERGABE.md dieses Dokument +Design-Briefing.md Auftrag für Claude Design, siehe Offene Punkte +``` + +**Aufteilung der Pflege:** Nur die drei Python-Dateien werden hier +gepflegt und für das Paket aufbereitet. Die Skripte `Setup.bat`, +`Update.bat`, `Deinstallieren.bat`, `Fehlersuche.bat` und `Starter.vbs` +durchlaufen keine Aufbereitung und werden **direkt im Paket** gepflegt — +es gibt bewusst keine zweite Kopie in der Quelle. + +### `C:\Users\danie\Downloads\Squad Voice Activation 3.1\` — altes Paket + +**Vorgängerweg, seit 3.2 ersetzt** durch `dist/` und den Installer +(Abschnitt 4). Nur noch relevant, weil die lokale Installation des Nutzers +darüber eingerichtet wurde. Enthält Code ohne Kommentare und mit echten +Umlauten. + +``` +Setup.bat Erstinstallation +Update.bat Aktualisierung einer vorhandenen Installation +ANLEITUNG.txt Endnutzer-Dokumentation +Programm/ + squad_voice_activation.py + start.pyw + make_icon.py + Starter.vbs portabler Start ohne Installation + Fehlersuche.bat Start mit sichtbarer Konsole + Deinstallieren.bat + requirements.txt + icon.png / icon.ico +``` + +Dazu `Downloads\SquadVoiceActivation-3.1.zip` als Versandfassung. + +### `%LOCALAPPDATA%\Programs\SquadVoiceActivation\` — Installation + +Zielverzeichnis. Enthält zusätzlich `.venv\`. Konfiguration und Fehlerlog +liegen getrennt davon in `%APPDATA%\SquadVoiceActivation\`. + +--- + +## 3. Aufbau des Programms + +Eine einzelne Datei, `tkinter`/`ttk`, keine Klassenhierarchie außer der +Hauptklasse `VoiceActivationApp`. + +**Ablauf:** `sounddevice.InputStream` liefert Audioblöcke an einen +Callback, der den RMS-Pegel berechnet und in eine Queue legt. Ein +Arbeitsthread (`worker_loop`) liest daraus, prüft Sperrgründe und drückt +bzw. löst die Taste. Die Oberfläche aktualisiert sich unabhängig alle 80 ms +über `ui_tick`. + +**Zentrale Funktion:** `blocking_reason()` gibt den Grund zurück, warum +gerade nicht gesendet werden darf, oder einen leeren String. Reihenfolge: + +1. Spiel nicht im Vordergrund +2. per Hotkey stummgeschaltet +3. eine Funktaste wird gehalten +4. die Sprechtaste wird manuell gedrückt +5. Mauszeiger sichtbar (optional) + +**Funktionen von Bedeutung:** + +| Funktion | Zweck | +|---|---| +| `enumerate_inputs()` | Geräteliste, siehe Erkenntnis 5 | +| `squad_focused()` | Prozessname des Vordergrundfensters prüfen | +| `send_binding()` | Taste plus Zusatztaste drücken/lösen | +| `apply_tactical_theme()` | dunkles Farbschema | +| `LevelMeter` | segmentierte Pegelanzeige mit Schwellenmarke | +| `set_dark_titlebar()` | Fenstertitelleiste dunkel | +| `arm_autosave()` | speichert Einstellungen 600 ms nach jeder Änderung | + +**Oberfläche:** Zwei Reiter („Mikrofon", „Tasten und Verhalten") plus eine +Statusleiste mit den Knöpfen und der Zustandsanzeige (BEREITSCHAFT / +HORCHT / SENDET / GESPERRT). + +--- + +## 4. Release bauen, Installer und Updater + +Ein Befehl erzeugt alles: + +``` +.venv\Scripts\python.exe werkzeuge\baue_release.py +``` + +Die Version kommt aus `VERSION` in `squad_voice_activation.py`. Ergebnis in +`dist/` (nicht im Repository): aufbereitete Programmdateien, das +Update-Paket `SquadVoiceActivation-.zip`, der Installer +`SquadVoiceActivation-Setup-.exe` und `dist/server/` mit genau den +Dateien zum Hochladen samt `version.json` (Prüfsumme wird eingetragen). + +**Installer:** Inno Setup 6.7.3 unter +`%LOCALAPPDATA%\Programs\Inno Setup 6\ISCC.exe`. Skript +`installer/setup.iss`; es kopiert die Dateien und ruft danach +`installer/einrichten.bat` auf, das venv, Pakete und Verknüpfungen +anlegt. Norton lässt Inno-Setup-EXEs durch — anders als PyInstaller. +`einrichten.bat` wird **direkt** aufgerufen, nicht über `cmd /c`: dort +scheitern die verschachtelten Anführungszeichen, das venv wurde dann still +nicht angelegt. + +**Updater:** `pruefe_update()` holt beim Start +`https://sva.tyrveil.com/version.json`. Neuere Version → Hinweisbalken +unten. `lade_update()` prüft SHA-256, `spiele_update_ein()` entpackt und +startet einen Hilfsprozess, der nach Programmende die Dateien ersetzt und +neu startet. Nur `https://` wird akzeptiert. Getestet: manipulierte Datei +wird abgelehnt, Dateiersatz funktioniert, `3.9 < 3.10` korrekt. + +`installer/HOCHLADEN.txt` ist die Server-Anleitung für den Nutzer und wird +beim Bau nach `dist/server/` kopiert. `dist/server/` wird bei jedem Bau +gelöscht — nichts von Hand dort ablegen. + +**Einzelschritte**, falls nötig: `werkzeuge/strip.py` entfernt +Kommentare, `werkzeuge/umlaute.py` setzt echte Umlaute. Danach +Zeilenenden vereinheitlichen (`.bat`/`.vbs`/`.txt` als CRLF, `.py` als LF) +und **jede BOM entfernen** — siehe Erkenntnis 7. + +`werkzeuge/umlaute.py` arbeitet über `tokenize` und ersetzt nur in +STRING-Token. Achtung: In Python 3.12+ sind f-Strings **keine** +STRING-Token mehr, die müssen per Textersetzung nachbehandelt werden. + +Weitere Hilfsskripte: `werkzeuge/mictest.py` prüft jedes Audiogerät in +einem eigenen Prozess mit Zeitlimit (ein hängendes Gerät blockiert sonst +alles), `werkzeuge/screenshot.py` nimmt das Fenster inklusive Titelleiste +auf. + +--- + +## 5. Hart erkaufte Erkenntnisse + +Diese Punkte wurden durch Fehlschläge gefunden. Wer sie „aufräumt", baut +die Fehler wieder ein. + +**1 — `pythonw.exe` im venv ist ein Weiterleiter.** +Sie startet intern die Konsolenfassung `python.exe`, wodurch ein +Terminalfenster erscheint. Sie durch eine Kopie der echten `pythonw.exe` +zu ersetzen scheitert ebenfalls: Die Kopie findet ihre `python313.dll` +nicht (die liegt im Python-Ordner). **Lösung:** Die Verknüpfung startet die +echte `pythonw.exe` an ihrem Platz mit `start.pyw` als Argument; +`start.pyw` hängt `.venv\Lib\site-packages` selbst in `sys.path` ein. + +**2 — Ein venv erbt die Tcl/Tk-Pfade nicht.** +`tkinter` findet `init.tcl` nicht und bricht mit `TclError` ab. Deshalb +läuft `_ensure_tcl_paths()` **vor** dem `tkinter`-Import und setzt +`TCL_LIBRARY`/`TK_LIBRARY` aus `sys.base_prefix`. Die ungewöhnliche +Importreihenfolge im Kopf der Datei ist Absicht. + +**3 — Ein venv ist nicht portabel.** +`.venv\pyvenv.cfg` enthält feste Pfade. Auf einem anderen Rechner ist die +Umgebung unbrauchbar. Setup und Fehlersuche prüfen deshalb mit +`python -c "pass"`, ob sie überhaupt startet, und legen sie sonst neu an. +Das Weitergabepaket enthält kein `.venv`. + +**4 — PortAudio-Geräteindizes wandern.** +Sie ändern sich, sobald ein Treiber dazukommt oder verschwindet. Deshalb +wird überall mit dem Anzeigenamen gearbeitet und der Index erst +unmittelbar vor dem Öffnen aufgelöst (`selected_device()`). + +**5 — Windows meldet jedes Gerät über vier Schnittstellen.** +MME, DirectSound, WASAPI, WDM-KS. Beim Nutzer ergab das 18 Einträge für +2 echte Mikrofone. Regeln in `enumerate_inputs()`: +- WASAPI hat Vorrang, dann DirectSound, MME, WDM-KS +- MME kürzt Namen auf 31 Zeichen, deshalb Präfixvergleich in + `gleiches_geraet()` +- WDM-KS wird ausgeblendet, sobald WASAPI etwas liefert — dort erscheinen + Zweitnamen derselben Hardware (`wc19200_8211` war das Focusrite) und + Geräte, die in Windows gar nicht aktiv sind +- Platzhalter wie „Microsoft Soundmapper" werden entfernt +Ein Kontrollkästchen blendet die vollständige Liste wieder ein. + +**6 — Batch: Pipe in `for /f`-Backticks ist unzuverlässig.** +Hat zweimal still Leerwerte geliefert (Größenangabe blieb 0, ein +Prozess-Kill lief ins Leere). PowerShell-Aufrufe in Batch deshalb **ohne +Pipe** schreiben, stattdessen `foreach` mit `if`. + +**7 — PowerShell `-Encoding utf8` erzeugt in Windows PowerShell 5.1 eine BOM.** +VBScript bricht damit sofort ab (`Invalid character`, Zeile 1). Nach jeder +Bearbeitung von `.bat`/`.vbs` prüfen, dass keine BOM vorne steht. + +**8 — Norton 360 verhindert PyInstaller-Builds.** +Der Build bricht mit `Permission denied` ab, unabhängig von Dateiname, +Zielordner und `--onefile`/`--onedir`. Eine fertige EXE wird beim Start +blockiert und gelöscht. Deshalb gibt es **keine EXE**; die Verteilung +läuft über Setup.bat und setzt Python beim Empfänger voraus. Eine +Norton-Ausnahme wäre nötig — das ist eine Sicherheitseinstellung und +bleibt die Entscheidung des Nutzers. + +**9 — Der Windows-Audiodienst kann abstürzen.** +Ist auf diesem Rechner zweimal passiert. Dann scheitert jedes Audiogerät. +`audio_service_running()` prüft das beim Start und weist auf +`net start Audiosrv` hin (braucht Administratorrechte). + +**10 — Squad heißt im Prozess `SquadGame-Win64-Shipping.exe`.** +Verglichen wird per Präfix `SquadGame`. Der frühere Vergleich über den +Fenstertitel war falsch: Er traf auch auf das eigene Programmfenster und +jeden Explorer-Ordner mit „Squad" im Namen zu. + +**11 — Auf diesem Rechner gibt es zwei Python-Installationen.** +`python` zeigt auf die Microsoft-Store-Fassung (3.12), `py` auf die echte +3.13. Die Store-Fassung **virtualisiert `%APPDATA%`** — Zugriffe auf die +Konfigurationsdatei laufen dort ins Leere. Immer den venv-Interpreter +verwenden: `.venv\Scripts\python.exe`. + +**12 — Layout: Die Statusleiste muss vor dem Notebook gepackt werden.** +Mit `side="bottom"`. Sonst nimmt das Notebook (`expand=True`) allen Platz +und die Knöpfe fallen aus dem Fenster. Genau das ist einmal passiert. + +--- + +## 6. Umgebung + +- Windows 11 Pro, kein Git +- Python 3.13.0 unter `%LOCALAPPDATA%\Programs\Python\Python313` +- Norton 360 aktiv, Windows Defender dadurch abgeschaltet +- Audio: Focusrite USB (Hauptmikrofon) und SteelSeries Sonar (virtuell) +- Der Nutzer testet selbst und meldet zurück; er schließt das Fenster oft + zwischendurch — ein fehlender Prozess bedeutet nicht zwingend einen Fehler + +--- + +## 7. Offene Punkte + +**Design steht aus.** Der Nutzer hat mit Claude Design einen Entwurf +gebaut („Board mit bedienbarem Fenster"), der Export kam nie an — die ZIP +lag nicht in `Downloads`. Er soll sie erneut schicken. Der Auftrag dazu +steht in `Design-Briefing.md`: Teil A ein Design System, Teil B die beiden +Bildschirme. Wichtig beim Umsetzen: Was in `ttk` nicht geht (runde Ecken, +Schatten, Verläufe), lässt sich auf einer Zeichenfläche nachbauen — die +Pegelanzeige ist bereits so gelöst. + +**Server-Upload steht aus.** HTTPS auf `sva.tyrveil.com` läuft, aber +`version.json` und die Release-Dateien waren beim letzten Stand noch nicht +hochgeladen (HTTP 404). Der erste echte Durchlauf des Updaters gegen den +Server ist daher noch ungetestet. + +**Installer unsigniert.** Empfänger sehen beim ersten Start die +SmartScreen-Warnung. Abhilfe nur per Code-Signing-Zertifikat. + +**Programm selbst bleibt Python.** Eine gebündelte EXE per PyInstaller +scheitert an Norton (Erkenntnis 8); der Installer setzt Python beim +Empfänger voraus — bewusste Entscheidung des Nutzers. + +--- + +## 8. Arbeitsweise, die sich bewährt hat + +Der Nutzer meldet Symptome, keine Diagnosen („es öffnet sich ein +Konsolenfenster", „so viele Mikrofone"). Mehrfach lag die Ursache woanders +als vermutet, deshalb: **erst messen, dann ändern.** + +Drei Beispiele, in denen Messen die Annahme widerlegt hat: + +- Das Konsolenfenster kam nicht vom Startskript, sondern von einem + Kindprozess. Sichtbar wurde das erst über `ParentProcessId`. +- „Alle Mikrofone scheitern" war kein Gerätefehler, sondern der + abgestürzte Audiodienst — gefunden im Windows-Ereignisprotokoll. +- Eine Prüfung auf sichtbare Konsolenfenster meldete Entwarnung, weil die + Fensterklasse von Windows Terminal fehlte. Der Nutzer sah das Fenster + trotzdem. Ein negativer Testbefund ist kein Beweis. + +Änderungen immer an der **Quelle** vornehmen, dann das Paket neu erzeugen, +dann per `Update.bat` in die Installation bringen — und dort tatsächlich +starten. Ein Syntaxcheck reicht nicht: Mehrere Fehler zeigten sich erst +beim echten Doppelklick. diff --git a/README.md b/README.md new file mode 100644 index 0000000..4e0c87d --- /dev/null +++ b/README.md @@ -0,0 +1,52 @@ +# Squad Voice Activation — Quellordner + +Dies ist das Arbeitsverzeichnis, **nicht** das Paket zum Weitergeben. + +Der Code hier enthält Kommentare und dient der Weiterentwicklung. Das +auslieferbare Paket wird daraus erzeugt und liegt in +`..\Squad Voice Activation 3.1\`. + +## Inhalt + +| Datei | Zweck | +|---|---| +| `squad_voice_activation.py` | Hauptprogramm | +| `start.pyw` | Startskript ohne Konsolenfenster | +| `make_icon.py` | erzeugt `icon.ico` aus `icon.png` | +| `icon.png`, `icon.ico` | Programmsymbol | +| `requirements.txt` | numpy, sounddevice | +| `werkzeuge/` | Hilfsskripte für den Paketbau und Tests | +| `PROJEKT-UEBERGABE.md` | **Technische Dokumentation, hier anfangen** | +| `Design-Briefing.md` | Auftrag für die Gestaltung | + +Die Skripte `Setup.bat`, `Update.bat`, `Deinstallieren.bat`, +`Fehlersuche.bat` und `Starter.vbs` werden **direkt im Paket gepflegt** — +sie durchlaufen keine Aufbereitung und haben deshalb keine Kopie hier. + +## Programm zum Testen starten + +``` +.venv\Scripts\python.exe squad_voice_activation.py +``` + +Immer den Interpreter aus `.venv` verwenden. Auf diesem Rechner zeigt +`python` auf die Microsoft-Store-Fassung, die `%APPDATA%` virtualisiert — +die Konfigurationsdatei wäre dann nicht auffindbar. + +## Paket erzeugen + +``` +.venv\Scripts\python.exe werkzeuge\strip.py squad_voice_activation.py +.venv\Scripts\python.exe werkzeuge\umlaute.py squad_voice_activation.py +``` + +Danach die aufbereiteten Dateien nach `Squad Voice Activation 3.1\Programm\` +kopieren. Einzelheiten und Fallstricke stehen in `PROJEKT-UEBERGABE.md`, +Abschnitt 4. + +Arbeite an einer Kopie, nicht an den Dateien in diesem Ordner — die +Aufbereitung entfernt die Kommentare unwiderruflich. + +## Bedienung des Programms + +Die Anleitung für Endnutzer ist `ANLEITUNG.txt` im Paket. diff --git a/Squad-Voice.png b/Squad-Voice.png new file mode 100644 index 0000000000000000000000000000000000000000..a9e29b2069f26a9a2fa3121273d0a8d562d4b60e GIT binary patch literal 28886 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 Trotzdem +ausführen. Sag das am besten gleich dazu. + + +NGINX +----- +Meist genügt die vorhandene Konfiguration. Falls der Download der ZIP +im Browser geöffnet statt gespeichert wird, hilft dieser Zusatz im +server-Block: + + location ~* \.(zip|exe)$ { + add_header Content-Disposition "attachment"; + } + + location = /version.json { + add_header Cache-Control "no-cache"; + default_type application/json; + } + +Die Zeile zu version.json ist die wichtigere: Ohne sie kann ein +zwischengeschalteter Zwischenspeicher noch die alte Versionsnummer +ausliefern, nachdem du längst eine neue hochgeladen hast. + + +WIE DAS UPDATE FUNKTIONIERT +--------------------------- +Das Programm ruft beim Start version.json ab. Steht dort eine höhere +Versionsnummer als die installierte, erscheint unten im Fenster ein +Hinweisbalken mit einer Schaltfläche. Ein Klick lädt die ZIP, prüft die +Prüfsumme, ersetzt die Programmdateien und startet neu. + +Ist der Server nicht erreichbar, passiert schlicht nichts — das +Programm läuft dann ganz normal ohne Hinweis weiter. + + +NEUE VERSION VERÖFFENTLICHEN +---------------------------- +1. In squad_voice_activation.py die Zeile VERSION anpassen +2. Im Quellordner ausführen: + + .venv\Scripts\python.exe werkzeuge\baue_release.py + +3. Den Inhalt von dist\server\ hochladen + +Der Bauvorgang berechnet die Prüfsumme selbst und trägt sie in +version.json ein. Diese Datei niemals von Hand bearbeiten: Stimmt die +Prüfsumme nicht mit der ZIP überein, verweigert das Programm das +Update - genau so ist es gedacht. + +Das Feld "hinweis" darfst du füllen, es erscheint im Hinweisbalken: + + "hinweis": "Mikrofonliste aufgeräumt" + +Halte es kurz, es steht neben der Schaltfläche. + + +WARUM HTTPS PFLICHT IST +----------------------- +Das Programm lädt ausschließlich über HTTPS und lehnt http:// ab. Ein +Updater, der Programmcode über eine unverschlüsselte Verbindung holt, +ließe sich in einem fremden WLAN umleiten - dann käme fremder Code auf +die Rechner deiner Freunde. Die Prüfsumme allein schützt davor nicht, +weil ein Angreifer auch sie mitliefern könnte. diff --git a/installer/einrichten.bat b/installer/einrichten.bat new file mode 100644 index 0000000..de72f3c --- /dev/null +++ b/installer/einrichten.bat @@ -0,0 +1,81 @@ +@echo off +setlocal EnableExtensions +rem Wird vom Installationsprogramm nach dem Kopieren aufgerufen. +rem Legt die Laufzeitumgebung an und erstellt die Verknuepfungen. + +set "SVA_DIR=%~1" +if "%SVA_DIR%"=="" set "SVA_DIR=%~dp0" +if "%SVA_DIR:~-1%"=="\" set "SVA_DIR=%SVA_DIR:~0,-1%" + +set "MITDESKTOP=%~2" +set "STARTMENU=%APPDATA%\Microsoft\Windows\Start Menu\Programs" +set "DESKTOP=%USERPROFILE%\Desktop" + +echo. +echo Richte Laufzeitumgebung ein. Das dauert einen Moment ... +echo. + +py -3 -c "import sys; sys.exit(0 if sys.version_info >= (3,9) else 1)" >nul 2>&1 +if errorlevel 1 ( + echo FEHLER: Python 3.9 oder neuer wurde nicht gefunden. + echo Bitte von https://www.python.org/downloads/ installieren + echo und dabei "Add python.exe to PATH" ankreuzen. + echo Danach dieses Programm erneut installieren. + pause + exit /b 1 +) + +if exist "%SVA_DIR%\.venv\Scripts\python.exe" ( + "%SVA_DIR%\.venv\Scripts\python.exe" -c "pass" >nul 2>&1 + if errorlevel 1 rmdir /s /q "%SVA_DIR%\.venv" +) +if not exist "%SVA_DIR%\.venv\Scripts\python.exe" ( + py -3 -m venv "%SVA_DIR%\.venv" + if errorlevel 1 ( + echo FEHLER: Laufzeitumgebung konnte nicht angelegt werden. + pause + exit /b 1 + ) +) + +"%SVA_DIR%\.venv\Scripts\python.exe" -m pip install --disable-pip-version-check --quiet -r "%SVA_DIR%\requirements.txt" +if errorlevel 1 ( + echo FEHLER: Benoetigte Pakete konnten nicht geladen werden. + echo Besteht eine Internetverbindung? + pause + exit /b 1 +) + +"%SVA_DIR%\.venv\Scripts\python.exe" -c "import os,sys; p=os.path.join(sys.base_prefix,'pythonw.exe'); open(os.path.join(sys.prefix,'basepyw.txt'),'w').write(p if os.path.isfile(p) else '')" +set "BASEPYW=" +if exist "%SVA_DIR%\.venv\basepyw.txt" set /p BASEPYW=<"%SVA_DIR%\.venv\basepyw.txt" +del "%SVA_DIR%\.venv\basepyw.txt" >nul 2>&1 +if not defined BASEPYW set "BASEPYW=%SVA_DIR%\.venv\Scripts\pythonw.exe" + +if exist "%SVA_DIR%\icon.png" "%SVA_DIR%\.venv\Scripts\python.exe" "%SVA_DIR%\make_icon.py" >nul 2>&1 +set "SVA_ICON=%BASEPYW%,0" +if exist "%SVA_DIR%\icon.ico" set "SVA_ICON=%SVA_DIR%\icon.ico" + +powershell -NoProfile -ExecutionPolicy Bypass -Command ^ + "$ws = New-Object -ComObject WScript.Shell;" ^ + "$s = $ws.CreateShortcut('%STARTMENU%\Squad Voice Activation.lnk');" ^ + "$s.TargetPath = '%BASEPYW%';" ^ + "$s.Arguments = '\"%SVA_DIR%\start.pyw\"';" ^ + "$s.WorkingDirectory = '%SVA_DIR%';" ^ + "$s.IconLocation = '%SVA_ICON%';" ^ + "$s.Description = 'Haelt die Sprechtaste, solange du redest';" ^ + "$s.Save()" + +if /i "%MITDESKTOP%"=="desktop" powershell -NoProfile -ExecutionPolicy Bypass -Command ^ + "$ws = New-Object -ComObject WScript.Shell;" ^ + "$s = $ws.CreateShortcut('%DESKTOP%\Squad Voice Activation.lnk');" ^ + "$s.TargetPath = '%BASEPYW%';" ^ + "$s.Arguments = '\"%SVA_DIR%\start.pyw\"';" ^ + "$s.WorkingDirectory = '%SVA_DIR%';" ^ + "$s.IconLocation = '%SVA_ICON%';" ^ + "$s.Description = 'Haelt die Sprechtaste, solange du redest';" ^ + "$s.Save()" + +echo Fertig. +endlocal +exit /b 0 diff --git a/installer/paketdateien/Fehlersuche.bat b/installer/paketdateien/Fehlersuche.bat new file mode 100644 index 0000000..368ba0b --- /dev/null +++ b/installer/paketdateien/Fehlersuche.bat @@ -0,0 +1,58 @@ +@echo off +setlocal +title Squad Voice Activation - Fehlersuche +cd /d "%~dp0" + +echo. +echo Startet das Programm mit sichtbarem Fenster fuer Meldungen. +echo Nur noetig, wenn der normale Start nicht funktioniert. +echo. + +set "PY=.venv\Scripts\python.exe" + +if exist "%PY%" ( + "%PY%" -c "pass" >nul 2>&1 + if errorlevel 1 ( + echo [Setup] Vorhandene Umgebung passt nicht zu diesem Rechner. + echo Sie wird verworfen und neu angelegt. + rmdir /s /q "%~dp0.venv" + ) +) + +if not exist "%PY%" ( + echo [Setup] Erstelle Laufzeitumgebung ... + py -3 -m venv .venv + if errorlevel 1 ( + echo. + echo FEHLER: Python 3 wurde nicht gefunden. + echo Download: https://www.python.org/downloads/ + pause + exit /b 1 + ) + set "NEEDINSTALL=1" +) + +"%PY%" -c "import numpy, sounddevice" >nul 2>&1 +if errorlevel 1 set "NEEDINSTALL=1" + +if defined NEEDINSTALL ( + echo [Setup] Installiere Pakete ... + "%PY%" -m pip install --disable-pip-version-check -r requirements.txt + if errorlevel 1 ( + echo FEHLER: Pakete konnten nicht installiert werden. + pause + exit /b 1 + ) +) + +echo [Start] Squad Voice Activation +"%PY%" squad_voice_activation.py +set "RC=%ERRORLEVEL%" + +if not "%RC%"=="0" ( + echo. + echo Das Programm wurde mit Fehlercode %RC% beendet. +) +echo. +pause +endlocal diff --git a/installer/paketdateien/Starter.vbs b/installer/paketdateien/Starter.vbs new file mode 100644 index 0000000..7ade4ee --- /dev/null +++ b/installer/paketdateien/Starter.vbs @@ -0,0 +1,49 @@ +' Startet das Programm ohne jedes Konsolenfenster. +' Arbeitet ausschliesslich mit Pfaden relativ zu dieser Datei, damit der +' Ordner verschoben oder weitergegeben werden kann. +Option Explicit + +Dim fso, sh, ordner, pakete, cfg, zeile, basis, pyw, bereit +Set fso = CreateObject("Scripting.FileSystemObject") +Set sh = CreateObject("WScript.Shell") + +ordner = fso.GetParentFolderName(WScript.ScriptFullName) +pakete = ordner & "\.venv\Lib\site-packages" +sh.CurrentDirectory = ordner + +' Die pythonw.exe in der virtuellen Umgebung ist nur ein Weiterleiter, der +' intern die Konsolenfassung nachstartet - dabei erscheint ein Fenster. +' Deshalb wird die echte pythonw.exe der Installation gesucht. Ihr Pfad +' steht in pyvenv.cfg unter "home". +basis = "" +If fso.FileExists(ordner & "\.venv\pyvenv.cfg") Then + Dim datei + Set datei = fso.OpenTextFile(ordner & "\.venv\pyvenv.cfg", 1) + Do Until datei.AtEndOfStream + zeile = Trim(datei.ReadLine) + If LCase(Left(zeile, 4)) = "home" Then + basis = Trim(Mid(zeile, InStr(zeile, "=") + 1)) + End If + Loop + datei.Close +End If + +pyw = "" +If basis <> "" And fso.FileExists(basis & "\pythonw.exe") Then + pyw = basis & "\pythonw.exe" +ElseIf fso.FileExists(ordner & "\.venv\Scripts\pythonw.exe") Then + pyw = ordner & "\.venv\Scripts\pythonw.exe" +End If + +bereit = (pyw <> "") _ + And fso.FolderExists(pakete & "\numpy") _ + And fso.FileExists(pakete & "\sounddevice.py") _ + And fso.FileExists(ordner & "\start.pyw") + +If bereit Then + sh.Run """" & pyw & """ """ & ordner & "\start.pyw""", 0, False +Else + ' Umgebung fehlt oder ist unvollstaendig - run.bat richtet sie ein + ' und zeigt dabei bewusst ein Fenster mit Meldungen. + sh.Run """" & ordner & "\run.bat""", 1, False +End If diff --git a/installer/setup.iss b/installer/setup.iss new file mode 100644 index 0000000..05b368e --- /dev/null +++ b/installer/setup.iss @@ -0,0 +1,86 @@ +; Installationsprogramm fuer Squad Voice Activation +; Uebersetzen mit: ISCC.exe setup.iss + +#define Name "Squad Voice Activation" +#define Version "3.2" +#define Herausgeber "tyrveil.com" +#define Website "https://sva.tyrveil.com" + +[Setup] +AppId={{8F3A6C21-5D4E-4B9A-9E7C-2A1B0D6F4E88} +AppName={#Name} +AppVersion={#Version} +AppVerName={#Name} {#Version} +AppPublisher={#Herausgeber} +AppPublisherURL={#Website} +AppSupportURL={#Website} +DefaultDirName={autopf}\SquadVoiceActivation +DefaultGroupName={#Name} +DisableProgramGroupPage=yes +DisableDirPage=no +AllowNoIcons=yes +PrivilegesRequired=lowest +PrivilegesRequiredOverridesAllowed=dialog +OutputDir=..\dist +OutputBaseFilename=SquadVoiceActivation-Setup-{#Version} +SetupIconFile=..\icon.ico +UninstallDisplayIcon={app}\icon.ico +UninstallDisplayName={#Name} +Compression=lzma2 +SolidCompression=yes +WizardStyle=modern +ShowLanguageDialog=no + +[Languages] +Name: "de"; MessagesFile: "compiler:Languages\German.isl" + +[Messages] +de.WelcomeLabel2=Dieses Programm haelt die Sprechtaste in Squad automatisch gedrueckt, solange du redest.%n%nVoraussetzung ist Python 3.9 oder neuer. Fehlt es, wird am Ende ein Hinweis angezeigt. + +[Tasks] +Name: "desktopicon"; Description: "Verknuepfung auf dem Desktop anlegen"; GroupDescription: "Zusaetzliche Verknuepfungen:" + +[Files] +Source: "..\dist\installerdateien\*"; DestDir: "{app}"; Flags: ignoreversion +Source: "einrichten.bat"; DestDir: "{app}"; Flags: ignoreversion + +[Icons] +Name: "{group}\{#Name}"; Filename: "{app}\Starter.vbs"; IconFilename: "{app}\icon.ico" +Name: "{group}\{#Name} deinstallieren"; Filename: "{uninstallexe}" + +[Run] +; Die Batchdatei direkt aufrufen. Der Umweg ueber cmd /c scheitert an den +; verschachtelten Anfuehrungszeichen, sobald der Zielpfad Leerzeichen enthaelt. +Filename: "{app}\einrichten.bat"; Parameters: """{app}"" {code:DesktopWunsch}"; \ + StatusMsg: "Richte Laufzeitumgebung ein, bitte warten ..."; Flags: runhidden waituntilterminated +Filename: "{app}\Starter.vbs"; Description: "{#Name} jetzt starten"; \ + Flags: shellexec nowait postinstall skipifsilent + +[UninstallDelete] +Type: filesandordirs; Name: "{app}\.venv" +Type: filesandordirs; Name: "{app}\__pycache__" +Type: files; Name: "{app}\icon.ico" +Type: files; Name: "{userdesktop}\Squad Voice Activation.lnk" +Type: files; Name: "{userstartmenu}\Squad Voice Activation.lnk" + +[Code] +function DesktopWunsch(Param: String): String; +begin + if WizardIsTaskSelected('desktopicon') then + Result := 'desktop' + else + Result := 'nodesktop'; +end; + +procedure CurUninstallStepChanged(CurUninstallStep: TUninstallStep); +var + Auswahl: Integer; +begin + if CurUninstallStep = usPostUninstall then + begin + Auswahl := MsgBox('Sollen auch die gespeicherten Einstellungen entfernt werden?', + mbConfirmation, MB_YESNO); + if Auswahl = IDYES then + DelTree(ExpandConstant('{userappdata}\SquadVoiceActivation'), True, True, True); + end; +end; diff --git a/make_icon.py b/make_icon.py new file mode 100644 index 0000000..c05868b --- /dev/null +++ b/make_icon.py @@ -0,0 +1,147 @@ +""" +Erzeugt icon.ico aus icon.png - ohne Zusatzbibliotheken. + +Liegt keine icon.png vor, wird ein schlichtes Standardsymbol gezeichnet +(Mikrofon mit Schallwellen in den Farben der Oberflaeche). + +Eigenes Symbol verwenden: eine quadratische PNG-Datei mit hoechstens +256 x 256 Bildpunkten als icon.png in diesen Ordner legen und das +Programm neu starten. Fuer die Verknuepfungen zusaetzlich Setup.bat +erneut ausfuehren. +""" + +import struct +import sys +import zlib +from pathlib import Path + +ORDNER = Path(__file__).resolve().parent +PNG = ORDNER / "icon.png" +ICO = ORDNER / "icon.ico" + +GROESSE = 256 +# Farben passend zur Oberflaeche +HINTERGRUND = (30, 35, 27, 255) +RAND = (110, 139, 61, 255) +MIKRO = (156, 186, 92, 255) +WELLE = (217, 164, 65, 255) +LEER = (0, 0, 0, 0) + + +def png_schreiben(pfad, breite, hoehe, pixel): + """Schreibt ein RGBA-Bild als PNG. pixel ist eine Liste von Zeilen.""" + roh = bytearray() + for zeile in pixel: + roh.append(0) # Filtertyp "keiner" + for r, g, b, a in zeile: + roh += bytes((r, g, b, a)) + + def chunk(typ, daten): + return (struct.pack(">I", len(daten)) + typ + daten + + struct.pack(">I", zlib.crc32(typ + daten) & 0xFFFFFFFF)) + + kopf = struct.pack(">IIBBBBB", breite, hoehe, 8, 6, 0, 0, 0) + pfad.write_bytes( + b"\x89PNG\r\n\x1a\n" + + chunk(b"IHDR", kopf) + + chunk(b"IDAT", zlib.compress(bytes(roh), 9)) + + chunk(b"IEND", b"") + ) + + +def standard_symbol(): + """Mikrofon mit zwei Schallbogen, schlicht gehalten.""" + n = GROESSE + mitte = n / 2 + bild = [[LEER for _ in range(n)] for _ in range(n)] + + for y in range(n): + for x in range(n): + dx, dy = x - mitte, y - mitte + r = (dx * dx + dy * dy) ** 0.5 + farbe = LEER + if r <= n * 0.47: + farbe = HINTERGRUND + if n * 0.44 <= r <= n * 0.47: + farbe = RAND + + # Mikrofonkapsel: abgerundetes Rechteck im oberen Bereich + if abs(dx) <= n * 0.10 and -n * 0.28 <= dy <= n * 0.06: + ecke = abs(dy + n * 0.11) - n * 0.11 + if ecke <= 0 or (dx * dx + ecke * ecke) ** 0.5 <= n * 0.10: + farbe = MIKRO + # Buegel unter der Kapsel + if n * 0.15 <= r <= n * 0.19 and dy > 0 and abs(dx) < n * 0.20: + farbe = MIKRO + # Staender und Fuss + if abs(dx) <= n * 0.022 and n * 0.17 <= dy <= n * 0.30: + farbe = MIKRO + if abs(dx) <= n * 0.11 and n * 0.28 <= dy <= n * 0.32: + farbe = MIKRO + # Zwei Schallbogen links und rechts + for radius in (n * 0.27, n * 0.35): + if abs(r - radius) <= n * 0.022 and abs(dy) < abs(dx) * 0.9: + farbe = WELLE + + bild[y][x] = farbe + return bild + + +def png_zu_ico(png_pfad, ico_pfad): + """ + Verpackt ein PNG unveraendert in einen ICO-Behaelter. + + Seit Windows Vista duerfen Symboldateien PNG-Daten direkt enthalten, + das Bild muss also nicht entschluesselt werden. + """ + daten = png_pfad.read_bytes() + if daten[:8] != b"\x89PNG\r\n\x1a\n": + raise ValueError(f"{png_pfad.name} ist keine PNG-Datei.") + breite, hoehe = struct.unpack(">II", daten[16:24]) + if breite > 256 or hoehe > 256: + raise ValueError( + f"{png_pfad.name} ist {breite}x{hoehe} Bildpunkte gross. " + "Zulaessig sind hoechstens 256x256.") + + kopf = struct.pack("=1.26 +sounddevice>=0.4.6 diff --git a/squad_voice_activation.py b/squad_voice_activation.py new file mode 100644 index 0000000..8eeb2ca --- /dev/null +++ b/squad_voice_activation.py @@ -0,0 +1,1623 @@ +""" +Squad Voice Activation +Haelt die Local-VOIP-Taste automatisch gedrueckt, solange gesprochen wird. + +Greift nicht in Squad ein: kein Hook, keine DLL, kein Speicherzugriff. +Liest nur den Mikrofonpegel und ruft Windows SendInput / GetAsyncKeyState auf. +""" + +import ctypes +import ctypes.wintypes as wintypes +import json +import os +import queue +import sys +import threading +import time +from pathlib import Path + + +def _ensure_tcl_paths(): + """ + Muss vor dem tkinter-Import laufen. + + Eine virtuelle Umgebung erbt unter Windows die Tcl/Tk-Pfade der + Basisinstallation nicht. tkinter findet dann init.tcl nicht und + bricht mit einem TclError ab. Hier werden die Pfade nachgezogen, + damit das Programm auch per Doppelklick oder Verknuepfung startet. + """ + if getattr(sys, "frozen", False): + return # gepackte EXE bringt Tcl/Tk selbst mit + tcl_root = Path(getattr(sys, "base_prefix", sys.prefix)) / "tcl" + if not tcl_root.is_dir(): + return + for var, prefix, marker in (("TCL_LIBRARY", "tcl8", "init.tcl"), + ("TK_LIBRARY", "tk8", "tk.tcl")): + if os.environ.get(var): + continue + for folder in sorted(tcl_root.glob(prefix + "*")): + if (folder / marker).is_file(): + os.environ[var] = str(folder) + break + + +_ensure_tcl_paths() + +import tkinter as tk # noqa: E402 +from tkinter import ttk, messagebox # noqa: E402 + +import numpy as np # noqa: E402 +import sounddevice as sd # noqa: E402 + +APP_NAME = "Squad Voice Activation" +VERSION = "3.2" +CONFIG_PATH = Path(os.getenv("APPDATA", ".")) / "SquadVoiceActivation" / "config.json" +LOG_PATH = CONFIG_PATH.parent / "error.log" + + +UPDATE_URL = "https://sva.tyrveil.com/version.json" + + +def version_tupel(text): + """'3.10' wird zu (3, 10), damit 3.10 groesser ist als 3.9.""" + teile = [] + for stueck in str(text).strip().split("."): + ziffern = "".join(z for z in stueck if z.isdigit()) + teile.append(int(ziffern) if ziffern else 0) + return tuple(teile) + + +def pruefe_update(timeout=6): + """ + Fragt die Versionsdatei auf dem Server ab. + + Gibt die Angaben zurueck, wenn dort eine neuere Fassung steht, sonst + None. Netzwerkfehler sind kein Grund fuer eine Meldung - ohne + Internetverbindung laeuft das Programm ganz normal weiter. + """ + import json as _json + import urllib.request + + if not UPDATE_URL.lower().startswith("https://"): + return None + try: + anfrage = urllib.request.Request( + UPDATE_URL, headers={"User-Agent": f"{APP_NAME}/{VERSION}"}) + with urllib.request.urlopen(anfrage, timeout=timeout) as antwort: + angaben = _json.loads(antwort.read(65536).decode("utf-8")) + except Exception: + return None + + ziel = str(angaben.get("version", "")).strip() + datei = str(angaben.get("datei", "")).strip() + if not ziel or not datei.lower().startswith("https://"): + return None + if version_tupel(ziel) <= version_tupel(VERSION): + return None + return { + "version": ziel, + "datei": datei, + "sha256": str(angaben.get("sha256", "")).strip().lower(), + "hinweis": str(angaben.get("hinweis", "")).strip()[:200], + } + + +def lade_update(angaben, ziel_pfad, fortschritt=None): + """Laedt das Paket und prueft die Pruefsumme.""" + import hashlib + import urllib.request + + anfrage = urllib.request.Request( + angaben["datei"], headers={"User-Agent": f"{APP_NAME}/{VERSION}"}) + hasher = hashlib.sha256() + geladen = 0 + with urllib.request.urlopen(anfrage, timeout=30) as antwort: + gesamt = int(antwort.headers.get("Content-Length") or 0) + with open(ziel_pfad, "wb") as datei: + while True: + brocken = antwort.read(65536) + if not brocken: + break + datei.write(brocken) + hasher.update(brocken) + geladen += len(brocken) + if fortschritt and gesamt: + fortschritt(geladen, gesamt) + + erwartet = angaben.get("sha256", "") + if erwartet and hasher.hexdigest() != erwartet: + raise ValueError( + "Die heruntergeladene Datei stimmt nicht mit der angegebenen " + "Pruefsumme ueberein und wurde verworfen.") + return ziel_pfad + + +def spiele_update_ein(zip_pfad, programm_ordner): + """ + Entpackt das Paket und startet einen Helfer, der die Dateien ersetzt. + + Das laufende Programm kann seine eigenen Dateien nicht ueberschreiben. + Deshalb uebernimmt ein kleines Skript das Kopieren, nachdem sich das + Programm beendet hat, und startet es anschliessend neu. + """ + import subprocess + import tempfile + import zipfile + + arbeit = Path(tempfile.mkdtemp(prefix="sva_update_")) + with zipfile.ZipFile(zip_pfad) as archiv: + archiv.extractall(arbeit) + + quelle = arbeit / "Programm" + if not quelle.is_dir(): + treffer = list(arbeit.rglob("squad_voice_activation.py")) + if not treffer: + raise ValueError("Im Paket wurde kein Programmordner gefunden.") + quelle = treffer[0].parent + + helfer = arbeit / "einspielen.bat" + helfer.write_text( + "@echo off\r\n" + "ping -n 4 127.0.0.1 >nul\r\n" + f'xcopy /e /y /i /q "{quelle}\\*" "{programm_ordner}\\" >nul\r\n' + f'start "" "{sys.executable}" "{programm_ordner}\\start.pyw"\r\n' + "ping -n 2 127.0.0.1 >nul\r\n" + f'rmdir /s /q "{arbeit}"\r\n', + encoding="ascii") + + subprocess.Popen(["cmd", "/c", str(helfer)], + creationflags=0x08000000) # kein Konsolenfenster + return True + + +def log_exception(exc_type, exc, tb): + """Schreibt einen Fehler ins Log. Ohne Konsolenfenster geht er sonst verloren.""" + import traceback + text = "".join(traceback.format_exception(exc_type, exc, tb)) + try: + LOG_PATH.parent.mkdir(parents=True, exist_ok=True) + with open(LOG_PATH, "a", encoding="utf-8") as fh: + fh.write(f"\n--- {time.strftime('%Y-%m-%d %H:%M:%S')} ---\n{text}") + except Exception: + pass + return text + +# --------------------------------------------------------------------------- +# Win32 +# --------------------------------------------------------------------------- +user32 = ctypes.WinDLL("user32", use_last_error=True) +kernel32 = ctypes.WinDLL("kernel32", use_last_error=True) + +PROCESS_QUERY_LIMITED_INFORMATION = 0x1000 +# Der laufende Prozess heisst SquadGame-Win64-Shipping.exe, der Launcher +# SquadGame.exe. Verglichen wird per Praefix, damit beide passen - und +# damit dieses Programm selbst nicht versehentlich als Squad zaehlt. +SQUAD_PROCESS_DEFAULT = "SquadGame" + +INPUT_MOUSE = 0 +INPUT_KEYBOARD = 1 +KEYEVENTF_KEYUP = 0x0002 + +MOUSEEVENTF_MIDDLEDOWN = 0x0020 +MOUSEEVENTF_MIDDLEUP = 0x0040 +MOUSEEVENTF_XDOWN = 0x0080 +MOUSEEVENTF_XUP = 0x0100 + +CURSOR_SHOWING = 0x0001 + +# ULONG_PTR ist zeigergross: 64 Bit auf 64-Bit-Windows +ULONG_PTR = wintypes.WPARAM + + +class KEYBDINPUT(ctypes.Structure): + _fields_ = [ + ("wVk", wintypes.WORD), + ("wScan", wintypes.WORD), + ("dwFlags", wintypes.DWORD), + ("time", wintypes.DWORD), + ("dwExtraInfo", ULONG_PTR), + ] + + +class MOUSEINPUT(ctypes.Structure): + _fields_ = [ + ("dx", wintypes.LONG), + ("dy", wintypes.LONG), + ("mouseData", wintypes.DWORD), + ("dwFlags", wintypes.DWORD), + ("time", wintypes.DWORD), + ("dwExtraInfo", ULONG_PTR), + ] + + +class HARDWAREINPUT(ctypes.Structure): + _fields_ = [ + ("uMsg", wintypes.DWORD), + ("wParamL", wintypes.WORD), + ("wParamH", wintypes.WORD), + ] + + +class _INPUTUNION(ctypes.Union): + _fields_ = [("ki", KEYBDINPUT), ("mi", MOUSEINPUT), ("hi", HARDWAREINPUT)] + + +class INPUT(ctypes.Structure): + _anonymous_ = ("u",) + _fields_ = [("type", wintypes.DWORD), ("u", _INPUTUNION)] + + +class POINT(ctypes.Structure): + _fields_ = [("x", wintypes.LONG), ("y", wintypes.LONG)] + + +class CURSORINFO(ctypes.Structure): + _fields_ = [ + ("cbSize", wintypes.DWORD), + ("flags", wintypes.DWORD), + ("hCursor", wintypes.HANDLE), + ("ptScreenPos", POINT), + ] + + +user32.SendInput.argtypes = (wintypes.UINT, ctypes.POINTER(INPUT), ctypes.c_int) +user32.SendInput.restype = wintypes.UINT +user32.GetAsyncKeyState.argtypes = (ctypes.c_int,) +user32.GetAsyncKeyState.restype = ctypes.c_short +user32.GetCursorInfo.argtypes = (ctypes.POINTER(CURSORINFO),) +user32.GetCursorInfo.restype = wintypes.BOOL +user32.GetWindowThreadProcessId.argtypes = (wintypes.HWND, ctypes.POINTER(wintypes.DWORD)) +user32.GetWindowThreadProcessId.restype = wintypes.DWORD + +kernel32.OpenProcess.argtypes = (wintypes.DWORD, wintypes.BOOL, wintypes.DWORD) +kernel32.OpenProcess.restype = wintypes.HANDLE +kernel32.QueryFullProcessImageNameW.argtypes = ( + wintypes.HANDLE, wintypes.DWORD, wintypes.LPWSTR, ctypes.POINTER(wintypes.DWORD)) +kernel32.QueryFullProcessImageNameW.restype = wintypes.BOOL +kernel32.CloseHandle.argtypes = (wintypes.HANDLE,) +kernel32.CloseHandle.restype = wintypes.BOOL + +# --------------------------------------------------------------------------- +# Tastentabelle: Anzeigename -> (art, code) +# art "key" -> code ist ein Virtual-Key-Code +# art "mouse" -> code ist die XBUTTON-Nummer (3 = mittlere Maustaste) +# --------------------------------------------------------------------------- +VK_MBUTTON, VK_XBUTTON1, VK_XBUTTON2 = 0x04, 0x05, 0x06 + +KEYS = {} +for _c in "ABCDEFGHIJKLMNOPQRSTUVWXYZ": + KEYS[_c] = ("key", ord(_c)) +for _n in range(10): + KEYS[str(_n)] = ("key", 0x30 + _n) +for _i in range(1, 13): + KEYS[f"F{_i}"] = ("key", 0x6F + _i) +KEYS.update({ + "Maus mitte": ("mouse", 3), + "Maus 4": ("mouse", 1), + "Maus 5": ("mouse", 2), + "Pause": ("key", 0x13), + "Rollen": ("key", 0x91), + "Einfg": ("key", 0x2D), + "Entf": ("key", 0x2E), + "Pos1": ("key", 0x24), + "Ende": ("key", 0x23), + "Bild auf": ("key", 0x21), + "Bild ab": ("key", 0x22), +}) + +KEY_NAMES = list(KEYS.keys()) +NONE_LABEL = "(keine)" +NO_MOD_LABEL = "(kein)" + +# Zusatztasten fuer Kombinationen wie Strg+V (Squad "Direct Voice" o. ae.) +MODIFIERS = { + NO_MOD_LABEL: None, + "Strg": 0x11, # VK_CONTROL + "Alt": 0x12, # VK_MENU + "Shift": 0x10, # VK_SHIFT +} +MOD_NAMES = list(MODIFIERS.keys()) + + +def _async_vk(name): + """Virtual-Key-Code, mit dem GetAsyncKeyState diese Taste abgefragt wird.""" + kind, code = KEYS[name] + if kind == "key": + return code + return {1: VK_XBUTTON1, 2: VK_XBUTTON2, 3: VK_MBUTTON}[code] + + +def is_physically_down(name): + """True, wenn die Taste gerade gedrueckt ist (egal ob echt oder simuliert).""" + if name not in KEYS: + return False + return bool(user32.GetAsyncKeyState(_async_vk(name)) & 0x8000) + + +def is_binding_down(mod, name): + """True, wenn Taste und ggf. zugehoerige Zusatztaste gleichzeitig gehalten werden.""" + if name not in KEYS: + return False + mod_vk = MODIFIERS.get(mod) + if mod_vk is not None and not (user32.GetAsyncKeyState(mod_vk) & 0x8000): + return False + return is_physically_down(name) + + +def _send(kind, **fields): + if kind == "key": + inp = INPUT(type=INPUT_KEYBOARD, ki=KEYBDINPUT(**fields)) + else: + inp = INPUT(type=INPUT_MOUSE, mi=MOUSEINPUT(**fields)) + sent = user32.SendInput(1, ctypes.byref(inp), ctypes.sizeof(INPUT)) + if sent != 1: + err = ctypes.get_last_error() + raise OSError(err, f"SendInput fehlgeschlagen (sent={sent}, error={err})") + + +def send_input_key(name, down): + """Drueckt bzw. loesst die benannte Taste.""" + kind, code = KEYS[name] + if kind == "key": + _send("key", wVk=code, wScan=0, + dwFlags=0 if down else KEYEVENTF_KEYUP, time=0, dwExtraInfo=0) + elif code == 3: + _send("mouse", dx=0, dy=0, mouseData=0, + dwFlags=MOUSEEVENTF_MIDDLEDOWN if down else MOUSEEVENTF_MIDDLEUP, + time=0, dwExtraInfo=0) + else: + _send("mouse", dx=0, dy=0, mouseData=code, + dwFlags=MOUSEEVENTF_XDOWN if down else MOUSEEVENTF_XUP, + time=0, dwExtraInfo=0) + + +def send_modifier(mod, down): + vk = MODIFIERS.get(mod) + if vk is None: + return + _send("key", wVk=vk, wScan=0, + dwFlags=0 if down else KEYEVENTF_KEYUP, time=0, dwExtraInfo=0) + + +def send_binding(mod, name, down): + """Drueckt bzw. loesst eine Kombination. Zusatztaste zuerst rein, zuletzt raus.""" + if down: + send_modifier(mod, True) + send_input_key(name, True) + else: + send_input_key(name, False) + send_modifier(mod, False) + + +def get_foreground_process_name(): + """Dateiname des Prozesses, dem das aktive Fenster gehoert (z. B. SquadGame.exe).""" + hwnd = user32.GetForegroundWindow() + if not hwnd: + return "" + pid = wintypes.DWORD() + user32.GetWindowThreadProcessId(hwnd, ctypes.byref(pid)) + if not pid.value: + return "" + handle = kernel32.OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION, False, pid.value) + if not handle: + return "" + try: + size = wintypes.DWORD(1024) + buf = ctypes.create_unicode_buffer(size.value) + if kernel32.QueryFullProcessImageNameW(handle, 0, buf, ctypes.byref(size)): + return os.path.basename(buf.value) + return "" + finally: + kernel32.CloseHandle(handle) + + +# --------------------------------------------------------------------------- +# Erscheinungsbild - gedeckte Militaerfarben, dunkler Untergrund +# --------------------------------------------------------------------------- +BG = "#151814" # Fensterhintergrund, fast schwarz mit Gruenstich +PANEL = "#1e231b" # Flaechen, Eingabefelder +PANEL_HI = "#2a3125" # Hover, ausgewaehlter Reiter +LINE = "#3d4634" # Rahmen und Trennlinien +FG = "#c9cec0" # Standardtext, helles Khaki +FG_DIM = "#7f8874" # Nebentext +OLIVE = "#6e8b3d" # Akzent, Fortschritt +OLIVE_HI = "#8cb04d" # heller Akzent +AMBER = "#d9a441" # Hinweise, Schwellenmarke +AMBER_HELL = "#e8bb63" # Mauskontakt auf der Hinweisleiste +AMBER_DUNKEL = "#2b2416" # Untergrund der Hinweisleiste +RED = "#b4472f" # Sperre, Fehler +GREEN_TX = "#9ed23f" # Sendebereit + +FONT_UI = ("Segoe UI", 9) +FONT_BOLD = ("Segoe UI Semibold", 9) +FONT_TITLE = ("Segoe UI", 17, "bold") +FONT_MONO = ("Consolas", 9) +FONT_STATUS = ("Consolas", 13, "bold") + + +def apply_tactical_theme(root): + """Dunkles, gedecktes Farbschema im Stil der Spieloberflaeche.""" + root.configure(bg=BG) + style = ttk.Style(root) + # "clam" ist das einzige mitgelieferte Thema, das sich durchgaengig + # umfaerben laesst - "vista" ignoriert die meisten Farbangaben. + style.theme_use("clam") + + style.configure(".", background=BG, foreground=FG, font=FONT_UI, + bordercolor=LINE, darkcolor=PANEL, lightcolor=PANEL, + troughcolor=PANEL, focuscolor=OLIVE) + style.configure("TFrame", background=BG) + style.configure("TLabel", background=BG, foreground=FG) + style.configure("Dim.TLabel", foreground=FG_DIM) + style.configure("Mono.TLabel", font=FONT_MONO, foreground=FG) + style.configure("Title.TLabel", font=FONT_TITLE, foreground=FG) + style.configure("Sub.TLabel", foreground=FG_DIM) + + style.configure("TLabelframe", background=BG, bordercolor=LINE, + relief="solid", borderwidth=1) + style.configure("TLabelframe.Label", background=BG, foreground=OLIVE_HI, + font=FONT_BOLD) + + style.configure("TButton", background=PANEL, foreground=FG, + bordercolor=LINE, relief="solid", borderwidth=1, + padding=(12, 6), font=FONT_UI) + style.map("TButton", + background=[("pressed", OLIVE), ("active", PANEL_HI), + ("disabled", PANEL)], + foreground=[("disabled", FG_DIM)], + bordercolor=[("active", OLIVE)]) + + style.configure("Accent.TButton", background=OLIVE, foreground="#12150f", + font=FONT_BOLD, bordercolor=OLIVE_HI) + style.map("Accent.TButton", + background=[("pressed", OLIVE), ("active", OLIVE_HI), + ("disabled", PANEL)], + foreground=[("disabled", FG_DIM)]) + + for widget in ("TCombobox", "TSpinbox", "TEntry"): + style.configure(widget, fieldbackground=PANEL, background=PANEL, + foreground=FG, bordercolor=LINE, arrowcolor=OLIVE_HI, + insertcolor=FG, selectbackground=OLIVE, + selectforeground="#12150f", padding=4) + style.map(widget, + fieldbackground=[("readonly", PANEL), ("disabled", BG)], + foreground=[("disabled", FG_DIM)], + bordercolor=[("focus", OLIVE)]) + # Die aufklappende Liste einer Combobox ist ein klassisches Tk-Widget + # und muss ueber die Optionsdatenbank eingefaerbt werden. + root.option_add("*TCombobox*Listbox.background", PANEL) + root.option_add("*TCombobox*Listbox.foreground", FG) + root.option_add("*TCombobox*Listbox.selectBackground", OLIVE) + root.option_add("*TCombobox*Listbox.selectForeground", "#12150f") + root.option_add("*TCombobox*Listbox.font", FONT_UI) + + style.configure("TCheckbutton", background=BG, foreground=FG, + indicatorcolor=PANEL, indicatorrelief="solid") + style.map("TCheckbutton", + background=[("active", BG)], + indicatorcolor=[("selected", OLIVE_HI), ("active", PANEL_HI)], + foreground=[("disabled", FG_DIM)]) + + style.configure("TNotebook", background=BG, bordercolor=LINE, + tabmargins=(2, 4, 2, 0)) + style.configure("TNotebook.Tab", background="#10120f", foreground=FG_DIM, + bordercolor=LINE, lightcolor="#10120f", + darkcolor="#10120f", padding=(20, 9), font=FONT_BOLD) + style.map("TNotebook.Tab", + background=[("selected", PANEL_HI), ("active", PANEL)], + lightcolor=[("selected", PANEL_HI)], + darkcolor=[("selected", PANEL_HI)], + foreground=[("selected", OLIVE_HI), ("active", FG)], + expand=[("selected", (0, 0, 0, 0))]) + + # Der Schieberegler von clam ist standardmaessig hell und wuerde aus + # dem Schema fallen. + style.configure("Horizontal.TScale", background=BG, troughcolor="#10120f", + bordercolor=LINE, lightcolor=OLIVE, darkcolor=OLIVE) + style.map("Horizontal.TScale", + background=[("active", BG)], + lightcolor=[("active", OLIVE_HI)], + darkcolor=[("active", OLIVE_HI)]) + style.configure("TSeparator", background=LINE) + return style + + +class LevelMeter(tk.Canvas): + """ + Segmentierte Pegelanzeige mit Schwellenmarke. + + Zeigt anders als eine gewoehnliche Fortschrittsleiste, wo die + Ausloeseschwelle relativ zum Pegel liegt - genau die Information, + die man zum Einstellen braucht. + """ + SEGMENTS = 40 + MAXIMUM = 0.10 + + def __init__(self, master, width=320, height=26): + super().__init__(master, width=width, height=height, bg=PANEL, + highlightthickness=1, highlightbackground=LINE, + bd=0) + self._level = 0.0 + self._threshold = 0.025 + self._active = False + self.bind("", lambda e: self._redraw()) + + def update_values(self, level, threshold, active): + self._level, self._threshold, self._active = level, threshold, active + self._redraw() + + def _redraw(self): + self.delete("all") + w = self.winfo_width() or int(self["width"]) + h = self.winfo_height() or int(self["height"]) + pad = 3 + seg_w = (w - 2 * pad) / self.SEGMENTS + filled = int(min(1.0, self._level / self.MAXIMUM) * self.SEGMENTS) + thr_seg = int(min(1.0, self._threshold / self.MAXIMUM) * self.SEGMENTS) + + for i in range(self.SEGMENTS): + x0 = pad + i * seg_w + x1 = x0 + seg_w - 1.5 + if i < filled: + colour = OLIVE_HI if self._active else OLIVE + if i >= thr_seg and not self._active: + colour = OLIVE_HI + else: + colour = "#252b1f" + self.create_rectangle(x0, pad, x1, h - pad, fill=colour, width=0) + + # Schwellenmarke + x = pad + thr_seg * seg_w + self.create_line(x, 0, x, h, fill=AMBER, width=2) + + +def set_dark_titlebar(root): + """ + Faerbt die Fenstertitelleiste dunkel. + + Windows zeichnet die Titelleiste sonst hell, was ueber der dunklen + Oberflaeche wie ein weisser Balken wirkt. Das Attribut heisst auf + aktuellen Windows-Versionen 20, auf aelteren 19. + """ + try: + root.update_idletasks() + hwnd = user32.GetParent(root.winfo_id()) or root.winfo_id() + dwm = ctypes.WinDLL("dwmapi") + an = ctypes.c_int(1) + for attribut in (20, 19): + if dwm.DwmSetWindowAttribute( + wintypes.HWND(hwnd), ctypes.c_uint(attribut), + ctypes.byref(an), ctypes.sizeof(an)) == 0: + # Neu zeichnen erzwingen, sonst bleibt die alte Farbe stehen + root.withdraw() + root.deiconify() + return True + except Exception: + pass + return False + + +def set_window_icon(root): + """ + Setzt das Programmsymbol fuer Fenster und Taskleiste. + + Verwendet icon.ico neben dem Programm. Fehlt sie, bleibt das + Standardsymbol - ein fehlendes Symbol ist kein Grund abzubrechen. + """ + ordner = Path(__file__).resolve().parent + ico = ordner / "icon.ico" + if ico.exists(): + try: + root.iconbitmap(default=str(ico)) + return True + except Exception: + pass + png = ordner / "icon.png" + if png.exists(): + try: + bild = tk.PhotoImage(file=str(png)) + root.iconphoto(True, bild) + root._icon_ref = bild # Verweis halten, sonst weggeraeumt + return True + except Exception: + pass + return False + + +def clean_device_name(name): + """ + Macht Windows-Geraetenamen lesbar. + + Manche Treiber liefern einen unaufgeloesten Ressourcenverweis wie + "@System32\\drivers\\bthhfenum.sys,#4;%1 Hands-Free HF Audio%0 ;(iPhone)". + Daraus wird "Hands-Free HF Audio (iPhone)". + """ + name = name.replace("\r", " ").replace("\n", " ") + if name.lstrip().startswith("@") or ".sys," in name or ".dll," in name: + pieces = [] + for piece in name.split(";")[1:]: + piece = piece.strip() + if piece.startswith("%1"): + piece = piece[2:].strip() + if piece.endswith("%0"): + piece = piece[:-2].strip() + piece = piece.strip(" ()") + if piece: + pieces.append(piece) + if pieces: + name = f"{pieces[0]} ({', '.join(pieces[1:])})" if len(pieces) > 1 else pieces[0] + return " ".join(name.split()) + + +API_RANG = {"WASAPI": 0, "DirectSound": 1, "MME": 2, "WDM-KS": 3} + +# Platzhalter fuer "Windows-Standardgeraet" - kein echtes Mikrofon +ALIAS_GERAETE = ("microsoft soundmapper", "primärer soundaufnahmetreiber", + "primarer soundaufnahmetreiber", "primary sound capture") + + +def _vergleichsname(name): + return "".join(z for z in name.lower() if z.isalnum()) + + +def gleiches_geraet(a, b): + """ + Zwei Eintraege gehoeren zum selben Mikrofon. + + Die MME-Schnittstelle kuerzt Geraetenamen auf 31 Zeichen, deshalb wird + geprueft, ob der kuerzere Name Anfang des laengeren ist. + """ + x, y = _vergleichsname(a), _vergleichsname(b) + if x == y: + return True + kurz, lang = (x, y) if len(x) <= len(y) else (y, x) + return len(kurz) >= 8 and lang.startswith(kurz) + + +def zusammenfassen(geraete): + """Pro Mikrofon nur den Eintrag mit der besten Schnittstelle behalten.""" + gruppen = [] + for geraet in sorted(geraete, key=lambda g: len(_vergleichsname(g["name"]))): + for gruppe in gruppen: + if gleiches_geraet(gruppe[0]["name"], geraet["name"]): + gruppe.append(geraet) + break + else: + gruppen.append([geraet]) + return [min(g, key=lambda d: API_RANG.get(d["api"], 9)) for g in gruppen] + + +def enumerate_inputs(rescan=False, alle=False): + """ + Alle Eingabegeraete mit Host-API und nativer Abtastrate. + + Die Geraeteindizes von PortAudio sind nicht stabil - sie verschieben + sich, sobald ein Treiber dazukommt oder verschwindet. Deshalb wird + ueberall mit dem Label gearbeitet und der Index erst unmittelbar vor + dem Oeffnen aufgeloest. + """ + if rescan: + try: + sd._terminate() + sd._initialize() + except Exception: + pass + apis = sd.query_hostapis() + result = [] + for index, dev in enumerate(sd.query_devices()): + if dev["max_input_channels"] < 1: + continue + api = apis[dev["hostapi"]]["name"].replace("Windows ", "") + name = clean_device_name(dev["name"]) + result.append({ + "index": index, + "name": name, + "api": api, + "samplerate": int(dev["default_samplerate"]), + "label": f"[{api}] {name}", + }) + + if alle: + return result + + gefiltert = [d for d in result + if not any(a in d["name"].lower() for a in ALIAS_GERAETE)] + + # WDM-KS ist der Kernel-Zugang. Dort taucht zusaetzlich zu jedem echten + # Mikrofon ein Eintrag unter abweichendem Treibernamen auf, dazu Geraete, + # die in Windows gar nicht aktiv sind. Sobald WASAPI etwas liefert, ist + # das die massgebliche Liste - sie entspricht den Windows-Soundeinstellungen. + ohne_kernel = [d for d in gefiltert if d["api"] != "WDM-KS"] + if any(d["api"] == "WASAPI" for d in ohne_kernel): + gefiltert = ohne_kernel + + return zusammenfassen(gefiltert or result) + + +def pick_samplerate(index, preferred): + """Erste Abtastrate, die das Geraet tatsaechlich akzeptiert.""" + seen = [] + for rate in (preferred, 48000, 44100, 16000): + if rate in seen: + continue + seen.append(rate) + try: + sd.check_input_settings(device=index, channels=1, + samplerate=rate, dtype="float32") + return rate + except Exception: + continue + return None + + +def audio_service_running(): + """ + Laeuft der Windows-Audiodienst? Stuerzt er ab, scheitert jede Aufnahme. + Nur lesender Zugriff auf den Dienststatus. + """ + SC_MANAGER_CONNECT, SERVICE_QUERY_STATUS, SERVICE_RUNNING = 0x0001, 0x0004, 0x0004 + advapi = ctypes.WinDLL("advapi32", use_last_error=True) + + class SERVICE_STATUS(ctypes.Structure): + _fields_ = [("dwServiceType", wintypes.DWORD), + ("dwCurrentState", wintypes.DWORD), + ("dwControlsAccepted", wintypes.DWORD), + ("dwWin32ExitCode", wintypes.DWORD), + ("dwServiceSpecificExitCode", wintypes.DWORD), + ("dwCheckPoint", wintypes.DWORD), + ("dwWaitHint", wintypes.DWORD)] + + manager = advapi.OpenSCManagerW(None, None, SC_MANAGER_CONNECT) + if not manager: + return True # Status nicht ermittelbar - nicht faelschlich warnen + try: + service = advapi.OpenServiceW(manager, "Audiosrv", SERVICE_QUERY_STATUS) + if not service: + return True + try: + status = SERVICE_STATUS() + if not advapi.QueryServiceStatus(service, ctypes.byref(status)): + return True + return status.dwCurrentState == SERVICE_RUNNING + finally: + advapi.CloseServiceHandle(service) + finally: + advapi.CloseServiceHandle(manager) + + +def beep(enabled): + """Kurze Rueckmeldung zum Hotkey - im Vollbild ist das Fenster nicht sichtbar.""" + def run(): + try: + import winsound + winsound.Beep(880 if enabled else 440, 90) + except Exception: + pass + threading.Thread(target=run, daemon=True).start() + + +def cursor_is_visible(): + """ + True, wenn Windows gerade einen Mauszeiger zeichnet. + + Squad blendet den Zeiger im Spiel aus und im Deploy-/Menuebildschirm ein. + Damit laesst sich der Respawn-Screen erkennen, ohne das Spiel anzufassen. + """ + info = CURSORINFO() + info.cbSize = ctypes.sizeof(CURSORINFO) + if not user32.GetCursorInfo(ctypes.byref(info)): + return True + return bool(info.flags & CURSOR_SHOWING) + + +# --------------------------------------------------------------------------- +# Anwendung +# --------------------------------------------------------------------------- +class VoiceActivationApp: + POLL_SECONDS = 0.02 + + def __init__(self, root): + self.root = root + self.root.title(f"{APP_NAME} {VERSION}") + self.root.geometry("700x780") + self.root.minsize(660, 480) + set_window_icon(self.root) + set_dark_titlebar(self.root) + + self.audio_queue = queue.Queue(maxsize=10) + self.running = False + self.stream = None + self.ptt_down = False + self.active_binding = None + self.last_voice_time = 0.0 + self.current_level = 0.0 + self.hold_reason = "" + self.hotkey_was_down = False + + self.device_var = tk.StringVar() + self.threshold_var = tk.DoubleVar(value=0.025) + self.release_ms_var = tk.IntVar(value=450) + self.ptt_key_var = tk.StringVar(value="V") + self.ptt_mod_var = tk.StringVar(value=NO_MOD_LABEL) + self.radio1_var = tk.StringVar(value="B") + self.radio1_mod_var = tk.StringVar(value=NO_MOD_LABEL) + self.radio2_var = tk.StringVar(value="G") + self.radio2_mod_var = tk.StringVar(value=NO_MOD_LABEL) + self.radio3_var = tk.StringVar(value=NONE_LABEL) + self.radio3_mod_var = tk.StringVar(value=NO_MOD_LABEL) + self.hotkey_var = tk.StringVar(value="Pause") + self.squad_process_var = tk.StringVar(value=SQUAD_PROCESS_DEFAULT) + self.squad_only_var = tk.BooleanVar(value=True) + self.pause_on_cursor_var = tk.BooleanVar(value=False) + self.beep_var = tk.BooleanVar(value=True) + self.alle_geraete_var = tk.BooleanVar(value=False) + self.enabled_var = tk.BooleanVar(value=True) + self.status_var = tk.StringVar(value="Gestoppt") + self.detail_var = tk.StringVar(value="") + self.device_info_var = tk.StringVar(value="") + self.diag_var = tk.StringVar(value="") + self.inputs = [] + self.worker = None + self.update_angaben = None + + self.build_ui() + self.refresh_devices() + self.load_config() + self.arm_autosave() + self.root.protocol("WM_DELETE_WINDOW", self.on_close) + self.root.report_callback_exception = self.on_tk_error + self.root.after(80, self.ui_tick) + self.root.after(1500, self.suche_update) + + def on_tk_error(self, exc_type, exc, tb): + """Fehler aus Tk-Callbacks sichtbar machen statt still verschlucken.""" + log_exception(exc_type, exc, tb) + try: + messagebox.showerror( + APP_NAME, + f"Unerwarteter Fehler:\n\n{exc_type.__name__}: {exc}\n\n" + f"Einzelheiten stehen in:\n{LOG_PATH}") + except Exception: + pass + + # -- UI ----------------------------------------------------------------- + def build_ui(self): + header = ttk.Frame(self.root) + header.pack(fill="x", padx=18, pady=(16, 4)) + ttk.Label(header, text="SQUAD VOICE ACTIVATION", + style="Title.TLabel").pack(anchor="w") + ttk.Label(header, style="Sub.TLabel", + text="Haelt die Sprechtaste, solange du redest.").pack(anchor="w") + ttk.Separator(self.root, orient="horizontal").pack( + fill="x", padx=18, pady=(10, 0)) + + # Die Leiste mit Starten/Stoppen wird VOR dem Notebook gepackt und am + # unteren Rand verankert. Sonst frisst das Notebook (expand=True) den + # Platz und die Knoepfe fallen aus dem Fenster. + self._build_statusbar() + self._build_update_banner() + + nb = ttk.Notebook(self.root) + self.nb = nb + nb.pack(fill="both", expand=True, padx=16, pady=8) + tab_main = ttk.Frame(nb) + tab_keys = ttk.Frame(nb) + nb.add(tab_main, text=" Mikrofon ") + nb.add(tab_keys, text=" Tasten und Verhalten ") + + self._build_main_tab(tab_main) + self._build_keys_tab(tab_keys) + + def _build_main_tab(self, parent): + f = ttk.Frame(parent) + f.pack(fill="both", expand=True, padx=12, pady=12) + f.columnconfigure(1, weight=1) + + ttk.Label(f, text="Mikrofon").grid(row=0, column=0, sticky="w", pady=8) + self.device_combo = ttk.Combobox(f, textvariable=self.device_var, + state="readonly", width=44) + self.device_combo.grid(row=0, column=1, sticky="ew", padx=8, pady=8) + ttk.Button(f, text="Neu laden", + command=lambda: self.refresh_devices(rescan=True)).grid( + row=0, column=2, pady=8) + + ttk.Checkbutton( + f, variable=self.alle_geraete_var, + text="Jede Windows-Schnittstelle einzeln auflisten", + command=lambda: self.refresh_devices(rescan=False), + ).grid(row=1, column=1, sticky="w", padx=8, pady=(0, 6)) + + ttk.Label(f, text="Schwelle").grid(row=2, column=0, sticky="w", pady=8) + ttk.Scale(f, from_=0.002, to=0.100, variable=self.threshold_var, + orient="horizontal").grid(row=2, column=1, sticky="ew", padx=8, pady=8) + self.threshold_label = ttk.Label(f, text="0.025", width=8) + self.threshold_label.grid(row=2, column=2, sticky="w", pady=8) + + ttk.Label(f, text="Pegel").grid(row=3, column=0, sticky="w", pady=8) + self.level_bar = LevelMeter(f) + self.level_bar.grid(row=3, column=1, sticky="ew", padx=8, pady=8) + self.level_label = ttk.Label(f, text="0.000", width=8, style="Mono.TLabel") + self.level_label.grid(row=3, column=2, sticky="w", pady=8) + + ttk.Label(f, text="Nachlaufzeit").grid(row=4, column=0, sticky="w", pady=8) + row3 = ttk.Frame(f) + row3.grid(row=4, column=1, sticky="w", padx=8, pady=8) + ttk.Spinbox(row3, from_=100, to=2000, increment=50, + textvariable=self.release_ms_var, width=8).pack(side="left") + ttk.Label(row3, text="ms nach dem letzten Wort").pack(side="left", padx=8) + + diag = ttk.LabelFrame(f, text="Warum sendet es (nicht)?") + diag.grid(row=5, column=0, columnspan=3, sticky="ew", pady=(16, 8)) + ttk.Label(diag, textvariable=self.diag_var, justify="left", + font=("Consolas", 9)).pack(anchor="w", padx=10, pady=8) + ttk.Label(diag, textvariable=self.device_info_var, + foreground="#666").pack(anchor="w", padx=10, pady=(0, 8)) + + box = ttk.LabelFrame(f, text="Eingabetest") + box.grid(row=6, column=0, columnspan=3, sticky="ew", pady=(8, 8)) + ttk.Button(box, text="PTT-Taste testen (1 Sekunde halten)", + command=self.test_ptt).pack(side="left", padx=10, pady=10) + self.test_result = ttk.Label(box, text="Vor dem Start von Squad ausprobieren.") + self.test_result.pack(side="left", padx=10, pady=10) + + ttk.Label(f, justify="left", text=( + "Notepad oeffnen, hineinklicken, zurueck zu diesem Fenster wechseln\n" + "und den Test starten. Erscheint die Taste in Notepad, funktioniert\n" + "die Eingabesimulation. Laeuft Squad als Administrator, muss auch\n" + "dieses Programm als Administrator laufen.") + ).grid(row=7, column=0, columnspan=3, sticky="w", pady=(4, 0)) + + def _build_keys_tab(self, parent): + f = ttk.Frame(parent) + f.pack(fill="both", expand=True, padx=12, pady=12) + f.columnconfigure(2, weight=1) + + ttk.Label(f, text="Sprechtaste (wird automatisch gehalten)").grid( + row=0, column=0, sticky="w", pady=8) + ptt_row = ttk.Frame(f) + ptt_row.grid(row=0, column=1, columnspan=2, sticky="w", padx=8, pady=8) + ttk.Combobox(ptt_row, textvariable=self.ptt_mod_var, values=MOD_NAMES, + state="readonly", width=8).pack(side="left") + ttk.Label(ptt_row, text="+").pack(side="left", padx=6) + ttk.Combobox(ptt_row, textvariable=self.ptt_key_var, values=KEY_NAMES, + state="readonly", width=12).pack(side="left") + ttk.Label(ptt_row, text=" z. B. Local V oder Fireteam-Kanal", + foreground="#666").pack(side="left", padx=6) + + box = ttk.LabelFrame( + f, text="Andere Sprechtasten - Automatik pausiert, solange eine gehalten wird") + box.grid(row=1, column=0, columnspan=3, sticky="ew", pady=(16, 8)) + for i, (label, mod_var, key_var, hint) in enumerate([ + ("Squad Radio", self.radio1_mod_var, self.radio1_var, "meist B"), + ("Command Radio", self.radio2_mod_var, self.radio2_var, "meist G"), + ("Weitere Taste", self.radio3_mod_var, self.radio3_var, "optional"), + ]): + ttk.Label(box, text=label).grid(row=i, column=0, sticky="w", padx=10, pady=6) + ttk.Combobox(box, textvariable=mod_var, values=MOD_NAMES, + state="readonly", width=8).grid(row=i, column=1, padx=(10, 2), pady=6) + ttk.Label(box, text="+").grid(row=i, column=2) + ttk.Combobox(box, textvariable=key_var, values=[NONE_LABEL] + KEY_NAMES, + state="readonly", width=12).grid(row=i, column=3, padx=(2, 10), pady=6) + ttk.Label(box, text=hint, foreground="#666").grid(row=i, column=4, + sticky="w", padx=6) + + ttk.Label(f, justify="left", text=( + "Drueckst du selbst eine dieser Tasten, laesst das Programm die\n" + "Local-Taste sofort los und haelt sich raus, bis du sie wieder\n" + "loslaesst. Dein Funkspruch wird dadurch nicht mehr ueberschrieben.") + ).grid(row=2, column=0, columnspan=3, sticky="w", pady=(0, 12)) + + box2 = ttk.LabelFrame(f, text="Verhalten") + box2.grid(row=3, column=0, columnspan=3, sticky="ew", pady=8) + + ttk.Checkbutton( + box2, variable=self.squad_only_var, + text="Alles nur aktiv, solange dieses Programm im Vordergrund ist:", + ).pack(anchor="w", padx=10, pady=(8, 2)) + + proc_row = ttk.Frame(box2) + proc_row.pack(anchor="w", padx=32, pady=(0, 4)) + ttk.Entry(proc_row, textvariable=self.squad_process_var, width=22).pack(side="left") + self.proc_hint = ttk.Label(proc_row, foreground="#666", text="") + self.proc_hint.pack(side="left", padx=10) + + ttk.Checkbutton( + box2, variable=self.pause_on_cursor_var, + text="Pausieren, solange ein Mauszeiger sichtbar ist (Deploy-Screen, Menue, Karte)", + ).pack(anchor="w", padx=10, pady=4) + + self.cursor_hint = ttk.Label(box2, foreground="#666", text="") + self.cursor_hint.pack(anchor="w", padx=32, pady=(0, 8)) + + row = ttk.Frame(box2) + row.pack(anchor="w", padx=10, pady=(4, 2)) + ttk.Label(row, text="Stummschalt-Hotkey (nur im Spiel)").pack(side="left") + ttk.Combobox(row, textvariable=self.hotkey_var, values=[NONE_LABEL] + KEY_NAMES, + state="readonly", width=14).pack(side="left", padx=10) + + ttk.Checkbutton( + box2, variable=self.beep_var, + text="Signalton beim Umschalten (hoch = aktiv, tief = stumm)", + ).pack(anchor="w", padx=32, pady=(0, 10)) + + ttk.Label(f, text="Alle Aenderungen werden sofort gespeichert.", + style="Dim.TLabel").grid(row=4, column=0, columnspan=2, + sticky="w", pady=(16, 0)) + self.save_hint = ttk.Label(f, style="Dim.TLabel", text="") + self.save_hint.grid(row=5, column=0, columnspan=3, sticky="w", pady=(2, 0)) + + def _build_update_banner(self): + """Hinweisleiste auf eine neue Fassung. Bleibt verborgen, bis es eine gibt.""" + self.update_banner = tk.Frame(self.root, bg=AMBER_DUNKEL, + highlightthickness=1, + highlightbackground=AMBER) + innen = tk.Frame(self.update_banner, bg=AMBER_DUNKEL) + innen.pack(fill="x", padx=14, pady=9) + + self.update_text_var = tk.StringVar(value="") + tk.Label(innen, textvariable=self.update_text_var, bg=AMBER_DUNKEL, + fg=AMBER, font=FONT_BOLD, anchor="w", + justify="left").pack(side="left", fill="x", expand=True) + + tk.Button(innen, text="Später", command=self.update_verbergen, + bg=AMBER_DUNKEL, fg=FG_DIM, activebackground=PANEL_HI, + activeforeground=FG, relief="flat", bd=0, padx=12, pady=4, + font=FONT_UI, cursor="hand2").pack(side="right", padx=(8, 0)) + + self.update_btn = tk.Button( + innen, text="Jetzt aktualisieren", command=self.update_starten, + bg=AMBER, fg="#1a1508", activebackground=AMBER_HELL, + activeforeground="#1a1508", relief="flat", bd=0, padx=16, pady=4, + font=FONT_BOLD, cursor="hand2") + self.update_btn.pack(side="right") + + def _build_statusbar(self): + self.status_trenner = ttk.Separator(self.root, orient="horizontal") + self.status_trenner.pack(side="bottom", fill="x", padx=0, pady=(0, 0)) + bar = ttk.Frame(self.root) + bar.pack(side="bottom", fill="x", padx=16, pady=12) + + self.start_btn = ttk.Button(bar, text="STARTEN", style="Accent.TButton", + command=self.start) + self.start_btn.pack(side="left") + self.stop_btn = ttk.Button(bar, text="STOPPEN", command=self.stop, + state="disabled") + self.stop_btn.pack(side="left", padx=8) + + right = ttk.Frame(bar) + right.pack(side="right") + ttk.Label(right, textvariable=self.detail_var, + style="Dim.TLabel").pack(side="left", padx=10) + self.status_label = ttk.Label(right, textvariable=self.status_var, + font=FONT_STATUS, foreground=FG_DIM) + self.status_label.pack(side="left") + + # -- Konfiguration ------------------------------------------------------ + def config_dict(self): + return { + "device": self.device_var.get(), + "threshold": round(float(self.threshold_var.get()), 4), + "release_ms": int(self.release_ms_var.get()), + "ptt_key": self.ptt_key_var.get(), + "ptt_mod": self.ptt_mod_var.get(), + "radio_keys": [self.radio1_var.get(), self.radio2_var.get(), + self.radio3_var.get()], + "radio_mods": [self.radio1_mod_var.get(), self.radio2_mod_var.get(), + self.radio3_mod_var.get()], + "hotkey": self.hotkey_var.get(), + "squad_process": self.squad_process_var.get(), + "squad_only": bool(self.squad_only_var.get()), + "pause_on_cursor": bool(self.pause_on_cursor_var.get()), + "beep": bool(self.beep_var.get()), + } + + def suche_update(self): + """Fragt im Hintergrund nach einer neueren Fassung.""" + def arbeit(): + angaben = pruefe_update() + if angaben: + self.root.after(0, lambda: self.update_anbieten(angaben)) + threading.Thread(target=arbeit, daemon=True).start() + + def update_anbieten(self, angaben): + self.update_angaben = angaben + text = f"Version {angaben['version']} ist verfügbar." + if angaben.get("hinweis"): + text += f" {angaben['hinweis']}" + self.update_text_var.set(text) + self.update_banner.pack(side="bottom", fill="x", padx=0, pady=0, + before=self.status_trenner) + + def update_verbergen(self): + self.update_banner.pack_forget() + + def update_starten(self): + if not getattr(self, "update_angaben", None): + return + self.update_btn.config(state="disabled", text="Lädt ...") + + def arbeit(): + import tempfile + try: + ziel = Path(tempfile.gettempdir()) / "SquadVoiceActivation_Update.zip" + + def melden(geladen, gesamt): + anteil = int(geladen * 100 / gesamt) + self.root.after(0, lambda: self.update_btn.config( + text=f"Lädt ... {anteil} %")) + + lade_update(self.update_angaben, ziel, melden) + ordner = Path(__file__).resolve().parent + self.root.after(0, lambda: self.update_abschliessen(ziel, ordner)) + except Exception as fehler: + log_exception(type(fehler), fehler, fehler.__traceback__) + self.root.after(0, lambda f=fehler: self.update_fehler(f)) + + threading.Thread(target=arbeit, daemon=True).start() + + def update_fehler(self, fehler): + self.update_btn.config(state="normal", text="Jetzt aktualisieren") + messagebox.showerror( + APP_NAME, + f"Das Update konnte nicht geladen werden:\n\n{fehler}\n\n" + "Das Programm läuft unverändert weiter.") + + def update_abschliessen(self, zip_pfad, ordner): + self.update_btn.config(text="Wird eingespielt ...") + try: + spiele_update_ein(zip_pfad, ordner) + except Exception as fehler: + log_exception(type(fehler), fehler, fehler.__traceback__) + self.update_fehler(fehler) + return + self.stop() + self.root.after(400, self.root.destroy) + + def arm_autosave(self): + """ + Jede Aenderung wird gespeichert, nicht erst beim Schliessen. + + Wird das Programm abgeschossen oder faellt der Rechner aus, waeren + sonst alle Einstellungen der Sitzung verloren. Geschrieben wird + verzoegert, damit das Ziehen am Schieberegler nicht hunderte + Schreibvorgaenge ausloest. + """ + for var in (self.device_var, self.threshold_var, self.release_ms_var, + self.ptt_key_var, self.ptt_mod_var, + self.radio1_var, self.radio1_mod_var, + self.radio2_var, self.radio2_mod_var, + self.radio3_var, self.radio3_mod_var, + self.hotkey_var, self.squad_process_var, + self.squad_only_var, self.pause_on_cursor_var, + self.beep_var): + var.trace_add("write", self._on_setting_changed) + self._autosave_job = None + + def _on_setting_changed(self, *_): + if getattr(self, "_autosave_job", None) is not None: + try: + self.root.after_cancel(self._autosave_job) + except Exception: + pass + self._autosave_job = self.root.after(600, self._autosave_now) + + def _autosave_now(self): + self._autosave_job = None + self.save_config(quiet=True) + + def save_config(self, quiet=False): + try: + CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True) + CONFIG_PATH.write_text(json.dumps(self.config_dict(), indent=2), + encoding="utf-8") + self.save_hint.config( + text=f"Automatisch gespeichert {time.strftime('%H:%M:%S')}") + except Exception as e: + log_exception(type(e), e, e.__traceback__) + if not quiet: + messagebox.showerror( + APP_NAME, f"Einstellungen konnten nicht gespeichert werden:\n{e}") + else: + self.save_hint.config(text="Speichern fehlgeschlagen - siehe error.log") + + def load_config(self): + if not CONFIG_PATH.exists(): + return + try: + cfg = json.loads(CONFIG_PATH.read_text(encoding="utf-8")) + except Exception: + return + + # Toleranter Vergleich: Geraetenamen enthalten oft ueberzaehlige + # Leerzeichen, und die Namensbereinigung kann sie veraendert haben. + saved = " ".join((cfg.get("device") or "").split()) + if saved: + match = next((label for label in self.device_combo["values"] + if " ".join(label.split()) == saved), None) + if match: + self.device_var.set(match) + + try: + self.threshold_var.set(float(cfg.get("threshold", 0.025))) + self.release_ms_var.set(int(cfg.get("release_ms", 450))) + except Exception: + pass + self.squad_only_var.set(bool(cfg.get("squad_only", True))) + self.pause_on_cursor_var.set(bool(cfg.get("pause_on_cursor", False))) + self.beep_var.set(bool(cfg.get("beep", True))) + + if cfg.get("ptt_key") in KEYS: + self.ptt_key_var.set(cfg["ptt_key"]) + if cfg.get("ptt_mod") in MODIFIERS: + self.ptt_mod_var.set(cfg["ptt_mod"]) + if cfg.get("hotkey") in KEYS or cfg.get("hotkey") == NONE_LABEL: + self.hotkey_var.set(cfg["hotkey"]) + if cfg.get("squad_process"): + self.squad_process_var.set(cfg["squad_process"]) + + for var, value in zip((self.radio1_var, self.radio2_var, self.radio3_var), + cfg.get("radio_keys") or []): + if value in KEYS or value == NONE_LABEL: + var.set(value) + for var, value in zip((self.radio1_mod_var, self.radio2_mod_var, + self.radio3_mod_var), cfg.get("radio_mods") or []): + if value in MODIFIERS: + var.set(value) + + self.save_hint.config(text="Einstellungen geladen.") + + # -- Audio -------------------------------------------------------------- + def refresh_devices(self, rescan=False): + try: + self.inputs = enumerate_inputs(rescan=rescan, + alle=bool(self.alle_geraete_var.get())) + except Exception as e: + messagebox.showerror(APP_NAME, f"Mikrofone konnten nicht gelesen werden:\n{e}") + return + + labels = [d["label"] for d in self.inputs] + self.device_combo["values"] = labels + + if self.device_var.get() not in labels: + # WASAPI zuerst - moderner und stabiler als MME/DirectSound + preferred = next((d["label"] for d in self.inputs if d["api"] == "WASAPI"), + labels[0] if labels else "") + self.device_var.set(preferred) + + def selected_device(self): + """Loest das gewaehlte Label frisch auf, weil Indizes wandern koennen.""" + label = self.device_var.get() + if not label: + return None + for device in enumerate_inputs(): + if device["label"] == label: + return device + return None + + def audio_callback(self, indata, frames, time_info, status): + rms = float(np.sqrt(np.mean(np.square(indata.astype(np.float32))))) + self.current_level = rms + try: + self.audio_queue.put_nowait(rms) + except queue.Full: + try: + self.audio_queue.get_nowait() + self.audio_queue.put_nowait(rms) + except Exception: + pass + + # -- PTT ---------------------------------------------------------------- + def test_ptt(self): + if self.ptt_down: + return + key = self.ptt_key_var.get() + mod = self.ptt_mod_var.get() + if key not in KEYS: + messagebox.showwarning(APP_NAME, "Bitte eine gueltige Taste waehlen.") + return + + label = key if MODIFIERS.get(mod) is None else f"{mod}+{key}" + self.test_result.config(text=f"Teste {label} ...") + + def do_test(): + try: + send_binding(mod, key, True) + time.sleep(1.0) + send_binding(mod, key, False) + self.root.after(0, lambda: self.test_result.config( + text=f"{label} wurde erfolgreich gesendet.")) + except Exception as e: + self.root.after(0, lambda: messagebox.showerror( + APP_NAME, f"Test fehlgeschlagen:\n{e}")) + self.root.after(0, lambda: self.test_result.config( + text="Test fehlgeschlagen.")) + + threading.Thread(target=do_test, daemon=True).start() + + def press_ptt(self): + if self.ptt_down: + return + key = self.ptt_key_var.get() + if key not in KEYS: + return + # Kombination merken, damit ein spaeteres Umstellen im UI die + # gehaltene Taste nicht haengen laesst. + self.active_binding = (self.ptt_mod_var.get(), key) + send_binding(*self.active_binding, True) + self.ptt_down = True + + def release_ptt(self): + if not self.ptt_down: + return + try: + if self.active_binding: + send_binding(*self.active_binding, False) + finally: + self.active_binding = None + self.ptt_down = False + + # -- Sperrgruende ------------------------------------------------------- + def radio_bindings(self): + pairs = ((self.radio1_mod_var, self.radio1_var), + (self.radio2_mod_var, self.radio2_var), + (self.radio3_mod_var, self.radio3_var)) + return [(m.get(), k.get()) for m, k in pairs if k.get() in KEYS] + + def squad_focused(self): + """Ist das Spiel gerade das aktive Fenster?""" + if not self.squad_only_var.get(): + return True + wanted = self.squad_process_var.get().strip().lower() + if not wanted: + return True + return get_foreground_process_name().lower().startswith(wanted) + + def blocking_reason(self): + """Grund, warum gerade nicht gesendet werden darf. Leerer String = frei.""" + if not self.squad_focused(): + return "Squad nicht im Vordergrund" + + if not self.enabled_var.get(): + return "Pausiert (Hotkey)" + + for mod, key in self.radio_bindings(): + if is_binding_down(mod, key): + label = key if MODIFIERS.get(mod) is None else f"{mod}+{key}" + return f"Funk aktiv ({label})" + + # Haelt der Spieler die Local-Taste selbst, mischen wir uns nicht ein. + if not self.ptt_down and is_binding_down(self.ptt_mod_var.get(), + self.ptt_key_var.get()): + return "Manuell gedrueckt" + + if self.pause_on_cursor_var.get() and cursor_is_visible(): + return "Menue / Deploy-Screen" + + return "" + + def poll_hotkey(self): + """ + Flankenerkennung fuer den Stummschalt-Hotkey. + + Wird nur ausgewertet, solange das Spiel im Vordergrund ist. Sonst + wuerde dieselbe Taste auch beim Schreiben im Browser oder in Discord + die Automatik umschalten. + """ + key = self.hotkey_var.get() + if key not in KEYS or not self.squad_focused(): + self.hotkey_was_down = False + return + down = is_physically_down(key) + if down and not self.hotkey_was_down: + now_enabled = not self.enabled_var.get() + self.enabled_var.set(now_enabled) + if not now_enabled: + self.release_ptt() + if self.beep_var.get(): + beep(now_enabled) + self.hotkey_was_down = down + + # -- Steuerung ---------------------------------------------------------- + def start(self): + if self.running: + return + + if not audio_service_running(): + messagebox.showerror( + APP_NAME, + "Der Windows-Audiodienst laeuft nicht.\n\n" + "Ohne ihn kann kein Programm aufnehmen. In einer\n" + "Eingabeaufforderung als Administrator starten:\n\n" + " net start Audiosrv") + return + + device = self.selected_device() + if device is None: + messagebox.showwarning( + APP_NAME, + "Das gewaehlte Mikrofon ist nicht mehr vorhanden.\n" + "Bitte auf 'Neu laden' klicken und erneut waehlen.") + return + + rate = pick_samplerate(device["index"], device["samplerate"]) + if rate is None: + messagebox.showerror( + APP_NAME, + f"{device['name']} akzeptiert keine der ueblichen Abtastraten.\n" + "Bitte ein anderes Geraet waehlen - moeglichst eines mit [WASAPI].") + return + + try: + self.audio_queue = queue.Queue(maxsize=10) + self.running = True + self.enabled_var.set(True) + self.last_voice_time = 0.0 + + self.stream = sd.InputStream( + device=device["index"], channels=1, samplerate=rate, + blocksize=max(64, rate // 50), # rund 20 ms + dtype="float32", callback=self.audio_callback, + ) + self.stream.start() + self.worker = threading.Thread(target=self.worker_loop, daemon=True) + self.worker.start() + + self.start_btn.config(state="disabled") + self.stop_btn.config(state="normal") + self.device_combo.config(state="disabled") + self.device_info_var.set(f"{device['api']} @ {rate} Hz") + except Exception as e: + self.running = False + self.stream = None + log_exception(type(e), e, e.__traceback__) + messagebox.showerror( + APP_NAME, + f"Mikrofon konnte nicht geoeffnet werden:\n\n{e}\n\n" + "Haeufige Ursachen:\n" + "- Windows-Audiodienst abgestuerzt (net start Audiosrv)\n" + "- Geraet von einem anderen Programm exklusiv belegt\n" + "- Virtueller Treiber (z. B. SteelSeries Sonar) haengt\n\n" + "Ein Geraet mit [WASAPI] ist meist am stabilsten.") + + def stop(self): + self.running = False + + # Erst den Worker auslaufen lassen, sonst greift er noch auf den + # Stream zu, waehrend dieser geschlossen wird - das kann PortAudio + # hart abstuerzen lassen. + worker, self.worker = self.worker, None + if worker is not None and worker.is_alive(): + worker.join(timeout=1.0) + + try: + self.release_ptt() + except Exception as e: + log_exception(type(e), e, e.__traceback__) + self.ptt_down = False + self.active_binding = None + + stream, self.stream = self.stream, None + if stream is not None: + try: + stream.abort(ignore_errors=True) + except Exception: + pass + try: + stream.close(ignore_errors=True) + except Exception as e: + log_exception(type(e), e, e.__traceback__) + self.current_level = 0.0 + self.hold_reason = "" + self.start_btn.config(state="normal") + self.stop_btn.config(state="disabled") + self.device_combo.config(state="readonly") + + def worker_loop(self): + while self.running: + try: + rms = self.audio_queue.get(timeout=self.POLL_SECONDS) + except queue.Empty: + rms = 0.0 + + now = time.monotonic() + try: + threshold = float(self.threshold_var.get()) + release_delay = max(0.05, int(self.release_ms_var.get()) / 1000.0) + except Exception: + threshold, release_delay = 0.025, 0.45 + + try: + self.poll_hotkey() + reason = self.blocking_reason() + self.hold_reason = reason + + if reason: + self.release_ptt() + elif rms >= threshold: + self.last_voice_time = now + self.press_ptt() + elif self.ptt_down and now - self.last_voice_time >= release_delay: + self.release_ptt() + except Exception as e: + self.running = False + self.root.after(0, lambda err=e: messagebox.showerror( + APP_NAME, + f"Tastatureingabe fehlgeschlagen:\n{err}\n\n" + "Zuerst den PTT-Test ausserhalb von Squad probieren.\n" + "Laeuft Squad als Administrator, muss auch dieses " + "Programm als Administrator laufen.")) + break + + try: + self.release_ptt() + except Exception: + pass + + # -- Anzeige ------------------------------------------------------------ + def ui_tick(self): + try: + val = float(self.current_level) + self.level_bar.update_values(val, float(self.threshold_var.get()), + self.ptt_down) + self.level_label.config(text=f"{val:.3f}") + self.threshold_label.config(text=f"{self.threshold_var.get():.3f}") + + self.cursor_hint.config( + text="Mauszeiger gerade sichtbar" if cursor_is_visible() + else "Mauszeiger gerade ausgeblendet") + self.proc_hint.config( + text=f"gerade im Vordergrund: {get_foreground_process_name() or '?'}") + + threshold = float(self.threshold_var.get()) + if not self.running: + self.status_var.set("● BEREITSCHAFT") + self.status_label.config(foreground=FG_DIM) + self.detail_var.set("") + self.diag_var.set("Nicht gestartet - unten auf STARTEN klicken.") + else: + laut = "ueber Schwelle" if val >= threshold else "ZU LEISE" + zeilen = [f"Pegel {val:.4f} / Schwelle {threshold:.4f} -> {laut}"] + if self.ptt_down: + self.status_var.set("● SENDET") + self.status_label.config(foreground=GREEN_TX) + self.detail_var.set("") + zeilen.append("Taste wird gehalten.") + elif self.hold_reason: + self.status_var.set("● GESPERRT") + self.status_label.config(foreground=RED) + self.detail_var.set(self.hold_reason) + zeilen.append(f"Blockiert: {self.hold_reason}") + if self.hold_reason == "Squad nicht im Vordergrund": + zeilen.append(" -> Squad anklicken, oder den Haken im") + zeilen.append(" Reiter 'Tasten und Verhalten' entfernen.") + else: + self.status_var.set("● HORCHT") + self.status_label.config(foreground=AMBER) + self.detail_var.set("") + zeilen.append("Nichts blockiert - es fehlt nur lautes Sprechen.") + self.diag_var.set("\n".join(zeilen)) + except Exception: + pass + self.root.after(80, self.ui_tick) + + def on_close(self): + try: + self.save_config() + except Exception: + pass + self.stop() + self.root.destroy() + + +def main(): + root = tk.Tk() + try: + apply_tactical_theme(root) + except Exception as e: + log_exception(type(e), e, e.__traceback__) + VoiceActivationApp(root) + root.mainloop() + + +if __name__ == "__main__": + main() diff --git a/start.pyw b/start.pyw new file mode 100644 index 0000000..319b2bc --- /dev/null +++ b/start.pyw @@ -0,0 +1,28 @@ +""" +Startet das Programm ohne Konsolenfenster. + +Hintergrund: Die pythonw.exe innerhalb einer virtuellen Umgebung ist nur +ein Weiterleiter, der intern die Konsolenfassung python.exe nachstartet - +dabei erscheint ein Terminalfenster. Die echte pythonw.exe der +Python-Installation hat dieses Verhalten nicht, kennt aber die Pakete der +virtuellen Umgebung nicht. + +Diese Datei wird deshalb mit der echten pythonw.exe gestartet und haengt +die Pakete der virtuellen Umgebung selbst in den Suchpfad ein. +""" + +import sys +from pathlib import Path + +ORDNER = Path(__file__).resolve().parent + +for pfad in (ORDNER / ".venv" / "Lib" / "site-packages", ORDNER): + if pfad.is_dir(): + eintrag = str(pfad) + if eintrag in sys.path: + sys.path.remove(eintrag) + sys.path.insert(0, eintrag) + +import squad_voice_activation # noqa: E402 + +squad_voice_activation.main() diff --git a/werkzeuge/baue_release.py b/werkzeuge/baue_release.py new file mode 100644 index 0000000..84b5a44 --- /dev/null +++ b/werkzeuge/baue_release.py @@ -0,0 +1,232 @@ +""" +Erzeugt aus der Quelle ein vollstaendiges Release. + +Ergebnis in dist/: + paket/ aufbereitete Programmdateien + SquadVoiceActivation-.zip Paket fuer den Auto-Updater + SquadVoiceActivation-Setup-.exe + version.json Steuerdatei fuer den Server + server/ genau das, was hochgeladen wird + +Aufruf: .venv\\Scripts\\python.exe werkzeuge\\baue_release.py +""" + +import hashlib +import io +import json +import re +import shutil +import subprocess +import sys +import tokenize +import zipfile +from pathlib import Path + +WURZEL = Path(__file__).resolve().parent.parent +DIST = WURZEL / "dist" +BASIS_URL = "https://sva.tyrveil.com" + +PYTHON_DATEIEN = ("squad_voice_activation.py", "start.pyw", "make_icon.py") +MITKOPIEREN = ("requirements.txt", "icon.png", "icon.ico") + +ISCC_KANDIDATEN = ( + Path.home() / "AppData/Local/Programs/Inno Setup 6/ISCC.exe", + Path("C:/Program Files (x86)/Inno Setup 6/ISCC.exe"), + Path("C:/Program Files/Inno Setup 6/ISCC.exe"), +) + +UMLAUTE = [ + ("Aenderung", "Änderung"), ("aendern", "ändern"), ("Geraet", "Gerät"), + ("Haelt", "Hält"), ("haelt", "hält"), ("laesst", "lässt"), + ("laeuft", "läuft"), ("Laeuft", "Läuft"), ("naechst", "nächst"), + ("Praefix", "Präfix"), ("waehl", "wähl"), ("Waehl", "Wähl"), + ("gewaehlt", "gewählt"), ("waehrend", "während"), ("zulaessig", "zulässig"), + ("Zulaessig", "Zulässig"), ("faellt", "fällt"), ("spaeter", "später"), + ("Staender", "Ständer"), ("Behaelter", "Behälter"), ("oeffn", "öffn"), + ("Oeffn", "Öffn"), ("moeglich", "möglich"), ("koenn", "könn"), + ("Koenn", "Könn"), ("loesch", "lösch"), ("noetig", "nötig"), + ("hoeher", "höher"), ("hoechst", "höchst"), ("Menue", "Menü"), + ("Buegel", "Bügel"), ("Stueck", "Stück"), ("drueck", "drück"), + ("Drueck", "Drück"), ("gedrueckt", "gedrückt"), ("zurueck", "zurück"), + ("Zurueck", "Zurück"), ("ueber", "über"), ("Ueber", "Über"), + ("fuer", "für"), ("Fuer", "Für"), ("muess", "müss"), + ("ausfuehr", "ausführ"), ("fuehrt", "führt"), ("unterstuetz", "unterstütz"), + ("gueltig", "gültig"), ("Schluessel", "Schlüssel"), ("ueblich", "üblich"), + ("zusaetzlich", "zusätzlich"), ("pruef", "prüf"), ("Pruef", "Prüf"), + ("Verknuepfung", "Verknüpfung"), ("verknuepf", "verknüpf"), + ("verzoeger", "verzöger"), ("schliess", "schließ"), ("Schliess", "Schließ"), + ("heisst", "heißt"), ("ausser", "außer"), ("Ausser", "Außer"), + ("gross", "groß"), ("Gross", "Groß"), ("weiss", "weiß"), ("Fuss", "Fuß"), + ("Oberflaeche", "Oberfläche"), ("Flaeche", "Fläche"), + ("Abhaengigkeit", "Abhängigkeit"), ("regelmaessig", "regelmäßig"), + ("Verhaelt", "Verhält"), ("Erklaerung", "Erklärung"), + ("standardmaessig", "standardmäßig"), ("hoehe", "höhe"), + ("uebernommen", "übernommen"), ("haengt", "hängt"), + ("abgestuerzt", "abgestürzt"), ("loesst", "löst"), ("Loest", "Löst"), + ("tatsaechlich", "tatsächlich"), ("Haeufige", "Häufige"), + ("Rueckmeldung", "Rückmeldung"), ("geoeffnet", "geöffnet"), + ("kuerzt", "kürzt"), ("laengeren", "längeren"), ("Faerbt", "Färbt"), + ("aelteren", "älteren"), ("massgeblich", "maßgeblich"), + ("Pruefsumme", "Prüfsumme"), ("entschluesselt", "entschlüsselt"), + ("unveraendert", "unverändert"), ("Netzwerkfehler", "Netzwerkfehler"), +] + + +def version_lesen(): + text = (WURZEL / "squad_voice_activation.py").read_text(encoding="utf-8") + treffer = re.search(r'^VERSION\s*=\s*"([^"]+)"', text, re.M) + if not treffer: + raise SystemExit("VERSION nicht gefunden") + return treffer.group(1) + + +def aufbereiten(pfad: Path): + """Kommentare entfernen und echte Umlaute setzen.""" + quelle = pfad.read_text(encoding="utf-8") + + behalten = [t for t in tokenize.generate_tokens(io.StringIO(quelle).readline) + if t.type != tokenize.COMMENT] + text = tokenize.untokenize(behalten) + + zeilen, leer = [], 0 + for zeile in text.split("\n"): + zeile = zeile.rstrip() + leer = leer + 1 if not zeile else 0 + if leer <= 2: + zeilen.append(zeile) + text = "\n".join(zeilen).strip() + "\n" + + tokens = [] + for tok in tokenize.generate_tokens(io.StringIO(text).readline): + if tok.type == tokenize.STRING: + neu = tok.string + for alt, ersatz in UMLAUTE: + neu = neu.replace(alt, ersatz) + tok = tok._replace(string=neu) + tokens.append(tok) + text = tokenize.untokenize(tokens) + + # f-Zeichenketten sind seit Python 3.12 keine STRING-Token mehr + for alt, ersatz in (("uebernommen", "übernommen"), ("geoeffnet", "geöffnet"), + ("ueblichen", "üblichen"), ("Bildpunkte gross", + "Bildpunkte groß")): + text = text.replace(alt, ersatz) + + pfad.write_text(text, encoding="utf-8", newline="\n") + + +def paket_bauen(version): + paket = DIST / "paket" + if paket.exists(): + shutil.rmtree(paket) + (paket / "Programm").mkdir(parents=True) + + for name in PYTHON_DATEIEN: + ziel = paket / "Programm" / name + shutil.copy2(WURZEL / name, ziel) + aufbereiten(ziel) + subprocess.run([sys.executable, "-m", "py_compile", str(ziel)], + check=True, capture_output=True) + for name in MITKOPIEREN: + shutil.copy2(WURZEL / name, paket / "Programm" / name) + + vorlage = WURZEL / "installer" / "paketdateien" + if vorlage.is_dir(): + for datei in vorlage.iterdir(): + shutil.copy2(datei, paket / "Programm" / datei.name) + + for unter in (paket / "Programm").rglob("__pycache__"): + shutil.rmtree(unter, ignore_errors=True) + + # Der Installer legt die Dateien flach ab, der Updater erwartet sie + # unter Programm/. Beides getrennt halten, sonst landet im + # Installationsordner ein ueberfluessiger Unterordner. + flach = DIST / "installerdateien" + if flach.exists(): + shutil.rmtree(flach) + flach.mkdir(parents=True) + for datei in (paket / "Programm").iterdir(): + if datei.is_file(): + shutil.copy2(datei, flach / datei.name) + return paket + + +def zip_bauen(paket, version): + ziel = DIST / f"SquadVoiceActivation-{version}.zip" + if ziel.exists(): + ziel.unlink() + with zipfile.ZipFile(ziel, "w", zipfile.ZIP_DEFLATED) as archiv: + for datei in sorted((paket / "Programm").iterdir()): + if datei.is_file(): + archiv.write(datei, f"Programm/{datei.name}") + return ziel + + +def installer_bauen(version): + iscc = next((p for p in ISCC_KANDIDATEN if p.is_file()), None) + if iscc is None: + print(" Inno Setup nicht gefunden - Installer wird uebersprungen") + return None + skript = WURZEL / "installer" / "setup.iss" + inhalt = skript.read_text(encoding="utf-8") + inhalt = re.sub(r'(#define Version\s+)"[^"]+"', rf'\1"{version}"', inhalt) + skript.write_text(inhalt, encoding="utf-8") + + ergebnis = subprocess.run([str(iscc), str(skript)], + capture_output=True, text=True) + if ergebnis.returncode != 0: + print(ergebnis.stdout[-1500:]) + print(ergebnis.stderr[-1500:]) + raise SystemExit("Installer konnte nicht erstellt werden") + return DIST / f"SquadVoiceActivation-Setup-{version}.exe" + + +def server_bauen(version, zip_pfad, setup_pfad): + server = DIST / "server" + if server.exists(): + shutil.rmtree(server) + server.mkdir(parents=True) + + shutil.copy2(zip_pfad, server / zip_pfad.name) + if setup_pfad and setup_pfad.exists(): + shutil.copy2(setup_pfad, server / setup_pfad.name) + anleitung = WURZEL / "installer" / "HOCHLADEN.txt" + if anleitung.is_file(): + shutil.copy2(anleitung, server / anleitung.name) + + pruefsumme = hashlib.sha256(zip_pfad.read_bytes()).hexdigest() + angaben = { + "version": version, + "datei": f"{BASIS_URL}/{zip_pfad.name}", + "sha256": pruefsumme, + "hinweis": "", + } + (server / "version.json").write_text( + json.dumps(angaben, indent=2, ensure_ascii=False) + "\n", + encoding="utf-8") + return server, pruefsumme + + +def main(): + version = version_lesen() + DIST.mkdir(exist_ok=True) + print(f"Version {version}") + + paket = paket_bauen(version) + print(" Programmdateien aufbereitet") + + zip_pfad = zip_bauen(paket, version) + print(f" {zip_pfad.name} ({zip_pfad.stat().st_size // 1024} KB)") + + setup_pfad = installer_bauen(version) + if setup_pfad: + print(f" {setup_pfad.name} ({setup_pfad.stat().st_size // 1024} KB)") + + server, pruefsumme = server_bauen(version, zip_pfad, setup_pfad) + print(f" server/ vorbereitet, SHA256 {pruefsumme[:16]}...") + print() + print(f"Zum Hochladen bereit: {server}") + + +if __name__ == "__main__": + main() diff --git a/werkzeuge/mictest.py b/werkzeuge/mictest.py new file mode 100644 index 0000000..e2c8bec --- /dev/null +++ b/werkzeuge/mictest.py @@ -0,0 +1,53 @@ +"""Testet jedes Eingabegeraet in einem eigenen Prozess mit Zeitlimit.""" +import subprocess +import sys + +PY = sys.executable + +CHILD = r''' +import sys, numpy as np, sounddevice as sd +dev = int(sys.argv[1]); sr = int(sys.argv[2]) +frames = int(0.7 * sr) +with sd.InputStream(device=dev, channels=1, samplerate=sr, dtype="float32") as s: + data, overflowed = s.read(frames) +rms = float(np.sqrt(np.mean(data**2))); mx = float(np.max(np.abs(data))) +print(f"{rms:.6f} {mx:.6f}") +''' + + +def main(): + import sounddevice as sd + devs = [(i, d) for i, d in enumerate(sd.query_devices()) + if d["max_input_channels"] > 0] + print(f"{'Idx':>4} {'Geraet':44} {'SR':>6} {'Ergebnis'}") + print("-" * 92) + for i, d in devs: + name = d["name"][:42] + sr = 48000 + try: + sd.check_input_settings(device=i, channels=1, samplerate=sr, + dtype="float32") + except Exception: + sr = int(d["default_samplerate"]) + try: + out = subprocess.run([PY, "-c", CHILD, str(i), str(sr)], + capture_output=True, text=True, timeout=6) + except subprocess.TimeoutExpired: + print(f"{i:>4} {name:44} {sr:>6} HAENGT (kein Datenfluss)") + continue + if out.returncode != 0: + err = (out.stderr or "").strip().splitlines() + msg = err[-1][:44] if err else "unbekannter Fehler" + print(f"{i:>4} {name:44} {sr:>6} FEHLER: {msg}") + continue + try: + rms, mx = (float(x) for x in out.stdout.split()) + except Exception: + print(f"{i:>4} {name:44} {sr:>6} unlesbare Ausgabe") + continue + tag = "STILLE (exakt 0)" if mx == 0.0 else f"rms={rms:.5f} max={mx:.5f}" + print(f"{i:>4} {name:44} {sr:>6} {tag}") + + +if __name__ == "__main__": + main() diff --git a/werkzeuge/screenshot.py b/werkzeuge/screenshot.py new file mode 100644 index 0000000..5cc705e --- /dev/null +++ b/werkzeuge/screenshot.py @@ -0,0 +1,48 @@ +"""Nimmt das Fenster inklusive Titelleiste auf.""" +import ctypes +import ctypes.wintypes as wintypes +import subprocess +import sys +import tkinter as tk + +sys.path.insert(0, r"C:\Users\danie\Downloads\Squad_Local_Voice_Activation_v2") +import squad_voice_activation as m + +OUT = (r"C:\Users\danie\AppData\Local\Temp\claude" + r"\C--Users-danie-Downloads-Squad-Local-Voice-Activation-v2" + r"\64d89be0-cffb-4a90-bed0-f23f786b3017\scratchpad\titelleiste.png") + + +class RECT(ctypes.Structure): + _fields_ = [("left", wintypes.LONG), ("top", wintypes.LONG), + ("right", wintypes.LONG), ("bottom", wintypes.LONG)] + + +root = tk.Tk() +m.apply_tactical_theme(root) +app = m.VoiceActivationApp(root) +root.attributes("-topmost", True) +app.current_level = 0.041 + + +def capture(): + root.update_idletasks() + root.update() + hwnd = ctypes.windll.user32.GetParent(root.winfo_id()) or root.winfo_id() + r = RECT() + ctypes.windll.user32.GetWindowRect(wintypes.HWND(hwnd), ctypes.byref(r)) + x, y = r.left, r.top + w, h = r.right - r.left, r.bottom - r.top + ps = ("Add-Type -AssemblyName System.Drawing;" + f"$b = New-Object System.Drawing.Bitmap {w},{h};" + "$g = [System.Drawing.Graphics]::FromImage($b);" + f"$g.CopyFromScreen({x},{y},0,0,$b.Size);" + f"$b.Save('{OUT}');$g.Dispose();$b.Dispose()") + subprocess.run(["powershell", "-NoProfile", "-Command", ps], + capture_output=True) + print("gespeichert:", OUT, f"({w}x{h})") + root.destroy() + + +root.after(2500, capture) +root.mainloop() diff --git a/werkzeuge/strip.py b/werkzeuge/strip.py new file mode 100644 index 0000000..004194b --- /dev/null +++ b/werkzeuge/strip.py @@ -0,0 +1,49 @@ +"""Entfernt Kommentarzeilen, laesst Docstrings und Code unangetastet.""" +import io +import sys +import tokenize + + +def strip_comments(quelle: str) -> str: + ergebnis = [] + tokens = list(tokenize.generate_tokens(io.StringIO(quelle).readline)) + entfernt = 0 + for tok in tokens: + if tok.type == tokenize.COMMENT: + entfernt += 1 + continue + ergebnis.append(tok) + text = tokenize.untokenize(ergebnis) + return text, entfernt + + +def aufraeumen(text: str) -> str: + zeilen = text.split("\n") + raus = [] + for zeile in zeilen: + # Zeilen, die nur noch aus Leerzeichen bestehen, komplett leeren + raus.append("" if not zeile.strip() else zeile.rstrip()) + # hoechstens zwei Leerzeilen hintereinander + kompakt = [] + leer = 0 + for zeile in raus: + if zeile == "": + leer += 1 + if leer > 2: + continue + else: + leer = 0 + kompakt.append(zeile) + while kompakt and kompakt[0] == "": + kompakt.pop(0) + while kompakt and kompakt[-1] == "": + kompakt.pop() + return "\n".join(kompakt) + "\n" + + +if __name__ == "__main__": + pfad = sys.argv[1] + quelle = io.open(pfad, encoding="utf-8").read() + text, anzahl = strip_comments(quelle) + io.open(pfad, "w", encoding="utf-8", newline="\n").write(aufraeumen(text)) + print(f"{pfad}: {anzahl} Kommentare entfernt") diff --git a/werkzeuge/umlaute.py b/werkzeuge/umlaute.py new file mode 100644 index 0000000..d582bc3 --- /dev/null +++ b/werkzeuge/umlaute.py @@ -0,0 +1,99 @@ +"""Setzt echte Umlaute in Zeichenketten und Docstrings. Code bleibt unberuehrt.""" +import io +import re +import sys +import tokenize + +ERSATZ = [ + ("Aenderung", "Änderung"), ("aendern", "ändern"), ("aendert", "ändert"), + ("Aehnlich", "Ähnlich"), ("aehnlich", "ähnlich"), + ("Geraet", "Gerät"), ("geraet", "gerät"), + ("Haelt", "Hält"), ("haelt", "hält"), + ("laesst", "lässt"), ("Laesst", "Lässt"), + ("laeuft", "läuft"), ("Laeuft", "Läuft"), + ("naechst", "nächst"), ("Naechst", "Nächst"), + ("Praefix", "Präfix"), ("praefix", "präfix"), + ("waehl", "wähl"), ("Waehl", "Wähl"), ("gewaehlt", "gewählt"), + ("waehrend", "während"), ("Waehrend", "Während"), + ("zulaessig", "zulässig"), ("Zulaessig", "Zulässig"), + ("faellt", "fällt"), ("Faelle", "Fälle"), + ("erklaert", "erklärt"), ("Qualitaet", "Qualität"), + ("spaeter", "später"), ("Staender", "Ständer"), + ("Behaelter", "Behälter"), ("verfuegbar", "verfügbar"), + ("Anfuehrungszeichen", "Anführungszeichen"), + ("oeffn", "öffn"), ("Oeffn", "Öffn"), + ("moeglich", "möglich"), ("Moeglich", "Möglich"), + ("koenn", "könn"), ("Koenn", "Könn"), + ("loesch", "lösch"), ("Loesch", "Lösch"), + ("noetig", "nötig"), ("Noetig", "Nötig"), + ("hoeher", "höher"), ("Hoeher", "Höher"), + ("hoechst", "höchst"), ("Hoechst", "Höchst"), + ("groess", "größ"), ("Groess", "Größ"), + ("Menue", "Menü"), ("menue", "menü"), + ("Buegel", "Bügel"), ("Stueck", "Stück"), + ("druck", "druck"), + ("drueck", "drück"), ("Drueck", "Drück"), ("gedrueckt", "gedrückt"), + ("zurueck", "zurück"), ("Zurueck", "Zurück"), + ("ueber", "über"), ("Ueber", "Über"), + ("fuer", "für"), ("Fuer", "Für"), + ("muess", "müss"), ("Muess", "Müss"), + ("ausfuehr", "ausführ"), ("Ausfuehr", "Ausführ"), + ("durchfuehr", "durchführ"), ("fuehrt", "führt"), + ("unterstuetz", "unterstütz"), ("Unterstuetz", "Unterstütz"), + ("gueltig", "gültig"), ("Gueltig", "Gültig"), + ("Schluessel", "Schlüssel"), ("ueblich", "üblich"), + ("zusaetzlich", "zusätzlich"), ("Zusaetzlich", "Zusätzlich"), + ("pruef", "prüf"), ("Pruef", "Prüf"), + ("Verknuepfung", "Verknüpfung"), ("verknuepf", "verknüpf"), + ("verzoeger", "verzöger"), ("Verzoeger", "Verzöger"), + ("zueglich", "züglich"), ("Weiterleit", "Weiterleit"), + ("Umgebungsvariable", "Umgebungsvariable"), + ("schliess", "schließ"), ("Schliess", "Schließ"), + ("heisst", "heißt"), ("Heisst", "Heißt"), + ("ausser", "außer"), ("Ausser", "Außer"), + ("gross", "groß"), ("Gross", "Groß"), + ("weiss", "weiß"), + ("Fuss", "Fuß"), + ("Oberflaeche", "Oberfläche"), ("Flaeche", "Fläche"), + ("Abhaengigkeit", "Abhängigkeit"), ("abhaengig", "abhängig"), + ("regelmaessig", "regelmäßig"), ("gemaess", "gemäß"), + ("Bereitschaft", "Bereitschaft"), + ("Verhaelt", "Verhält"), ("verhaelt", "verhält"), + ("Erklaerung", "Erklärung"), + ("Standardmaessig", "Standardmäßig"), ("standardmaessig", "standardmäßig"), + ("Vordergrund", "Vordergrund"), + ("Auswaehl", "Auswähl"), + ("Symbolleiste", "Symbolleiste"), + ("Taskleiste", "Taskleiste"), + ("Woerter", "Wörter"), + ("hoer", "hör"), +] + + +def ersetze(text): + for alt, neu in ERSATZ: + if alt != neu: + text = text.replace(alt, neu) + return text + + +def verarbeite(pfad): + quelle = io.open(pfad, encoding="utf-8").read() + tokens = [] + treffer = 0 + for tok in tokenize.generate_tokens(io.StringIO(quelle).readline): + if tok.type == tokenize.STRING: + neu = ersetze(tok.string) + if neu != tok.string: + treffer += 1 + tok = tok._replace(string=neu) + tokens.append(tok) + io.open(pfad, "w", encoding="utf-8", newline="\n").write( + tokenize.untokenize(tokens)) + return treffer + + +if __name__ == "__main__": + for pfad in sys.argv[1:]: + n = verarbeite(pfad) + print(f" {pfad}: {n} Textbausteine angepasst")