## Wofür ist das Programm gedacht?

Das Programm analysiert equirektangulare 2:1-Panoramabilder anhand ihrer EXIF-Aufnahmezeiten und GPS-Koordinaten. Daraus entstehen zusammengehörige Aufnahmepunkte, Aufnahmeabschnitte und eine lokale Website mit 360°-Rundgang. Ein Grundriss als PDF oder Bild ist optional.

## Schnellstart in der GUI

1. Den Ordner mit den Theta-Bildern auswählen.
2. Optional einen Grundriss und bei PDF-Dateien die gewünschte Seite auswählen.
3. Den Ausgabeordner festlegen.
4. Im Register Zuordnung und Rundgänge Zeitabstand, GPS-Radius, Vorschau-/Dublettenfilter, Zeitraffer und Reihenfolge prüfen.
5. Vorschläge erzeugen verwenden, unerwünschte Bilder oder ganze Orte ausgrauen und anschließend Erzeugen und öffnen wählen.

Ohne Grundriss wird die Planansicht ausgelassen. Fehlen GPS-Daten, verwendet die automatische Erstzuordnung weiterhin die Aufnahmezeiten.

## Rundgangsvorschläge

Die lokale Seite unterscheidet die Vorschlagstypen Aufnahmeort und Zeitraffer. Sie trennt Vorschläge nach Datum und Aufnahmeabschnitt und beschriftet jeden Vorschlag mit Datum, Uhrzeit und den zugehörigen Bildern. Pro dargestellter Datums-/Uhrzeitsekunde bleibt nur ein kanonischer Dateiname sichtbar.

Ein Aufnahmeort benötigt mindestens zwei Bilder mit unterschiedlichen Blickwinkeln. Zwischen zwei aufeinanderfolgenden Bildern dürfen standardmäßig höchstens 300 Sekunden beziehungsweise fünf Minuten liegen; dieser Grenzwert ist einstellbar. Ein Zeitraffer benötigt mindestens zehn Bilder desselben Blickwinkels. Das größte Aufnahmeintervall darf höchstens 50 Prozent über dem kleinsten Intervall liegen. Gültige Reihen werden als GIF mit eingeblendeter Aufnahmezeit und 10 Bildern je Sekunde dargestellt.

Klar erkennbare Vorschau-, Thumbnail-, IrfanView- und Exportordner werden standardmäßig ausgelassen. Exakte Kopien und mehrfach belegte Aufnahmezeitpunkte werden vor der Gruppierung zusammengefasst.

Jede Vorschlagskarte ist anklickbar. Ein Zeitraffer öffnet sein GIF groß. Bei einem Aufnahmeort lädt die Seite zunächst die Vorschaubilder, zeigt den Berechnungsfortschritt und spielt danach weiche Übergänge zwischen den Blickwinkeln ab.

Der Schalter eines Bildes oder eines ganzen Vorschlags schaltet den Eintrag grau und wieder aktiv. Rückgängig stellt die letzte Auswahl wieder her; Alles verwenden setzt sie zurück. Die Auswahl wird in `route-selection.json` und zusätzlich im lokalen Browser gespeichert. Der nächste Rundgangsbau verwendet nur aktive Bilder und Vorschläge.

Die fünf globalen Möglichkeiten – empfohlen, chronologisch, räumlich kurz, abschnittsweise und kompakt – sind Reihenfolgen für den gesamten Rundgang und keine einzelnen Vorschläge.

## Karte, Ausgabe und Datenschutz

Bei vorhandenen GPS-Daten zeigt die Vorschlagsseite OpenStreetMap als Hintergrundkarte mit sichtbarer Quellenangabe. Dafür ruft der Browser ausschließlich die Kartenkacheln des aktuell sichtbaren Ausschnitts über das Internet ab. Bilder und Grundrisse werden dabei nicht übertragen. Ohne Internetverbindung oder GPS bleibt die relative lokale Kartendarstellung nutzbar.

Die erzeugte Website und ihre Analyse bleiben im ausgewählten Ordner. Vorherige Generator-Ausgaben werden außerhalb des ausgelieferten Webbaums gesichert.

## Lokale Vorschau

Webbrowser dürfen lokale JavaScript-Dateien aus Sicherheitsgründen einschränken. Deshalb startet das Programm einen lokalen HTTP-Server auf `127.0.0.1`. Dieser Server ist nur vom eigenen Rechner erreichbar und speichert die Auswahl der Ortsvorschläge im jeweiligen Ausgabeordner.

## Notwendige Aktualisierungen

Beim Start prüft die App höchstens einmal pro Kalendertag die Datei `version.json` auf der Produkt- und Downloadseite. Der Abruf enthält eine zufällige, stabile Installations-ID zur pseudonymisierten Reichweitenmessung; sie wird nicht aus Hardware- oder Personendaten abgeleitet. Erst wenn eine tatsächlich neuere Version erfolgreich erkannt wird, beginnt eine Frist von 90 Tagen. Bis zum Fristende nennt die App die verbleibenden Tage und bietet die Downloadseite an. Danach muss die notwendige Version installiert werden, bevor die App ihre eigentliche Arbeit fortsetzt.

Ein vorübergehender Netzwerk-, DNS-, TLS- oder Serverfehler startet keine Frist und sperrt die App nicht. Eine bereits nach erfolgreicher Erkennung gespeicherte Frist bleibt bestehen.

## Fehlerbehebung

- Nur Bilder mit ungefähr 2:1-Seitenverhältnis werden standardmäßig verwendet.
- Nahezu schwarze Bilder werden standardmäßig ausgeschlossen und protokolliert.
- Vorschaukopien und Dubletten werden standardmäßig ausgeblendet; die CLI kann beide Filter bewusst abschalten.
- Der Ausgabeordner darf nicht innerhalb des Bilderordners liegen.
- Ein bereits gefüllter Ausgabeordner muss eine frühere Generator-Ausgabe sein.
- Für reproduzierbare Aufrufe steht zusätzlich die CLI zur Verfügung.