VidCraft Konfiguration

VidCraft konfigurieren: config.yaml mit Pfaden und Sprechtempo, welche Einstellungen wirklich ausgewertet werden, Projekt- und Dateistruktur sowie Frontmatter-Felder für Projekt, Episode und Szene.

VidCraft Konfiguration

English Version

Zurück zur Übersicht

Konfigurationsdatei

VidCraft liest ~/.vidcraft/config.yaml. Die Datei entsteht durch /vidcraft:setup aus der Vorlage config/config.example.yaml; mit /vidcraft:configure pflegst du sie interaktiv. Fehlt die Datei, verwendet der MCP-Server eingebaute Standardwerte. Werte aus der Datei überschreiben die Standardwerte Schlüssel für Schlüssel.

paths:
  content_root: "~/video-projects"
  video_root: "~/video-projects/videos"
  assets_root: "~/video-projects/assets"
  overrides: "~/video-projects/overrides"

defaults:
  language: ["de", "en"]
  wpm: 140
  platform: "heygen"

heygen:
  default_avatar: ""
  default_voice: ""

synthesia:
  default_avatar: ""
  default_voice: ""

brand:
  name: ""
  primary_color: ""
  secondary_color: ""
  font: ""
  tone: ["professional", "friendly"]

Pfade dürfen ~ und Umgebungsvariablen enthalten.

Was ausgewertet wird

Schlüssel	Wirkung
`paths.content_root`	Wurzel aller Projektdateien (Markdown). Projekte liegen unter `{content_root}/projects/`, Ideen in `{content_root}/IDEAS.md`. Dateioperationen und die Dokument-Analyse des MCP-Servers sind auf dieses Verzeichnis beschränkt.
`paths.video_root`	Ziel für fertige Videodateien, aufgelöst als `{video_root}/projects/{projekt}`.
`paths.assets_root`	Ziel für Screenshots und Bilder, aufgelöst als `{assets_root}/projects/{projekt}`.
`defaults.wpm`	Wörter pro Minute für die Dauer-Schätzung der Pre-Generation-Gates. Standard: 140.

Die übrigen Schlüssel der Vorlage (paths.overrides, defaults.language, defaults.platform, heygen.*, synthesia.*, brand.*) werden vom MCP-Server nicht ausgewertet. Sprache und Plattform eines Projekts stehen im Frontmatter der Projekt-README und werden beim Anlegen des Projekts gesetzt (Standard: de und heygen). Der Skill brand-checker liest Marken-Tonalität aus Projekt-README und Konfiguration.

Projektstruktur

Jedes Projekt ist ein Verzeichnis unter {content_root}/projects/. Der Slug entsteht aus dem Titel.

{projekt-slug}/
├── README.md              # Projekt-Metadaten (YAML-Frontmatter)
├── episodes/
│   └── 01-episode-slug/
│       ├── README.md      # Episode-Metadaten
│       ├── scenes/
│       │   ├── 01-intro.md
│       │   └── 02-schritt.md
│       └── assets/
├── assets/                # projektweite Assets
└── research/              # Quellen, Recherche

Weitere Dateien entstehen durch einzelne Skills, zum Beispiel brief.md, research/RESEARCH.md, research/AUDIENCE.md, episodes/.../assets/ASSETS.md, episodes/.../shot-list.md, promo/*.md und RELEASE.md. Siehe Skills.

Episoden-Verzeichnisse und Szenen-Dateien werden mit zweistelliger Nummer vor dem Slug angelegt.

Frontmatter

Der Status steckt im YAML-Frontmatter der Markdown-Dateien. Der MCP-Server liest daraus den Projektzustand.

Ebene	Felder
Projekt (`README.md`)	`title`, `slug`, `video_type`, `status`, `platform`, `language`, `target_audience`, `description`, `created`, `updated`
Episode (`episodes/*/README.md`)	`title`, `number`, `slug`, `status`, `duration_target`, `platform`, `avatar`, `description`
Szene (`scenes/*.md`)	`title`, `number`, `status`, `visual_type`, `duration`

Szenen-Inhalte stehen in den Abschnitten ## Narration, ## On-Screen Text, ## Visual Direction und ## Assets. Status-Werte erklärt die Seite Workflow.

Zustands-Cache

Aus den Markdown-Dateien baut der Server einen Cache unter ~/.vidcraft/cache/state.json. Die Abfrage-Tools lesen daraus. Neu angelegte oder von Hand geänderte Dateien erscheinen dort erst nach einem Neuaufbau: /vidcraft:session-start oder das Tool rebuild_state. Die Markdown-Dateien bleiben die maßgebliche Quelle. Mehr dazu unter Technik.