Montaggio procedurale — ritmocut web

Sito: https://montaggio-procedurale.pages.dev

Genera un premontaggio a tempo di musica e lo esporta come timeline modificabile per DaVinci Resolve gratuito (FCP7 XML). Non produce un video: in Resolve ogni inquadratura resta una clip separata, con la sua durata già a tempo, che puoi spostare, accorciare o sostituire.

Il motore è la bozza ritmocut (Python, solo libreria standard), riusata così com'è e fatta girare nel browser con Pyodide. Le clip non vengono caricate da nessuna parte: il browser legge i metadati (mediainfo.js) e campiona luminosità e movimento in locale. Gli originali non vengono mai modificati.

Uso dal sito (6 passaggi)

  1. Clip: scrivi il percorso della cartella delle clip sul Mac (Finder → tasto destro sulla cartella, tieni premuto Option → «Copia … come percorso»), poi «Scegli la cartella» e «Analizza». Il percorso serve perché la timeline punti ai file giusti in Resolve. Il catalogo si può salvare in .json per non rifare l'analisi.
  2. Griglia e BPM: tabella BPM–fps (ad esempio quali BPM vicini a 145 danno crome e semicrome su fotogrammi interi). Il brano è facoltativo: la griglia manuale funziona anche senza musica.
  3. Configurazione: carica l'esempio semplice o articolato (entrambi 4:30), modifica il TOML. I campi rapidi cambiano fps, BPM, politica d'aspetto (fit = bande, mai stirato) e cosa fare con frequenze diverse. «Anteprima del ritmo» mostra il piano dei tagli senza clip.
  4. Annotazioni (facoltative): scarica il modello CSV, aggiungi tag manuali (soggetto, scala, movimento, motivi, parti da escludere), ricaricalo.
  5. Genera: scegli il seme e quante varianti (semi consecutivi). Per ogni variante scarichi il pacchetto .zip o solo l'XML, e leggi il rapporto (densità obiettivo/risultato, distribuzioni, avvisi). Idea d'uso: lancia 8–12 semi e tieni quello che funziona.
  6. Rigenera una parte: riparti da un manifesto.json, rigenera solo alcune battute (es. 40-56) bloccando le inquadrature che ti piacciono (es. 1-3,12), mantenendo o no il ritmo.

Cosa contiene il pacchetto di una variante

<nome>.xml (timeline FCP7 XML per Resolve), <nome>.otio (alternativa OpenTimelineIO), <nome>_marcatori.edl (marcatori di sezioni/frasi/eventi), lista_montaggio.csv, rapporto.md, densita.svg, manifesto.json (per riprodurre o rigenerare), registro.log.

Se la configurazione usa fps_mismatch = "conform", il sito non può creare le copie conformate (serve ffmpeg): scarichi conforma.sh e lo lanci sul Mac (brew install ffmpeg, poi bash conforma.sh) prima di importare in Resolve. Con "native" si usano gli originali e Resolve adatta la frequenza.

Importazione in Resolve (gratuito)

  1. Nuovo progetto vuoto. Project Settings → Master Settings: 1920x1080, Timeline frame rate uguale a timeline.fps della configurazione (25 negli esempi).
  2. Image Scaling → Mismatched resolution files: Scale entire image to fit (così il 4:3 resta con le bande).
  3. File → Import → Timeline, scegli il .xml. Attiva «Automatically import source clips into media pool», lascia disattivato «Use sizing information».
  4. Se Resolve chiede i media, indica la cartella delle clip.
  5. Marcatori: Media Pool → tasto destro sulla timeline → Timelines → Import → Timeline Markers from EDL.

Verifica (da fare la prima volta):

controllo atteso
numero di clip (Edit Index) uguale alle righe di lista_montaggio.csv
durata della timeline come nel rapporto.md (circa 4:29–4:30)
clip offline nessuna
5–10 tagli presi dal CSV posizione in timeline = rec_in_tc, punto sorgente = src_in_tc
clip con timecode non nullo il frammento è quello giusto, non spostato di ore
4:3 e 16:9 4:3 con bande laterali, nessuna immagine stirata
audio nessun audio delle sorgenti, solo la musica se indicata
modificabilità ogni inquadratura si può tagliare, spostare, sostituire

Se i punti d'ingresso sbagliano solo sulle clip con timecode non nullo, prova il file .otio e segnalalo. Procedura completa: engine/docs/COLLAUDO_RESOLVE.md.

Importante: l'importazione reale in DaVinci Resolve non è stata provata. L'XML è validato solo strutturalmente (sintassi, tempi, assenza di buchi e sovrapposizioni). Un XML formalmente valido non garantisce un'importazione riuscita: va collaudato sul Mac.

Uso da riga di comando (facoltativo, sul Mac)

Lo stesso motore funziona anche senza browser, con ffmpeg per l'analisi completa (inclusa la rilevazione dell'interlacciamento) e la conformazione automatica:

brew install python ffmpeg
cd engine && python3 -m venv .venv && source .venv/bin/activate && pip install -e .
ritmocut bpm                          # tabella BPM–fps
ritmocut piano examples/semplice.toml --seme 3
ritmocut genera examples/semplice.toml --varianti 4
ritmocut rigenera examples/semplice.toml <uscita>/manifesto.json --battute 40-56 --blocca 1-3

Dettagli: engine/README.md, guida alla configurazione engine/docs/CONFIGURAZIONE.md.

Tabella BPM–fps intorno a 145

docs/TABELLA_BPM_FPS_145.md (generata dal motore). In breve: con crome e semicrome esatte, 150 BPM va bene a 30, 50 e 60 fps, 149,85 a 29,97 e 59,94; a 24/25 fps nessun BPM tra 135 e 155 è esatto. Tenendo 145 BPM ogni taglio è arrotondato dalla sua posizione assoluta: errore sempre sotto mezzo fotogramma, senza deriva (a 25 fps una semicroma dura 2 o 3 fotogrammi).

Test

cd engine && python3 -m unittest discover -s tests -t .

Coprono: calcolo razionale dei tempi, ricerca BPM, arrotondamento senza deriva, limiti delle sorgenti, assenza di buchi e sovrapposizioni, durata finale, riproducibilità con lo stesso seme, regioni bloccate, vincoli impossibili, timecode non nulli, validità strutturale di XML/OTIO/EDL, il ponte web (tests/test_web.py) e le mappe di tempo. I test che richiedono ffmpeg si saltano se manca. Il sito è stato provato end-to-end in Chrome headless (analisi di 9 clip miste 4:3/16:9 con timecode, tabella BPM, anteprima, 3 varianti, rigenerazione con blocchi).

Limiti noti

Struttura e licenze