karmazin/simreel

Was macht simreel?

Nehmen Sie die echte App des Benutzers im iOS Simulator auf und schneiden Sie sie in zwei Dateien:

• reel-1080x1920.mp4: die Aufnahme in einem Telefonkörper auf einem Farbverlauf, eine Bildunterschrift pro Szene, eine Endkarte. Für X, Reels, TikTok, Product Hunt.
• appstore-preview-886x1920.mp4: die reine Aufnahme, für App Store Connect dimensioniert und codiert.

Alles läuft lokal mit Xcode und ffmpeg. Keine Konten, keine kostenpflichtigen APIs.

Regeln

• Zeigen Sie nur, was die App wirklich tut. Bildunterschriften beschreiben, was auf dem Bildschirm zu sehen ist; fügen Sie niemals Behauptungen, Zahlen oder Bewertungen hinzu, die das Filmmaterial nicht zeigt.
• Halten Sie private Daten aus dem Bild. Verwenden Sie einen frischen Simulator oder Demodaten, und prüfen Sie die Bilder, bevor Sie sie ausliefern.
• Berühren Sie nur den Simulator, den Sie verwenden sollen. Andere gestartete Simulatoren können zu jemand anderem Projekt gehören; übergeben Sie niemals booted, wenn mehr als einer läuft.
• Lehnen Sie Tracking- und Cookie-Abfragen während der Aufnahme ab, es sei denn, der Benutzer sagt etwas anderes.

Schritte

1. Simulator finden. xcrun simctl list devices booted. Wenn die App nicht installiert ist, bauen Sie sie mit den eigenen Werkzeugen des Benutzers und installieren Sie sie.
2. Einmal ohne Aufnahme durch die App gehen. Wählen Sie 3 bis 5 Momente aus, die die Hauptfunktionen zeigen. Löschen Sie jetzt Einführungs-, Berechtigungs- und Cookie-Dialoge, damit sie nicht im Take auftauchen.
3. Einen Take aufnehmen.

   scripts/record.sh start work/raw.mp4 <UDID>
   # App bedienen: Ihr Simulator-Tool, ein XCUITest im Projekt, oder den Benutzer bitten, durchzutippen
   scripts/record.sh stop <UDID>
   

   Halten Sie auf jedem Bildschirm, den Sie behalten möchten, etwa eine Sekunde inne. Wenn Tippen direkt nach dem Booten des Simulators fehlschlägt, warten Sie 20 Sekunden und versuchen Sie es erneut.
4. Take lesen. Die Datei endet mit der letzten Bildschirmänderung, sodass ein letzter, statischer Bildschirm abgeschnitten wird und ein Take eines Bildschirms, der sich nie ändert, fast leer ist. Zeitliche Szenen aus der Datei, nicht aus dem Gedächtnis.

   python3 scripts/compose.py frames work/raw.mp4 work
   

   Öffnen Sie work/contact-sheet.png: 8 Kacheln pro Zeile, Kachel N ist die Sekunde N.
5. storyboard.json schreiben.

   {
     "app_name": "MyApp",
     "background": ["#0B1020", "#3B2AA8"],
     "scenes": [
       {"start": 0.3, "end": 5.8, "caption": "Was dieser Bildschirm tut"},
       {"start": 8.0, "end": 10.0, "speed": 0.8, "caption": "Nächster Schritt"}
     ],
     "end_card": {"title": "MyApp", "subtitle": "Der eigene Slogan der App"}
   }
   

   start/end sind Sekunden in der Aufnahme. speed unter 1 verlangsamt eine Szene, über 1 beschleunigt sie. hold friert das letzte Bild der Szene für diese Anzahl von Sekunden ein – so können Sie auf einem Ergebnisbildschirm verweilen. background akzeptiert eine Farbe oder einen Farbverlauf von oben nach unten; text_color und caption_size sind optional. Lassen Sie end_card weg, um auf der letzten Szene zu enden. Schneiden Sie Ladespinner aus. Die Szenen müssen insgesamt 15–30 Sekunden ergeben, sonst lehnt App Store Connect die Vorschau ab.
6. Rendern.

   python3 scripts/compose.py render work/raw.mp4 storyboard.json out
   

   Es gibt out/report.json aus und warnt, wenn die Vorschaudauer außerhalb des Bereichs liegt.
7. Vor der Übergabe prüfen. Ziehen Sie ein Bild aus jeder Szene (ffmpeg -ss <t> -i out/reel-1080x1920.mp4 -frames:v 1 f.png) und sehen Sie es sich an: Bildunterschrift passt zum Bildschirm, nichts Privates, nichts abgeschnitten.

Hinweise

• Voraussetzungen: macOS, Xcode (für simctl und swift), ffmpeg, python3.
• record.sh setzt die Statusleiste auf 9:41 mit vollem Akku und Signal. Zurücksetzen mit xcrun simctl status_bar <UDID> clear.
• Die hier verwendeten App-Store-Vorschauzahlen (886x1920, 15–30 s, 30 fps, H.264 High 4.0, Stereo-AAC) stammen von Apples App-Vorschau-Spezifikationen. Überprüfen Sie diese Seite, falls ein Upload abgelehnt wird.
• Die Audiospur ist stumm. Fügen Sie bei Bedarf Musik oder Sprache in einem Editor hinzu.