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 <noreply@anthropic.com>
This commit is contained in:
danny 2026-09-10 17:22:54 +02:00
commit f986c3ad11
22 changed files with 3288 additions and 0 deletions

88
installer/HOCHLADEN.txt Normal file
View file

@ -0,0 +1,88 @@
================================================================
Was auf sva.tyrveil.com muss
================================================================
Lade diese drei Dateien in das Wurzelverzeichnis der Subdomain:
version.json
SquadVoiceActivation-3.2.zip
SquadVoiceActivation-Setup-3.2.exe
Danach müssen diese Adressen erreichbar sein:
https://sva.tyrveil.com/version.json
https://sva.tyrveil.com/SquadVoiceActivation-3.2.zip
https://sva.tyrveil.com/SquadVoiceActivation-Setup-3.2.exe
ZUM VERTEILEN
-------------
Deinen Freunden gibst du nur diesen einen Link:
https://sva.tyrveil.com/SquadVoiceActivation-Setup-3.2.exe
Beim ersten Start meldet sich Windows mit "Der Computer wurde durch
Windows geschützt". Das liegt daran, dass die Datei nicht signiert ist,
nicht an einem Fehler. Der Weg: Weitere Informationen -> 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.

81
installer/einrichten.bat Normal file
View file

@ -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

View file

@ -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

View file

@ -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

86
installer/setup.iss Normal file
View file

@ -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;