Peytontalismanic424/paper-share-skills

Konvertiert Beamer-PDF-Folien in ein fehlergeschütztes, vertontes MP4-Video mit seitenausgerichteter Erzählung, TTS-Audio, Coverbild und Upload-Metadaten. Auslösbar durch Anfragen zu vertonten Folien, Folienvideos oder Papier-Ideen.

Was ist paper-share-skills?

Diese Fähigkeit verwandelt Beamer-PDF-Folien in ein professionelles MP4-Video mit seitenausgerichteter Erzählung. Sie nutzt Text-to-Speech (TTS), um jede Folie zu vertonen, erzeugt ein Coverbild und sammelt Metadaten für den Upload. Das Tool ist besonders nützlich für die Erstellung von Videovorträgen oder Erklärungen zu wissenschaftlichen Arbeiten. Es unterstützt den gesamten Arbeitsablauf: von der Planung der Erzählung über die Generierung von Audio bis hin zur finalen Montage. Der strikte Ablauf (fail-closed) stellt sicher, dass nur vollständige und fehlerfreie Videos erzeugt werden. Die Fähigkeit erfordert externe Werkzeuge wie pdftoppm, ffmpeg, ffprobe und edge-tts. Die Eingabe erfolgt über ein annotiertes LaTeX-Dokument, in dem für jede Seite eine Erzählung definiert wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/Peytontalismanic424/paper-share-skills/tree/HEAD/paper-slides-to-video

Dokumentation

Papierfolien zu Video

Der öffentliche Einstiegspunkt ist:

<FERTIGKEITEN_VERZ>/papierfolien-zu-video/scripts/folien_zu_video.py

Ausführung mit der Paketumgebung:

uv run --project <FERTIGKEITEN_VERZ>/papierfolien-zu-video python <FERTIGKEITEN_VERZ>/papierfolien-zu-video/scripts/folien_zu_video.py <Unterbefehl>

Exakte CLI

render PDF FOLIEN_VERZ [--dpi 200]
plan TEX
narrations FOLIEN_VERZ TEX --annotated-tex ANNOTIERTES_TEX
tts FOLIEN_VERZ [--lang zh]
assemble FOLIEN_VERZ AUSGABE [--pad-sek 0.5] [--speed 1.25]
cover ERSTE_FOLIE AUSGABE
metadata TEX COVER AUSGABE
full PAPIER_VERZ --annotated-tex ANNOTIERTES_TEX

Erforderlicher vollständiger Arbeitsablauf

Kompilieren Sie slides-beamer/main.pdf vor dem Aufruf dieses Pakets.
Kopieren Sie slides-beamer/main.tex nach video/main_with_narration.tex und fügen Sie für jede gerenderte physische Seite eine nicht leere % NARRATION:-Annotation hinzu. Diese Pro-Physische-Seite-Vereinbarung hält Hoch- und Querformat-Renderings synchron: Beide Orientierungen werden aus denselben PDF-Seiten zusammengesetzt, daher gelten die Erzähl-/Audio-Kardinalitätstüren gleichermaßen für jede Orientierung.
Führen Sie full mit dem Pfad des annotierten TeX aus.

uv run --project <FERTIGKEITEN_VERZ>/papierfolien-zu-video python <FERTIGKEITEN_VERZ>/papierfolien-zu-video/scripts/folien_zu_video.py full "<PAPIER_VERZ>" --annotated-tex "<PAPIER_VERZ>/video/main_with_narration.tex"

full entfernt vor der Verarbeitung alle veralteten vertonten Ausgaben. Es erfordert exakte PNG/TXT/MP3-Kardinalität, nicht leere Erzählungen und Audiodateien, prüfbare positive Audiodauern und eine zusammengesetzte MP4-Datei mit sowohl Video- als auch Audiostreams. Eine fehlende Erzählung oder MP3-Datei führt zu einem Exit-Code ungleich Null und kann kein vertontes Ergebnis hinterlassen.

Werkzeugerkennung

PDFTOPPM oder POPPLER_VERZ (Verzeichnis mit pdftoppm), dann PATH
FFMPEG, dann PATH
FFPROBE, dann PATH
EDGE_TTS_BIN, dann PATH

Stille wird niemals implizit angenommen. Programmatische Aufrufer können eine absichtlich stille Seite nur durch Aufruf von encode_slide(..., require_audio=False) erzeugen. Die öffentliche Voreinstellung ist require_audio=True.

Ausgaben werden unter <PAPIER_VERZ>/video/ geschrieben: video_frames/, <papier>_narrated.mp4, cover.png, frames_data.json, narrations.json und video_meta.json.