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)
- 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
.jsonper non rifare l'analisi. - 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.
- 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.
- Annotazioni (facoltative): scarica il modello CSV, aggiungi tag manuali (soggetto, scala, movimento, motivi, parti da escludere), ricaricalo.
- Genera: scegli il seme e quante varianti (semi consecutivi). Per ogni variante scarichi il
pacchetto
.zipo solo l'XML, e leggi il rapporto (densità obiettivo/risultato, distribuzioni, avvisi). Idea d'uso: lancia 8–12 semi e tieni quello che funziona. - 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)
- Nuovo progetto vuoto. Project Settings → Master Settings: 1920x1080, Timeline frame rate uguale
a
timeline.fpsdella configurazione (25 negli esempi). - Image Scaling → Mismatched resolution files: Scale entire image to fit (così il 4:3 resta con le bande).
- File → Import → Timeline, scegli il
.xml. Attiva «Automatically import source clips into media pool», lascia disattivato «Use sizing information». - Se Resolve chiede i media, indica la cartella delle clip.
- 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
- Importazione reale in Resolve non verificata (vedi sopra).
- Nel browser l'interlacciamento viene solo dai metadati, non da una rilevazione sul contenuto (che c'è nella versione a riga di comando con ffmpeg).
- Il browser non decodifica molti formati vecchi (DV, MPEG-2, AVI, alcuni .mov): per quelle clip luminosità, movimento e cambi di scena non vengono analizzati (lo dice un avviso) e contano solo metadati e tag manuali.
- Le copie conformate non si creano nel browser: serve
conforma.shsul Mac. - Il rilevamento automatico dei beat dal brano non c'è: la griglia è manuale (BPM, metro, offset, mappe di tempo). È una scelta: la griglia manuale è la funzione principale.
- I controlli di luminosità e lampeggiamento sono euristici: non certificano la sicurezza per la fotosensibilità.
- L'analisi di molte clip lunghe nel browser può richiedere minuti; il catalogo si può salvare.
Struttura e licenze
engine/motore Pythonritmocut(MIT), test, esempi, documentazione della bozza.web/interfaccia (HTML/JS statici),web/analyzer.jsanalisi delle clip nel browser.build.shcreadist/da pubblicare.- Librerie: Pyodide (MPL-2.0, da CDN), mediainfo.js / MediaInfoLib (BSD-2-Clause), JSZip (MIT o GPLv3, usata sotto MIT), marked (MIT).