LA CULLA DEL CAOS - TAUH
========================

Il programma per i provini: salva in WAV i beat da YouTube e YouTube Music,
converte qualsiasi audio (anche le note vocali di WhatsApp) in MP3 o WAV e
trova BPM e tonalità di un beat, come Tunebat. Gratis, gira tutto sul tuo PC.

Nella cartella trovi:
- "Installa requisiti.bat"            da lanciare una volta sola
- "Crea collegamento sul desktop.bat" mette l'icona sul desktop
- "La Culla del Caos.pyw"             il programma con la finestra
- "Scarica WAV.bat"                   la versione da terminale, solo download
- scarica_wav.py, trova_bpm_chiave.py, interfaccia\   i file che usa


LA PRIMA VOLTA
1. Installa Python, in uno di questi due modi:
   - dal Microsoft Store: cerca "Python 3.13" (è gratis, di Python Software
     Foundation) e premi Installa;
   - oppure doppio clic su "Installa requisiti.bat", che installa Python e
     FFmpeg con winget. Se Windows avvisa che il file viene da internet,
     scegli "Ulteriori informazioni" e poi "Esegui comunque".
2. Riavvia il PC, così Windows trova i programmi appena installati.
3. Doppio clic su "Crea collegamento sul desktop.bat": sul desktop compare
   l'icona "La Culla del Caos" con il logo TAUH.
4. Apri La Culla del Caos dall'icona. La prima volta installa da solo quello
   che gli manca (FFmpeg per i WAV, yt-dlp e Deno per YouTube, numpy per BPM
   e chiave): ci vuole qualche minuto e serve la connessione.

ANTIVIRUS
Avast e AVG a volte mettono in quarantena "Installa requisiti.bat" come
"IDP.Generic": è un falso positivo (il file lancia solo winget, lo puoi aprire
con il Blocco note). Puoi ripristinarlo dalla quarantena e aggiungere la
cartella alle eccezioni, oppure saltarlo: installa Python dal Microsoft Store
e il resto lo fa il programma.


SE HAI GIÀ LA VERSIONE PRECEDENTE
Chiudi la finestra, estrai lo zip nella stessa cartella e sostituisci i
file. Il collegamento sul desktop e le tue scelte restano.


LA FINESTRA
Ha tre schede:
- SCARICA DA YOUTUBE: incolli i link, scegli la qualità, premi SCARICA e vedi
  l'avanzamento brano per brano. Sotto c'è il registro dei beat, con BPM,
  tonalità e i link per comprare la licenza.
- CONVERTI AUDIO: trasforma in MP3 o WAV qualsiasi file audio, anche le note
  vocali di WhatsApp, e prende l'audio dai video.
- BPM E CHIAVE: ti dice tempo e tonalità di un beat e riempie BPM e
  tonalità mancanti nel registro.

SCARICA DA YOUTUBE
- Incolla i link, uno per riga, oppure trascina nel riquadro un file .txt.
  Ctrl+Invio fa partire il download.
- Scegli frequenza e bit (come il progetto nella DAW) e, se vuoi, un'altra
  cartella: le scelte restano salvate per la volta dopo.
- Premi SCARICA. "Annulla" ferma tutto.
- Nel registro: "Licenza" apre il negozio del produttore (BeatStars, Airbit,
  ecc.), "Video" apre YouTube, "Mostra file" apre la cartella sul WAV.


CONVERTI AUDIO
- Trascina i file nella finestra, anche una cartella intera, oppure premi
  "Scegli file". Vanno bene le note vocali e gli audio di WhatsApp (.opus,
  .ogg, .waptt, .m4a, .aac), MP3, WAV, M4A, FLAC, WMA, AIFF, AMR e altri; dai
  video (.mp4, .mov, .mkv...) prende solo l'audio. Puoi anche copiare i file
  in Esplora risorse e premere Ctrl+V nella finestra.
- Le note vocali di WhatsApp: salvale prima sul PC (da WhatsApp per Windows
  o da WhatsApp Web) e poi trascinale qui. Non serve rinominarle.
- Scegli MP3 (320, 192 o 128 kbps) oppure WAV (44,1 o 48 kHz, 16 o 24 bit).
  Per lavorarci in FL Studio scegli WAV.
- Premi CONVERTI. I file finiscono in Musica\Convertiti ("Cambia" per
  un'altra cartella). Gli originali restano come sono; se un file con lo
  stesso nome c'è già, il nuovo prende un numero, ad esempio "Nota (2).wav".
- "Converti di nuovo" rifà i file già convertiti col formato scelto adesso:
  così puoi avere sia il WAV sia l'MP3.
- A destra ci sono i file della cartella dei convertiti, i più recenti in
  alto, con "Mostra file".

Converte tutto sul tuo PC con FFmpeg: niente viene caricato su internet.


BPM E CHIAVE
- Trascina un beat (o più) nella scheda, oppure premi "Scegli file": parte
  da solo. Per ogni file vedi il tempo in BPM, la tonalità (per esempio
  "Fa# minore", F#m, Camelot 11A per i mix), la relativa e una seconda
  ipotesi. "Copia" mette tutto negli appunti.
- La prima volta installa da solo numpy (serve al calcolo, circa un minuto,
  ci vuole internet).
- Nel registro dei beat, i beat senza BPM o tonalità hanno il tasto
  "Trova BPM e chiave": analizza il WAV e scrive il risultato nel registro.
  Se ne mancano tanti, il tasto "BPM mancanti" in alto li fa tutti.
- È una stima: 80 e 160 BPM sono lo stesso beat (il programma mostra
  entrambi), e una tonalità minore ha le stesse note della sua maggiore
  relativa. Nei dubbi fidati dell'orecchio, o di quello che scrive il
  produttore.


DOVE FINISCONO I WAV
Nella cartella Musica, sottocartella "Beat per provini", con nome
"Artista - Titolo.wav". Lì c'è anche registro_beat.csv, che si apre con
Excel. I link già scaricati vengono saltati. Di una playlist scarica tutto
solo se incolli il link della playlist.


SENZA FINESTRA
"Scarica WAV.bat" è la versione da terminale: incolla i link, uno per riga,
e premi Invio su una riga vuota. Trascinando sul .bat un file .txt con un
link per riga scarica quelli. In cima a scarica_wav.py puoi cambiare
cartella, frequenza e bit di base.


CHIUDERE
Chiudendo la finestra si chiude anche il programma; se sta scaricando o
convertendo, prima finisce.


SE QUALCOSA NON VA
- YouTube cambia spesso: se un download non va, chiudi e riapri il
  programma, che controlla se c'è una versione nuova di yt-dlp.
- "Non trovo scarica_wav.py": i file non sono nella cartella giusta. Spostali,
  oppure premi "Indica la cartella" e scegli la cartella La Culla del Caos.
- Sotto ogni brano o file con errore c'è la spiegazione. Nella scheda
  Scarica, "Dettagli tecnici" mostra tutto quello che ha scritto
  scarica_wav.py.
- Se la finestra non si apre, da un terminale nella cartella:
      py "La Culla del Caos.pyw"
  e guarda il messaggio. I messaggi del programma restano anche in
  %LOCALAPPDATA%\ScaricaWAV\interfaccia.log


Il calcolo sta in trova_bpm_chiave.py, che si usa anche da solo da terminale:
    py trova_bpm_chiave.py "beat.wav"

Font: Cinzel e Montserrat (licenza SIL OFL, file nella cartella
interfaccia\font) e Who asks Satan di Font Monger, gratis per uso personale.

I beat scaricati sono per i provini: prima di pubblicare un pezzo, compra la
licenza dal produttore (nel registro c'è il link).

Problemi o idee? Scrivimi su Instagram: @tauh616