hubobel/MSFS_Announcement_Studio
Watch
1
0
Fork
You've already forked MSFS_Announcement_Studio
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2 commits 1 branch 0 tags 23 KiB
  • Python 70.8%
  • HTML 25%
  • JavaScript 2.2%
  • Batchfile 2%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
hubobel 6ca603b7d4 initial commit
2026-09-16 18:24:40 +02:00
docs initial commit 2026-09-16 18:24:40 +02:00
src/announcement_studio initial commit 2026-09-16 18:24:40 +02:00
tests initial commit 2026-09-16 18:24:40 +02:00
.gitignore initial commit 2026-09-16 18:24:40 +02:00
LICENSE Initial commit 2026-09-16 18:00:35 +02:00
pyproject.toml initial commit 2026-09-16 18:24:40 +02:00
README.md initial commit 2026-09-16 18:24:40 +02:00
requirements.txt initial commit 2026-09-16 18:24:40 +02:00
run.py initial commit 2026-09-16 18:24:40 +02:00
Setup.cmd initial commit 2026-09-16 18:24:40 +02:00
Start Studio.cmd initial commit 2026-09-16 18:24:40 +02:00

README.md

MSFS Announcement Studio

Python-Werkzeug zur Erstellung individueller Ansagetexte für den MSFS Universal Announcer. Die geplante Weboberfläche dient der Administration. Betrieb auf dem Windows-11-Simulator-PC; Bedienung lokal im Browser über localhost. Entwicklung in PyCharm. Ein Starter und ein PowerShell-Update-Einzeiler sind geplant. Spracherzeugung, Flugphasenerkennung und Wiedergabe übernimmt der Universal Announcer.

Entwicklungsstand

Die lokale Weboberfläche bietet Einstellungen, SimBrief-Flugübersicht und Crew-Auswahl (zufällig, manuell oder kombiniert). Einstellungen und Crew bleiben über Neustarts hinweg erhalten. Ein erneuter Abruf desselben Flugplans behält die Crew; ein neuer SimBrief-Plan gilt als neuer Flugstand. Ein Abruffehler lässt den bisherigen Stand unverändert. KI-Generierung, Texteditor, Export und Update-Einzeiler folgen im nächsten Schritt. Announcer-Dateien werden noch nicht verändert.

Start per Doppelklick

  1. Einmal Setup.cmd ausführen (Python 3.11 oder neuer und Internet benötigt).
  2. Start Studio.cmd starten. Der Browser öffnet http://127.0.0.1:8765.
  3. SimBrief-Benutzernamen und optional den Announcements-Ordner speichern.
  4. „Aus SimBrief laden“ anklicken. Crew und Atmosphäre werden automatisch gewählt.

Bei „Selbst wählen“ bleiben leere Felder zufällig. Neu-Würfeln verändert nur zufällige Felder. Das Konsolenfenster während der Nutzung offen lassen; zum Beenden schließen oder Strg+C drücken. PyCharm wird im Alltag nicht benötigt. Ein zweiter Start öffnet die bereits laufende Anwendung.

Start in PyCharm

  1. Diesen Ordner als Projekt öffnen.
  2. Unter Python Interpreter die vorhandene .venv/Scripts/python.exe auswählen.
  3. run.py starten. Optional --no-browser oder --port 8766 verwenden.

Alternativ in PowerShell:

.\.venv\Scripts\python.exe run.py

Abhängigkeiten: Flask und Waitress; feste Versionen in requirements.txt. Kein Node und kein separater Frontend-Build erforderlich. Der Webdienst bindet nur an 127.0.0.1. Lokale Daten liegen in data/state.json, unabhängig vom aktuellen Arbeitsverzeichnis. Nur eine Instanz pro Projekt betreiben.

Tests: .\.venv\Scripts\python.exe -m unittest discover -s tests -v

Struktur

  • src/announcement_studio/domain.py: Flug, Crew und Ansageentwürfe.
  • src/announcement_studio/integrations/: SimBrief-Abruf und Normalisierung.
  • src/announcement_studio/services/: Crew-Auswahl; später Generierung und Aktivierung.
  • src/announcement_studio/web/: Endpunkte, HTML-Vorlagen und Darstellung.
  • src/announcement_studio/storage.py: atomare lokale Speicherung.
  • docs/product.md: Funktionsumfang und Etappen.
  • docs/architecture.md: Aufbau und technische Grenzen.

Lokale Konfiguration, API-Schlüssel und erzeugte Texte gehören nicht ins Repository.

Referenzen