akomlik/find-music

Live-Browser & Lokaler Pool Musik-Matcher (/find-music)

Zweck

Implementiert den "Musik für Video Workflow" und das Anti-Monotonie & Pflicht-Musik-Nicht-Wiederverwendungs-Gesetz:

1. Null Musik-Wiederverwendung Zwischen Projekten: Jedes Video muss eine einzigartige Klanglandschaft haben. Tracks, die in vergangenen Projekten verwendet wurden (04_Project_Catalog/*/Storyboard.md und .fcproj), werden automatisch ausgeschlossen.
2. Online-Suche Pflicht Bis Lokaler Pool $> 100$ Titel: Da kleine lokale Pools zu sich wiederholenden Soundtrack-Entscheidungen führen, fragen /find-music und /storyboard frische lizenzfreie Tracks aus dem CreatorMix Direct Online Catalog (fetch_creatormix_catalog.py) und der YouTube Studio Audio Library ab, bevor sie einen vorhandenen lokalen Track wiederverwenden.
3. Reibungsloses Direktes CDN-Abrufen: Statt manuelle Browsernavigation für jeden Song zu erfordern, fragt fetch_creatormix_catalog.py 134+ urheberrechtsfreie Tracks direkt über 21 Alben ab, filtert nach < 3:00 Dauer und lädt sie direkt über CDN-Stream-URLs in 03_Audio_Library/01_Curated_BGM/<Kategorie>/[BPM]_[Mood]_[TrackName]_[Artist].mp3 herunter!

Verzeichnis- & Taxonomie-Standard

Alle gespeicherten Tracks befinden sich in 03_Audio_Library/01_Curated_BGM/:

• 01_Rolling_Cadence/ — 110–125 BPM: Gleichmäßiges Treten, flache Straßen, Küstenwege
• 02_Scenic_Wonder/ — 80–105 BPM Ambient / Melodisch: Weite Panoramen, Gipfel, Regenbögen, Küstenwanderungen
• 03_Punchy_Climbs/ — 120–140 BPM Uptempo / Treibend: Fahrten außerhalb des Sattels, schnelle Abfahrten
• 04_Warm_Social_And_Retro/ — 75–115 BPM Akustik / Bossa / Café / Retro: Marktbesuche (SaPobla_Market_Trip), Café-Pausen, Partys und 1977+ / 1980–1984 Archiv-Diashows
• 05_Short_Transitions/ — 15–30s Stinger, komödiantische Riffs, kurze Intros

Dateinamenformat: [BPM]_[Mood]_[TrackName]_[Artist].mp3
(Beispiele: 118bpm_ChillBeat_CircuitRush_TheMiniVandals.mp3, 085bpm_WarmChillhop_BubbleGum_Creatormix.mp3)

Schritt-für-Schritt-Ausführungsablauf

Schritt 1: Clip-Bewegungsprofil & Dauer Analysieren

1. Lies <projektverz>/Storyboard.md und <projektverz>/project_manifest.json (oder inspiziere den Zielvideoclip).
2. Bestimme die Zielvideodauer (Regel: < 3:00) und die Szenenphasen (z. B. 01_Rolling_Cadence $\rightarrow$ 04_Warm_Social_And_Retro).
3. Scanne vergangene Projekte in 04_Project_Catalog/, um die Liste der ausgeschlossenen (bereits verwendeten) Tracks zu erstellen.

Schritt 2: Frische Musik Besorgen (Direkt CreatorMix CLI oder YouTube Studio Browser)

Option A: Direkte CreatorMix Online-Suche & Auto-Download (Sofort, Null Browser-Reibung)

Führe fetch_creatormix_catalog.py mit deinem gewünschten Genre oder Suchbegriffen aus:

# Suche nach frischen, nie verwendeten Tracks in einem bestimmten Genre:
python3 ./.agents/skills/find-music/scripts/fetch_creatormix_catalog.py --genre chillhop --max-duration 180

# Lade den Gewinner-Track herunter (z. B. Kandidat #2):
python3 ./.agents/skills/find-music/scripts/fetch_creatormix_catalog.py --genre chillhop --download-idx 2

Das Skript lädt die hochwertige MP3 direkt vom CreatorMix CDN herunter, formatiert sie mit der Standard-Konvention [BPM]_[Mood]_[TrackName]_Creatormix.mp3, verschiebt sie in 03_Audio_Library/01_Curated_BGM/<Kategorie>/ und aktualisiert automatisch music_catalog.json!

Option B: YouTube Studio Audio Library Browser-Tab (studio.youtube.com)

Wenn nach bestimmten ambienten oder Vintage-Stimmungen in der YouTube Audio Library gesucht wird:

1. Verbinde dich über chrome-devtools oder /browser mit deinem offenen YouTube Studio-Tab.
2. Wende Filter an: Dauer < 3:00, Genre (Dance & Electronic, Ambient, Folk & Acoustic), Stimmung (Inspirational, Happy, Calm).
3. Lade den Track in ~/Downloads herunter und führe save_music_track.py aus, um ihn automatisch zu taggen und zu verschieben:

   python3 ./.agents/skills/find-music/scripts/save_music_track.py \
     --source latest \
     --bpm 118 \
     --mood "ChillBeat" \
     --title "Circuit Rush" \
     --artist "The Mini Vandals" \
     --category "01_Rolling_Cadence" \
     --source-site "YouTube_Audio_Library"
   

Schritt 3: Dem Ersteller Bestätigen & Timeline-Platzierung Anbieten

Melde den neuen Track Alexander und biete an, ihn auf Spur A2 zu platzieren, über /swap-music, /magic-movie oder /build-cut-table.