6.9 KiB
6.9 KiB
Kontosync über FTP
Der Abgleich zwischen Desktop und Tablet läuft manuell über einen FTP-Zugang. Es gibt kein Konto im Sinne einer Anmeldung auf einem Server: Die Zugangsdaten sind das „Konto“, jedes Gerät bekommt dieselben Daten.
Einrichten
- Auf beiden Geräten: Datei → Sync-Einstellungen…
- Eintragen:
- Server – Hostname des FTP-Servers (ohne
ftp://) - Port – normalerweise 21
- Benutzer / Passwort
- Verzeichnis – Zielordner relativ zum Login, z. B.
rinkplanner
- Server – Hostname des FTP-Servers (ohne
- FTPS eingeschaltet lassen (empfohlen).
- Server-Zertifikat prüfen nur abschalten, wenn der Hoster ein abweichendes Zertifikat nutzt (bei Shared Hosting häufig). Die Verbindung bleibt verschlüsselt, der Server wird dann aber nicht kryptografisch bestätigt.
- Speichern.
Danach Datei → Jetzt synchronisieren.
Was passiert
- Jede Kür liegt als
.jsonunteruser://routines/und wird 1:1 in das FTP-Verzeichnis gespiegelt (flach, keine Unterordner). Gehört eine Musikdatei zur Kür (.mp3,.ogg,.wav), liegt sie im selben Ordner und wird mit denselben Regeln hoch- und heruntergeladen. Legacy-.tres- Dateien werden weiterhin mit synchronisiert, damit bestehende Installationen ihre Serverkopien nicht verlieren; neue Speicherungen schreiben.json. Beim Laden wird eine.tresvor demResourceLoadergegen eine Whitelist geprüft (nur Modellskripte, kein eingebettetes GDScript). - Der Sync vergleicht pro Datei den letzten gemeinsamen Stand
(
user://sync_state.cfg) mit den aktuellen Zeitstempeln:
| Lage | Aktion |
|---|---|
| nur lokal, noch nie synchronisiert | hochladen |
| nur auf dem Server | herunterladen |
| seit dem letzten Sync nur lokal geändert | hochladen |
| seit dem letzten Sync nur auf dem Server geändert | herunterladen |
| beidseitig geändert (seit dem letzten Sync) | Konflikt: lokale Fassung bleibt Hauptdatei, Serverfassung kommt als (Server …)-Kopie dazu |
| Datei auf einer Seite gelöscht | nichts tun (keine Löschweitergabe) |
| erster Sync, Datei auf beiden Seiten | Server übernimmt: Serverfassung wird Hauptdatei, lokale Fassung bleibt als (Lokal …)-Kopie |
Wie kommt eine Kür vom Desktop aufs Tablet?
- Auf dem Desktop die Kür speichern (Datei → Speichern) und synchronisieren.
- Auf dem Tablet zuerst synchronisieren, dann Datei → Öffnen. Die Kür wird heruntergeladen und erscheint in der Liste.
Wichtig: Der Abgleich ordnet Dateien über den Dateinamen zu (der aus dem Kür-Titel entsteht). Eine Kür mit demselben Namen auf beiden Geräten ist kein „Update“, sondern eine Kollision:
- Erster Sync einer Datei auf beiden Seiten (kein gemeinsamer Stand):
Die Serverfassung übernimmt den Namen, die lokale Fassung bleibt als
name (Lokal JJJJ-MM-TT HHMM).jsondaneben. So bekommt ein neues Gerät die gemeinsame Version, ohne die lokale Arbeit zu verlieren. - Beide Seiten seit dem letzten Sync geändert: Die lokale Fassung bleibt
Hauptdatei, die Serverfassung kommt als
name (Server JJJJ-MM-TT HHMM).jsondazu. Beim nächsten Sync wird diese Kopie als neue Kür hochgeladen. Zusammenführen musst du selbst. Die Kopien behalten die Endung der Ausgangsdatei; bei Legacy-.tresentstehen also weiterhin.tres-Kopien.
Wenn du auf dem Tablet also eine leere „Testkür1“ anlegst, obwohl es die
Desktop-Version schon gibt, hast du nach dem Sync zwei Dateien: die
Desktop-Version unter dem normalen Namen und deine leere Fassung als
testkür1 (Lokal …).json. Besser: erst synchronisieren, dann die vorhandene
Kür öffnen und bearbeiten.
- Vor dem Sync wird eine geänderte, bereits gespeicherte Kür automatisch gespeichert. Eine noch nie gespeicherte Kür öffnet zuerst „Speichern unter“.
- Läuft der Sync, zeigt die Statusleiste den Fortschritt; danach erscheint eine Zusammenfassung (hochgeladen / heruntergeladen / Konflikte / Fehler).
- Ist die geöffnete Kür vom Download betroffen und ungespeichert, wird sie nicht überschrieben – es erscheint ein Hinweis.
Technik
| Datei | Aufgabe |
|---|---|
src/core/sync/ftp_client.gd |
FTP/FTPS-Client (USER/PASS, AUTH TLS + PROT P, EPSV/PASV, MLSD, SIZE, RETR, STOR, DELE, MKD, RNFR/RNTO) |
src/core/sync/sync_plan.gd |
reine Vergleichslogik, Konfliktnamen, Zeitstempel |
src/core/sync/routine_sync.gd |
Ablauf, Datei-Ersetzung, Sync-Stand |
- Der Sync läuft in einem
Thread; die Oberfläche bleibt bedienbar und pollt den Fortschritt in_process. - Uploads gehen zuerst nach
name.uploadingund werden dann umbenannt (falls der Server das verweigert: direkter Upload). - Downloads landen in
name.partund ersetzen die Zieldatei erst danach. - Heruntergeladene
.json-Dateien werden als JSON validiert; Legacy-.treslaufen vor dem Laden durch die Whitelist inRoutineFile. Ein präparierter Server kann damit keine eingebetteten GDScripts ausführen. - Neue Speicherungen sind JSON; der Sync akzeptiert weiterhin
.tres, damit bestehende Dateien auf Server und Tablet nicht verschwinden. - Musikdateien werden als normale Anhänge der Kür behandelt: Die JSON nennt
nur den Dateinamen (
music_file), die Datei liegt daneben. Ändert sich die Musik auf einem Gerät, lädt der nächste Sync sie hoch; auf dem anderen Gerät wird sie heruntergeladen und beim Öffnen der Kür verwendet. Konfliktkopien behalten die Audio-Endung (z. B.kuer (Server …).mp3). - Eigene Timeline-Labels stehen in der Kür-JSON (
timeline_labels) und werden ohne Zusatzdateien mit der Kür übertragen. - Zugangsdaten liegen in
user://sync.cfg(Klartext, app-privat). Auf Android ist das der interne App-Speicher, auf dem Desktop~/.local/share/godot/app_userdata/Rinkplanner/. - Android braucht die
INTERNET-Berechtigung – ist im APK gesetzt.
Erfahrungen mit dem Zielserver
- Der Server spricht explizites FTPS (
AUTH TLS), außerdemMLST,MDTM,MFMTundEPSV– genau das, was der Abgleich braucht. - Sein TLS-Zertifikat passt nicht zum Hostnamen (leeres CN/SAN). Deshalb muss „Server-Zertifikat prüfen“ ausgeschaltet werden; die Übertragung bleibt verschlüsselt.
- Der Zielordner existiert in Kleinschreibung. Die App wechselt direkt
hinein und legt ihn bei Bedarf per
MKDan. - Ein vollständiger Testlauf (Upload, Überspringen, Download, Übernahme, Konflikt, Aufräumen) lief gegen den echten Server erfolgreich.
Grenzen
- Kein automatischer Sync, kein Push, kein Locking. Zwei Geräte, die gleichzeitig synchronisieren, können sich überholen; der Konfliktfall verhindert dann Datenverlust, nicht aber doppelte Dateien.
- Löschungen werden nicht übertragen (bewusst, um Versehen nicht zu multiplizieren).
- Umbenennen einer Kür wirkt wie „neu lokal“ + „nur Server“: beide Fassungen landen nebeneinander.
- Sehr große Kürsammlungen werden vollständig verglichen; für hunderte Dateien ist das noch unkritisch, für tausende wäre ein Manifest sinnvoll.