thunderheronight--splat-workshop/README.de.md

Splat Workshop (Splat-Werkstatt)

Eine grafische Oberfläche für die Rekonstruktions-Pipeline von Arcturus Vision: Aufnahme der Arcturus Vision Camera an der Steam Frame auswählen, prüfen, umwandeln lassen und das Ergebnis direkt in die Gaussian-XR-Galerie auf der Brille bringen. Mit Weboberfläche, Tray-Symbol und Aufnahmeprüfung.

Kein Root, kein Jailbreak. Auf der Frame nutzt die Splat-Werkstatt nur den offiziellen Entwicklermodus aus den Steam-Einstellungen und SSH als normaler Benutzer – auf der Brille wird nichts installiert, ihr System bleibt unangetastet. Auch am PC läuft sie als dein Benutzer (nur die Voraussetzungen wie ffmpeg kommen aus der Paketverwaltung).

English

Räume, eine Statue, dein Auto, ein Garten – alles, um das du mit der Kamera herumgehen kannst, wird zu einer Szene, in die du hineinsteigen kannst.

Die Splat-Werkstatt rechnet die Splats nicht selbst: Die Rekonstruktion übernehmen die Pipeline von Arcturus Vision und Spirula Studio. Die Werkstatt ist die Oberfläche drumherum – sie bereitet alles vor, startet und überwacht die Pipeline und erledigt alles davor und danach.

Arcturus Vision stellt die Rekonstruktions-Skripte und einen Spirula-Studio-Fork bereit. Bis eine Aufnahme als Szene in Gaussian XR auftaucht, sind aber viele Handgriffe nötig. Die Splat-Werkstatt packt den ganzen Weg in eine lokale Weboberfläche:

1. Aufnahme wählen – direkt von der Frame (per SSH) oder vom PC, mit Vorschaubildern.
2. Prüfen, bevor eine Stunde Rechenzeit draufgeht: Helligkeit, Struktur, schnelle Schwenks, verdeckte Linse – Sekunde für Sekunde.
3. Umwandeln mit Qualitätsstufe (Schnell / Hoch / Maximal) oder eigenen Werten, mit Fortschritt, Restzeit und PSNR-Kurve.
4. In die Galerie: Vorschaubild und Namensschild im Stil der Beispielszenen, kopiert in den Ordner für eigene Szenen von Gaussian XR auf der Frame (Documents/GaussianXR).
5. Die Wohnung zusammensetzen: Räume gruppieren – ein Raum darf aus mehreren Aufnahmen bestehen – und zu einem Rundgang machen, durch den du gehst, voll für den PC, kleiner für die Frame.

Neu in 0.5

• 🧊 Mesh-Export – Mesh … macht aus einer Szene oder einem Rundgang eine Oberfläche für Blender und andere 3D-Programme (GLB, OBJ, PLY) oder für den 3D-Druck (STL). Sie steht aufrecht mit dem Boden auf Höhe 0, statt auf der Seite zu liegen – für jedes Format per Import in Blender geprüft; mit Textur, wenn die Trainingsbilder noch da sind. (Angeregt in #2.)

_{Beispieldaten – ein künstlicher Raum, in Blender gerendert (englische Oberfläche).}

Neu in 0.4

• 🧽 Fassungen bereinigen (experimentell) – vier Schieberegler im Fassungen-Dialog: Decke (eine weiße Decke wird zum dunklen Schleier – der Schleier kommt weg, die Decke wird in ihrer eigenen Farbe geschlossen), Boden (Löcher gefüllt), Dunst (große durchsichtige Wolken; dünne Gitter und Kabel bleiben), Rand (was außerhalb des Raums liegt). Die Szene selbst bleibt; die bereinigte Fassung neben einer ohne vergleichen.
• 🎚️ Fassungen nach Zweck – für die Frame (eine Größe, mit den auf einer Steam Frame gemessenen fps) oder für den PC (alle Splats); auf Wunsch dieselbe ohne Bereinigung daneben; vorher eine Vorschau, was entsteht. Fassungen heißen nach ihren Bereinigungsstärken, Als Vorlage übernimmt die Einstellungen für den nächsten Versuch, eine PC-Fassung öffnet sich mit einem Klick in Spirula Studio, und Fassungen klappen unter ihrer Szene oder ihrem Rundgang auf.
• 🧭 Aufgeräumte Knopfleisten – was du tust, was du anschaust, was du änderst; das Aufklappen in einer eigenen Zeile.

_{Beispieldaten – Szene und Vorschaubild sind Platzhalter (englische Oberfläche).}

Neu in 0.3

• 🚪 Räume aus mehreren Aufnahmen – eine Gruppe als Ein Raum aus mehreren Aufnahmen markieren, z. B. zwei kurze Runden durchs Wohnzimmer. Beim Zusammensetzen kommt jeder Teil des Raums aus der Aufnahme, die ihn am besten gesehen hat. Die Arcturus-Pipeline nimmt höchstens 500 Bildpaare pro Aufnahme – mehrere kurze Aufnahmen geben einem Raum also deutlich mehr Detail als eine lange.
• ✂️ Lange Videos aufteilen – bei langen Aufnahmen bietet die Werkstatt Video aufteilen (volle Detailtiefe, dauert länger) oder Video nicht aufteilen (schneller, weniger Bildpaare pro Sekunde) an. Aufgeteilt werden die Teile nacheinander umgewandelt und von selbst zu einem Raum. Die Original-Aufnahme bleibt unverändert.
• 🏠 Eine Wohnung aus Räumen – eine Gruppe darf solche Räume neben einzelnen Szenen enthalten. Zusammengesetzt wird in einem Durchgang aus den Original-Aufnahmen: innerhalb eines Raums jeder Teil aus der besten Aufnahme, zwischen den Räumen laufen die Grenzen durch die Türen. Nichts wird doppelt ausgedünnt; der Grundriss benennt und misst Räume statt Aufnahmen.
• 🧩 Bessere Übergänge zwischen Aufnahmen – eine Stelle kommt nur noch von einer Aufnahme, die dort wirklich etwas hat (keine dunklen Löcher mehr, wo eine Kamera „von hinter dem Sofa“ hingeschaut hat), und alle Aufnahmen werden auf eine Helligkeit gebracht: Jedes Training landet bei seiner eigenen, im selben Raum bis zu einem Drittel auseinander.
• 💤 Danach in den Standby – am laufenden Job anhaken: Wenn alles fertig ist (alle Teile, das Zusammensetzen, das Kopieren auf die Frame), geht der PC nach einer Minute Vorwarnung in den Standby. Bis dahin bleibt er wach, auch in den Sekunden zwischen zwei Jobs.
• 🐛 Behoben: Aufnahmen desselben Raums gelten nicht mehr gegenseitig als „Weg hinein“ – vorher konnten sie den echten Weg aus einem anderen Raum verdecken, der sich dann einen Teil des Raums nahm.

Neu in 0.2.3

• 🚂 Maßstab für Modelle, 🎚️ Fassungen nebeneinander, ⚡ 1 Mio. Splats als Empfehlung für die Frame, 📂 Szenen in Documents/GaussianXR (Steam-Updates lassen den Ordner in Ruhe), 🥽 Reiter Auf der Frame, ⬇️ Alle Aufnahmen holen, 🗑️ Aufnahmen einzeln löschen. Details: Release 0.2.3.

Neu in 0.2

• 🏠 Die ganze Wohnung als eine Szene – Räume gruppieren und Rundgang zusammensetzen: Die Räume eines Aufnahmedurchgangs werden aneinander ausgerichtet und zu einer begehbaren Szene verbunden, als volle Fassung für den PC und als kleinere für die Frame.
• 🎯 Saubere Übergänge – vier Korrekturen zur Wahl; die Gruppe zeigt, wie gut die Räume aneinanderpassen (meist auf 1–2 cm), so lässt sich vergleichen.
• 📁 Gruppen halten die Liste übersichtlich – nacheinander aufgenommene Räume werden automatisch vorgeschlagen.
• 🧹 Speicherplatz, Aufräumen, Löschen pro Szene und eine Liste abgebrochener Läufe zum Fortsetzen oder Entfernen.
• 🛡️ Sicherer: Neu rechnen behält die alte Szene, bis die neue fertig ist; der PC geht während einer Umwandlung nicht mehr in den Standby.

_{Beispieldaten (englische Oberfläche) – Raumnamen und Vorschaubilder sind Platzhalter, die Rundgang-Vorschau ist die synthetische Beispielwohnung.}

Alle Änderungen: CHANGELOG.md (englisch)

Funktionen

• Weboberfläche (nur Python-Standardbibliothek) – auf Wunsch auch vom Handy oder einem zweiten Rechner im Heimnetz.
• Tray-Symbol – zeigt, ob die Werkstatt läuft und was sie tut (Fortschrittsring). Öffnen, Umwandlung abbrechen, Beenden. Beenden während einer Umwandlung fragt nach: im Hintergrund fertig rechnen lassen oder abbrechen.
• Umwandlungen laufen unabhängig weiter – Browser zu, Tray beendet, Neustart: Werkstatt wieder öffnen, Fortschritt ist wieder da.
• Abbrechen & Fortsetzen ab dem letzten Zwischenstand.
• Aufnahmeprüfung ohne KI: reine Messwerte je Sekunde, farbige Zeitleiste und konkrete Hinweise („0:45–0:59 wenig Struktur“).
• Räume aus mehreren Aufnahmen (0.3): Ein Raum kann aus mehreren kurzen Aufnahmen bestehen (jede bis zu 500 Bildpaare) und eine Wohnung aus solchen Räumen – jeder Teil kommt aus der Aufnahme, die ihn am besten gesehen hat, die Grenzen zwischen den Räumen laufen durch die Türen. Räume erscheinen in der Liste innerhalb ihrer Wohnung und lassen sich auch einzeln zusammensetzen, ansehen und auf die Frame bringen.
• Gruppen und Rundgänge: Szenen gruppieren (z. B. alle Räume der Wohnung) und zu einer Szene zusammensetzen – eine volle Fassung für Gaussian XR am PC und eine kleinere für die Frame. Aufnahmen aus einem Durchgang teilen das Tracking-Koordinatensystem der Frame; die Werkstatt richtet die Räume aneinander aus (Korrekturen A–D zur Wahl), legt die Grenzen zwischen den Aufnahmen in die Türen und zeigt, wie gut die Räume aneinanderpassen. Vor dem Start schätzt sie den Speicherbedarf.
  
  _{Beispieldaten (englische Oberfläche) – Raumnamen und Vorschaubilder sind Platzhalter.}
• Fassungen einer Szene oder eines Rundgangs nebeneinander: weniger Splats für die Frame (0,75–2 Mio.), alle oder eine Obergrenze für den PC oder eine eigene Größe – jede mit eigenem Platz in der Galerie der Frame, zum Vergleichen, was flüssig läuft. Eine Fassung lässt sich auch bereinigen (0.4, experimentell): Decke, Boden, Dunst und Rand, jeweils mit eigener Stärke.
• Alle holen: Aufnahmen von der Frame alle oder als Auswahl nacheinander holen – mit einer Benachrichtigung, sobald die Frame aus darf.
• Aufnahmen löschen, einzeln: auf der Frame (mit deutlicher Warnung, wenn sie noch nicht auf dem PC liegt) oder auf dem PC (in den Papierkorb).
• Reiter Auf der Frame: alles, was in der Galerie von Gaussian XR auf der Frame liegt, mit Vorschaubildern – und von dort aufräumen.
• Maßstab für Modelle wie eine Modelleisenbahn (Z, N, TT, H0, S, 0, G oder eigener): Grundriss, Größen und Messwerkzeug zeigen die Größe des Originals, und auf Wunsch zeigt Gaussian XR das Modell begehbar in Originalgröße (an der Frame noch nicht getestet).
• Grundrisse (experimentell) einzelner Szenen oder einer ganzen Gruppe – Aufnahmen aus einem Durchgang fügen sich von selbst zum Grundriss der ganzen Wohnung; ein Raum aus mehreren Aufnahmen erscheint als ein Raum mit allen Wegen. Zwei Stile: Hübsch (Draufsicht in Farbe, Wände, gelaufener Weg) und Klassisch (leuchtende Punktdichte), dazu ein einfaches Messwerkzeug (Punkte anklicken, Abstände ablesen – etwa ±5 cm genau).
• Fertige Szenen: später auf die Frame übertragen, erneut übertragen, umbenennen (Ordner und Namensschild ziehen mit), löschen (in den Papierkorb), Ordner oder Spirula Studio öffnen.
• Abgebrochene Läufe werden mit ihrem Stand angezeigt: fortsetzen, neu starten oder löschen.
• Speicherplatz und Aufräumen: Jede Szene zeigt, wie viel Platz sie belegt (etwa 4 GB pro Raum). Ein Klick löscht Zwischenstände oder Trainingsbilder – Szene, Grundriss und Viewer funktionieren weiter.
• Aufnahmen umbenennen auf dem PC; Aufnahmedatum und Prüfergebnisse bleiben erhalten.
• Deutsche und englische Oberfläche (automatisch, umschaltbar).

Voraussetzungen, Installation, Bedienung

Siehe die englische README – kurz:

git clone https://github.com/thunderheronight/splat-workshop.git
cd splat-workshop
./install.sh --desktop        # Menüeintrag + Desktop-Verknüpfung; --autostart für das Tray beim Anmelden

Läuft unter Linux (getestet mit Nobara/Fedora und einer RTX 4070 SUPER). macOS ist ungetestet, Windows wird von der Arcturus-Pipeline noch nicht unterstützt.

Arcturus-Pipeline und Spirula Studio einrichten: Schritt für Schritt in docs/arcturus-setup.de.md (Pakete, Spirula bauen, bekannte Stolperfallen).

SSH auf der Frame einrichten (für Download der Aufnahmen und Kopieren in die Galerie):

1. Auf der Frame: Steam-Einstellungen → System → Enable Developer Mode.
2. Im linken Menü unter Developer ganz unten Set User Password wählen. Es gibt kein Standardpasswort – SSH geht erst, wenn du eins vergibst.
3. Am PC: ssh-copy-id steamos@<adresse der frame> (Passwort einmal eingeben), danach sollte ssh steamos@<adresse> ohne Passwort klappen.
4. Der Frame im Router eine feste IP geben und steamos@<diese adresse> in der Konfiguration unter [frame] host eintragen.

Danach in ~/.config/splat-workshop/config.toml die Pfade zur Arcturus-Pipeline (arcturus.vision/apps), zu Spirula Studio und die Adresse der Frame eintragen. Was noch fehlt, zeigt die Werkstatt oben auf der Seite an.

Nach dem Übertragen Gaussian XR auf der Frame neu starten, damit die Szene in der Galerie erscheint. Die Szenen liegen in Documents/GaussianXR, den Steam-Updates in Ruhe lassen (bis 0.2.3 lagen sie im Scenes-Ordner von Gaussian XR – Zu den eigenen Szenen verschieben im Reiter Auf der Frame holt sie herüber). Alles bleibt außerdem auf dem PC, Erneut übertragen stellt eine Szene wieder her. Für die Frame läuft etwa 1 Mio. Splats flüssig und sieht noch scharf aus.

Aufnahmetipps

• Viel Licht (Tageslicht plus Raumlicht), HDR mit 30 fps in der Kamera-App, nicht „Linear“.
• Räume: 30–90 s pro Raum, langsam gehen und langsam drehen, Dinge von mehreren Seiten zeigen.
• Große Räume: Die Pipeline nimmt höchstens 500 Bildpaare pro Aufnahme – bei 5 pro Sekunde (Hoch) ist das nach 100 s erreicht, eine 4-Minuten-Aufnahme bekommt nur noch 2 pro Sekunde. Bei einer langen Aufnahme beim Start Video aufteilen wählen – oder zwei oder drei kürzere Aufnahmen eines großen Raums in einem Durchgang machen und sie als Ein Raum aus mehreren Aufnahmen gruppieren.
• Gegenstände: langsam im Kreis darum herumgehen (15–40 s), Motiv in der Bildmitte halten.
• Nicht lange auf kahle Wände, Decke oder Fliesen halten. Die Decke aber ab und zu mitnehmen, zusammen mit der Wandoberkante oder einer Lampe: Eine weiße Decke, die kaum gefilmt wurde, wird zu einem dunklen Schleier über dem Raum.
• Gleiches Licht: Gegen Abend ändert sich das Tageslicht schon innerhalb von Minuten merklich, und Aufnahmen eines Raums bei verschiedenem Licht passen schlecht zusammen.
• Bewegte Personen werden zu Geisterschleiern.

Transparenzhinweis

Dieses Projekt ist mit Hilfe einer KI entstanden: Code, Dokumentation und die Platzhalter im Beispiel-Screenshot wurden gemeinsam mit Claude (Opus 5.5) von Anthropic in Claude Code erstellt. Ideen, Tests auf echter Hardware, Entscheidungen und Durchsicht kamen von mir. Fehlermeldungen sind willkommen – wenn etwas komisch aussieht, kann es gut ein Fehler sein, den keiner von uns bemerkt hat.

Lizenz

Ein Community-Tool, nicht mit Valve oder Arcturus Vision verbunden. Lizenz: GNU GPL v3.0.