VidCraft Installation

VidCraft installieren: Plugin hinzufügen, /vidcraft:setup ausführen, optionale Werkzeuge (Whisper, ffmpeg), Aktualisierung und Deinstallation unter Linux, macOS und Windows.

VidCraft Installation

English Version

Zurück zur Übersicht

Voraussetzungen

Anforderung	Hinweis
Claude Code	Das Plugin läuft in Claude Code.
Python 3.10 oder neuer	Wird für den MCP-Server und die Dokument-Analyse benötigt.
HeyGen- oder Synthesia-Konto	Nur für die manuelle Generierung der Videos.
OpenAI Whisper und ffmpeg	Optional, nur für `/vidcraft:subtitle-generator`.

Schritt 1: Plugin hinzufügen

Laut README des Projekts:

claude plugin add vidcraft

Schritt 2: Setup ausführen

In Claude Code:

/vidcraft:setup

Der Setup-Skill erledigt der Reihe nach:

Er sucht einen funktionierenden Python-Interpreter (python3, python, danach py -3 unter Windows).
Er legt das Verzeichnis ~/.vidcraft/ an.
Er erstellt das Virtual Environment ~/.vidcraft/venv/, falls es fehlt.
Er installiert die Laufzeit-Abhängigkeiten aus requirements.txt. Das passiert bei jedem Aufruf, damit neue Abhängigkeiten nach einem Update nicht fehlen.
Er kopiert config/config.example.yaml nach ~/.vidcraft/config.yaml, falls die Datei noch nicht existiert. Eine vorhandene Konfiguration wird nicht überschrieben.
Er legt ~/.vidcraft/cache/ an.
Er prüft, ob der MCP-Server importiert werden kann.
Er startet /vidcraft:configure für deine persönlichen Einstellungen.

Installierte Python-Pakete: mcp[cli], pyyaml, pypdf, pdfplumber und python-docx.

Schritt 3: Konfigurieren und prüfen

Mit /vidcraft:configure legst du Content-Root, Plattform und Marke fest, siehe Konfiguration.

Mit /vidcraft:session-start prüfst du, ob der MCP-Server läuft, die Konfiguration passt und Projekte gefunden werden.

Der MCP-Server wird von Claude Code über bin/run-server gestartet und nutzt ausschließlich das Python unter ~/.vidcraft/venv/. Ohne dieses Environment startet der Server nicht. Dann hilft ein erneutes /vidcraft:setup.

Optional: Untertitel mit Whisper

Der Skill /vidcraft:subtitle-generator ruft das Kommandozeilen-Programm whisper lokal auf. Dafür brauchst du:

pipx install openai-whisper

Alternativ pip install openai-whisper. Außerdem muss ffmpeg installiert sein, zum Beispiel unter Debian/Ubuntu mit sudo apt install ffmpeg.

Windows

Der Repo enthält mit bin/run-server.cmd einen eigenen Startwrapper, der %USERPROFILE%\.vidcraft\venv\Scripts\python.exe verwendet. Der Setup-Skill erkennt Windows und probiert py -3, falls python nur der Microsoft-Store-Platzhalter ist.

Aktualisieren

Nach einem Plugin-Update führst du /vidcraft:setup erneut aus. Das synchronisiert die Abhängigkeiten im bestehenden Environment und lässt deine config.yaml unangetastet.

Deinstallieren

Plugin über die Plugin-Verwaltung von Claude Code entfernen.
Optional das Verzeichnis ~/.vidcraft/ löschen. Es enthält Virtual Environment, Konfiguration und Cache (cache/state.json).

Deine Projektdateien unter dem konfigurierten content_root bleiben bei beiden Schritten unberührt.