VideoRecorder

	Autor Script Version Symbolnummer	Thomas Schneider / Homepage VideoRecording.py / pyKey_Win.py / HTML-Hilfe-Datei 1.0 -	Zum Inhaltsverzeichnis Skript Handbuch

Video-Recording

Das Skript ist im Prinzip ein speziell auf Capella angepasster Bildschirm-Recorder. Es ist gedacht als Ergänzung zum Skript “Video_Vorbereitung” von Andreas Peier, lässt sich aber auch unabhängig davon benutzen.

• Die Bildschirm- und Ton-Aufnahme erfolgt über das ffmpeg-Framework
• Zusätzlich ist es möglich, halbautomatisch eine MP3-Datei entsprechend der Vorgaben des Scripts “Video_Vorbereitung” zu erzeugen, die dann anstatt der Lautsprecher-Ausgabe als Audio-Quelle verwendet werden kann.
• Das automatische Starten des Vorspiels bzw. der Aufruf des Dialogs zum MP3-Export erfolgt durch Simulation von Tastendrücken; dazu wurde das Python-Script pyKey von Gautham Venkataraman entsprechend angepasst.

Hinweis
Das Skript ist z.Z. nur unter Windows lauffähig.

Vorbereitung

• Die Bildschirm-Aufnahme erfolgt über das ffmpeg-Framework, d.h. dieses muss auf dem Rechner zur Verfügung stehen; es kann kostenlos über die Homepage der Entwickler heruntergeladen werden. Unter Windows ist eine explizite Installation nicht erforderlich: es genügt, die heruntergeladene gepackte Datei (.zip oder .7z) in ein beliebiges Verzeichnis zu entpacken.
• Das Python-Script pyKey_win.py zur Simulation von Tastendrücken muss sich im gleichen Verzeichnis wie das Script VideoRecording.py befinden!

Quickstart

Hinweis: Eine detaillierte Beschreibung des Skripts findet sich in der zugehörigen PDF-Datei.

• Optional: Vorbereitung der Partitur mit dem Script “Video-Vorbereitung”
• Script “VideoRecording” aufrufen
• Im Auswahldialog die (vorgewählte) Option “Video-Aufnahme” auswählen
  • Falls der Pfad zum ffmpeg-Framwork noch nicht eingetragen ist, erscheint ein Datei-Auswahl-Dialog, über den die Datei ffmpeg.exe ausgewählt werden muss. Der Pfad wird gespeichert, so dass dieser Schritt bei nachfolgenden Aufrufen des Skripts nicht mehr erforderlich ist.
• Die Default-Parameter im nachfolgenden Konfigurationsdialog sollten i.W. passend gesetzt sein, mit zwei Ausnahmen:

  • Im Feld “Audio-Konfiguration” muss im Ausklappfeld “Audio-Devices” die korrekte Audio-Quelle gewählt werden. In der Regel stehen hier zumindest 2 Audio-Geräte:

    • Das Mikrofon - hier im Beispiel: “Microphone array…”

    • Ein Audio-Ausgabegerät - hier im Beispiel: “Stereomix…” -, über das die Ton-Ausgabe auf die Lautsprecher erfolgt

      

    Letzteres sollte für die Aufnahme ausgewählt werden. Der Wert wird gespeichert und ist dann bei weiteren Aufrufen als Default gesetzt.

  • Im Feld “Aufnahme-Parameter” muss die “Aufnahmedauer” im entsprechenden Eingabefeld eingegeben werden, entweder als Zahl in Sekunden oder im Format HH:MM:SS;

    

    die entsprechende Angabe kann aus der Capella-Vorspielleiste entnommen werden.

• Mit “OK” wird automatisch die Aufnahme gestartet, und zwar
  • wird zunächst ffmpeg gestartet,
  • danach erscheint ein für die im Konfigurationsdialog unter “Vorspiel-Delay” eingestellte Zeit ein Hinweis-Fenster, das dann automatisch beendet wird,
  • dann startet automatisch das Capella-Vorspiel

Per Default wird eine Video-Datei im Format MP4 im gleichen Verzeichnis wie die Capella-Partitur erstellt und zwar mit dem gleichen Namen und angehängter Stimmbezeichnung entspr. der Konfiguration von “Video-Vorbereitung”, z.B.:

Partitur 1.capx --> Partitur 1_Sopran.mp4

Anmerkung: Ist keine Stimmbezeichnung vorhanden, dann steht am Ende des Dateinamens / vor der Datei-Endung “.mp4” nur der Unterstrich!

Versionsübersicht

• Version 1.0 - 27.8.2026
  • Erstes veröffentlichtes Release

Autor

Dipl.Inf. Thomas Schneider
Homepage: https://sys-thos.de