huangyaling658-creator/music-mv

Was macht music-mv?

🎵 Skill für Lyrik-synchronisierte Musikvideos – Erstelle mit einem Befehl aus Song, Lyrics und Hintergrund ein untertitelbasiertes Musik-MV | Claude Code Skill für Lyrik-synchronisierte Musikvideos

• Quelle: https://github.com/huangyaling658-creator/music-mv
• GitHub-Sterne: 0
• Letzter Push: 2026-06-16T09:33:05Z
• Hinzugefügt von Awesome Skills täglichem Skill-Hunter am 2026-06-16.

📋 Voraussetzungen

• Claude Code (Desktop-Terminal) installiert
• ffmpeg und Python 3.8+ im System verfügbar (ffmpeg -version prüfen)
• Internetverbindung zum Herunterladen von Songs und Textdateien

🚀 Verwendung

Basisbefehl

claude music-mv "Songtitel" "Textdatei.srt" [Optionen]

Beispiele

1. Einfaches MV erstellen:

   claude music-mv "https://example.com/song.mp3" "https://example.com/lyrics.srt"
   

2. Mit Hintergrundbild:

   claude music-mv "song.mp3" "lyrics.srt" --background "hintergrund.jpg"
   

3. Benutzerdefinierte Auflösung und Stil:

   claude music-mv "song.mp3" "lyrics.srt" --resolution "1920x1080" --style "modern"
   

⚙️ Optionen

Option	Beschreibung	Standard
--background	Pfad oder URL zum Hintergrundbild/-video	Kein Hintergrund
--resolution	Ausgabeauflösung (z. B. 1920x1080)	1280x720
--style	Untertitel-Animationstil (klassisch, modern, bunt)	klassisch
--output	Ausgabedateiname	output_mv.mp4
--help	Hilfetext anzeigen	–

🛠️ Funktionsweise

1. Song & Lyrics laden – Der Skill lädt die bereitgestellte Audiodatei und die SRT-Textdatei herunter.
2. Audio-Konvertierung – Das Audio wird mit ffmpeg in ein Standbild-Video (standardmäßig schwarzer Hintergrund) umgewandelt.
3. Untertitel-Brenn – Die SRT-Zeitstempel werden gelesen, und jeder Textblock wird als Untertitel in das Video eingebrannt (mit optionalen Animationen).
4. Hintergrund hinzufügen – Falls ein Hintergrundbild angegeben ist, wird es als Underlay über die gesamte Videolänge gelegt.
5. Ausgabe – Das fertige Musikvideo wird als MP4-Datei im aktuellen Verzeichnis gespeichert.

📦 Abhängigkeiten

• ffmpeg – Audiokonvertierung, Videogenerierung und Untertiteleinbrennung
• Python 3 – Ausführung der Skripte (subtitle_burn.py, audio_to_video.py)
• requests (Python) – Herunterladen von Dateien

Installation der Python-Abhängigkeit:

pip install requests

📁 Projektstruktur

music-mv/
├── claude-skills.json        # Skill-Konfiguration
├── skills/
│   └── music-mv/
│       ├── SKILL.md          # Diese Datei
│       ├── scripts/
│       │   ├── audio_to_video.py    # Audio → Standbild-Video
│       │   ├── subtitle_burn.py     # SRT-Untertitel einbrennen
│       │   └── utils.py             # Hilfsfunktionen
│       └── assets/
│           └── example.lyrics.srt   # Beispiel-Textdatei

🧪 Beispiel für eine SRT-Datei

1
00:00:01,000 --> 00:00:04,000
Hallo Welt, dies ist Zeile eins.

2
00:00:05,000 --> 00:00:08,000
Zeile zwei des Textes.

📝 Hinweise

• Der Skill funktioniert lokal – es wird kein externer API-Dienst benötigt.
• Für beste Ergebnisse verwende eine synchronisierte SRT-Datei, die genau auf die Länge des Liedes abgestimmt ist.
• Falls das Hintergrundbild länger als das Video ist, wird es automatisch auf die Videolänge zugeschnitten.

🤝 Beitrag leisten

Verbesserungen, Fehlerbehebungen und neue Funktionen sind willkommen! Erstelle einfach einen Pull-Request im GitHub-Repository.

---

Erstellt von huangyaling658-creator – powered by Claude Code Skills