Instructor Flow · Version 1.0.1

Deine Musik. Dein Timing. Dein Kurs.

Neu: Windows-Startdatei. Das Komplettpaket enthält START-INSTRUCTOR-FLOW.cmd. Die geführte Einrichtung steht in ERSTEINRICHTUNG.html. Zuerst vollständig entpacken, dann die Startdatei doppelklicken.

Schnellstart auf Windows: kostenlos und ohne Programmieren

Du benötigst kein Apple-Developer-Konto und keinen Mac. Die App ist eine statische Web-App ohne Backend, Abonnement oder Musik-Upload. Für Cloudflare brauchst du ein kostenloses Konto; die App benötigt nur Pages, keine kostenpflichtigen Zusatzprodukte.

  1. Lade Instructor-Flow-Cloudflare.zip herunter. Diese ZIP enthält bereits die fertigen App-Dateien. Nicht die Quellcode-ZIP hochladen.
  2. Öffne https://dash.cloudflare.com/ und melde dich an.
  3. Öffne Workers & Pages. Wähle Create application, dann Pages bzw. Get started und Direct Upload / Drag and drop your files. Je nach Dashboard-Version heißen die Schritte etwas anders. Wähle Pages und den direkten Datei-Upload, nicht eine kostenpflichtige Erweiterung.
  4. Vergib einen Namen, zum Beispiel mein-instructor-flow.
  5. Ziehe Instructor-Flow-Cloudflare.zip in das Upload-Feld. Alternativ die ZIP mit Windows „Alle extrahieren“ entpacken und den entpackten Ordner hochladen. Im hochgeladenen Hauptverzeichnis muss index.html liegen.
  6. Klicke Deploy site / Save and Deploy. Eine eigene Domain ist nicht nötig.
  7. Kopiere die angezeigte HTTPS-Adresse mit der Endung .pages.dev. Das ist dein dauerhafter App-Link. Öffne ihn auch auf iPhone und iPad.

Du musst nichts kompilieren und weder Node.js noch eine Programmiersprache installieren. Deine MP3s gehören nicht in die Cloudflare-ZIP: Importiere sie später innerhalb der App auf jedem Gerät. Nur die Programmdateien werden gehostet.

Die im Chat verlinkte Sites-Version ist eine private Vorschau und kann eine ChatGPT-Anmeldung verlangen. Die eigenständige .pages.dev-Version benötigt keine App-Anmeldung. Installation, Service Worker und Offline-Start der privaten Vorschau sind nicht praktisch verifiziert. Für den Kurs verwende das unabhängige Cloudflare-Hosting und teste dort.

Auf iPhone und iPad installieren

  1. Betriebssystem aktualisieren. Für Screen Wake Lock in einer Home-Bildschirm-Web-App wird iOS/iPadOS 18.4 oder neuer empfohlen. Die tatsächliche Freigabe zeigt die App an.
  2. Den .pages.dev-Link in Safari öffnen, nicht in einem eingebetteten Instagram- oder Messenger-Browser.
  3. Auf Teilen tippen → Zum Home-Bildschirm. Falls angeboten, Als Web-App öffnen aktivieren. Mit Hinzufügen bestätigen.
  4. Safari verlassen und die App über ihr neues Symbol starten.
  5. Unter Einstellungen prüfen, ob die Offline-Oberfläche gespeichert ist. Erst danach offline testen. Beim ersten Start ist Internet erforderlich.
  6. MP3s über Musik importieren aus Apples Dateien-App auswählen. Dateien aus iCloud vorher vollständig herunterladen. Die App kopiert die Musik in ihren lokalen Speicher.
  7. Auf dem iPad denselben Vorgang durchführen. Beide Geräte haben getrennte Sammlungen. Ein Vollbackup kann zur Übertragung dienen.

Bei einem neuen Hosting-Link gilt auch ein neuer lokaler Speicher. Bestehende Sammlungen werden nicht automatisch zur neuen Adresse übertragen. Vor einem Umzug ein Vollbackup sichern.

Deine erste Playlist

  1. Ein Format wählen, beispielsweise BODYBALANCE.
  2. Über ＋ neben Playlists eine Playlist anlegen, beispielsweise „Release 113“.
  3. Musik importieren wählen. Die importierten Tracks werden der ausgewählten Playlist hinzugefügt. Ohne ausgewählte Playlist landen sie nur in der Sammlung.
  4. Über Aus Musiksammlung vorhandene Songs hinzufügen. Dabei werden die Audiodateien nicht erneut gespeichert. Mehrfache Verwendung desselben Songs ist möglich.
  5. Auf Windows Reihenfolge ziehen; auf iPhone und iPad sind die ↑ / ↓-Tasten der zuverlässige zusätzliche Weg.
  6. Über ⚙ pro Track einstellen: direkt weiter, automatische Pause in Sekunden oder manueller Start. Die Einstellung betrifft den Übergang nach diesem Track. Nach dem letzten Track endet die Playlist.
  7. Für Meditation das Häkchen setzen und Gelb-/Rot-Grenzen in Sekunden Restzeit wählen. Es gilt: 0 ≤ Rot < Gelb < Songdauer. Bei kurzen Songs kleinere Werte verwenden.
  8. Optional Coaching-Hinweise speichern: eine Zeile pro Hinweis, zum Beispiel 00:30 Schultern locker. Ein Hinweis erscheint 12 Sekunden und folgt der Audio-Position.
  9. Unter Einstellungen Vorlauf festlegen, beispielsweise 5 Sekunden. Mit Kurs starten beginnt der Kursmodus.

Kategorien und Playlists lassen sich umbenennen und duplizieren. Ein Song wird über × nur aus der Playlist entfernt. Unter Einstellungen → Musiksammlung kann er nach Bestätigung endgültig vom Gerät und aus sämtlichen verwendenden Playlists gelöscht werden.

Kursmodus und Meditation

Bildschirm und Akku

Die App fordert einen Screen Wake Lock für den gesamten aktiven Kursmodus an. Dazu gehören Musik, Vorlauf, automatische Pausen, manuelle Pausen und vorübergehendes Pausieren.

„Bildschirm wird wach gehalten“ erscheint nur nach erfolgreicher Freigabe durch das Gerät. Bei Ablehnung oder Freigabe durch das System erscheint ein Hinweis. Die Statuszeile lässt sich antippen, um erneut anzufragen. Beim Zurückkehren zur sichtbaren App wird automatisch erneut angefragt.

Ein Wake Lock verhindert weder das Drücken der Sperrtaste noch alle systembedingten Unterbrechungen. Energiesparmodus oder niedriger Akku können die Anfrage verhindern. Bleibt Wachhalten nicht verfügbar, die automatische Sperre in den Geräte-Einstellungen für den Kurs passend einstellen und danach zurückstellen.

Die App kann die echte Gerätehelligkeit nicht ändern. Stelle sie vor dem Kurs im Kontrollzentrum niedrig, aber noch lesbar ein. Die schwarze Kursoberfläche reduziert helle Bildflächen. Nutze die Lautstärketasten des Geräts, falls Safari die interne Lautstärkeregelung nicht übernimmt.

Flugzeugmodus und Hintergrund

Musik und App-Dateien werden lokal gespeichert. Für Einrichtung, Import aus noch nicht heruntergeladenen Cloud-Dateien und Updates brauchst du Internet. Danach den Offline-Neustart ausdrücklich testen.

Wenn du Bluetooth-Lautsprecher nutzt, Bluetooth nach Aktivieren des Flugzeugmodus wieder einschalten. Prüfe vor dem Kurs den richtigen Audioausgang.

Die App nutzt ein einziges HTML-Audioelement, die Media Session API soweit verfügbar und den AudioSession-Typ „playback“ soweit unterstützt. Ein laufender Song kann im Hintergrund weiterlaufen; das ist auf deinen Geräten noch nicht verifiziert. Direkte Trackwechsel werden versucht, aber nicht garantiert.

Countdowns werden beim Verlassen der sichtbaren App pausiert. Dies gilt für Vorlauf und automatische Übergangspausen. Im Hintergrund erkannte Übergänge mit Wartezeit gehen in „Wartet auf deinen Start“. Beim Zurückkehren ist ein bewusster Start erforderlich. Diese Version erfüllt damit keine Garantie für automatische Pausen bei gesperrtem Bildschirm. Sie priorisiert den sichtbaren Kursmodus.

Safari kann den ersten Songstart nach einem Vorlauf blockieren. Dann erscheint ein Hinweis; erneut auf Play tippen. Wenn das auf deinem Gerät auftritt, den Vorlauf auf 0 setzen und selbst herunterzählen. Prüfe es vor dem Einsatz, nicht während des Kurses.

Nach Neuladen oder Beenden der App werden Sammlung und Einstellungen wiederhergestellt, aber die Musik startet niemals von selbst. Ein laufender Kurs wird nicht automatisch rekonstruiert.

Backups und Gerätespeicher

Updates

App-Dateien werden als geschlossener Satz zwischengespeichert. Ein wartendes Update löst kein Neuladen während eines aktiven Kurses aus. Beende den Kursmodus und installiere es unter Einstellungen. Für eigene Updates die neue fertige ZIP im bestehenden Cloudflare-Pages-Projekt über Create a new deployment hochladen. Den Hosting-Link beibehalten. Bei Änderungen am Quellcode vor einem neuen Release den Cache-Namen in sw.js und der Offline-Statusprüfung in app.mjs gemeinsam auf eine neue Version ändern, damit aktive Kurse ihre bisherige Version behalten.

Testliste vor dem ersten echten Kurs

Diese Tests auf jedem Gerät getrennt, mit installiertem Home-Bildschirm-Symbol und möglichst an der echten Studioanlage durchführen:

  1. Drei kurze MP3s importieren; App schließen und neu öffnen. Titel und Dateien bleiben erhalten.
  2. Vorlauf 5 Sekunden testen: startet der erste Track? Falls Safari blockiert, bewussten Play-Start und Vorlauf 0 testen.
  3. Direkten Übergang, 10 Sekunden automatische Pause und manuellen Start testen.
  4. Während jeder Pausenart und bei pausierter Musik länger als die eingestellte Auto-Sperrzeit warten. Wake-Lock-Status und sichtbaren Bildschirm prüfen.
  5. Während Vorlauf und Pause mehrfach Play antippen und Tracks überspringen. Es läuft immer nur ein Song.
  6. Meditationssong vor- und zurückspulen, pausieren, fortsetzen. Restzeit, Text und Farbe stimmen überein.
  7. Bedienung sperren, versehentliche Berührung simulieren, bewusst entsperren.
  8. Flugzeugmodus einschalten, App vollständig schließen und neu öffnen. Die Oberfläche erscheint, alle drei Dateien und Übergänge funktionieren offline.
  9. Testweise die Sperrtaste drücken: laufenden Track und einen direkten Trackwechsel beobachten. Ergebnis notieren. Automatische Pausen werden in dieser Version bewusst nicht unbeaufsichtigt im Hintergrund fortgesetzt.
  10. App wieder öffnen: Songposition und Zustand stimmen; ein unterbrochener Countdown startet nicht überraschend.
  11. Vollbackup erstellen, auf dem zweiten Gerät wiederherstellen, offline abspielen.
  12. Einen kompletten Probekurs in tatsächlicher Kurslänge durchführen. Erst danach im Unterricht einsetzen.

Technische Prüfung und Grenzen

Automatisierte Tests prüfen Zustandsübergänge, Mehrfachstarts, Pausen, Navigation, Meditationsgrenzen, Wake-Lock-Lebenszyklus, Backup-Validierung und Service-Worker-Verhalten mit simulierten Browser-APIs. Der aktuelle Bericht liegt im Quellcode-Paket unter PRUEFBERICHT.md.

Echte Safari-/Browser-Wiedergabe, Audioqualität, iPhone-/iPad-Energiesparverhalten, Bluetooth und ein vollständiger Offline-Neustart sind hier nicht praktisch geprüft. Es wurde kein nativer Apple-Build erzeugt. Verfügbarer Quellcode ersetzt keine Audio-Abnahme auf dem Gerät.

Quellen zur Plattform, geprüft am 14.10.2026