Introduzione

MusicTools è una app desktop tutto-in-uno per chi lavora con la musica: scarica brani e video da decine di piattaforme, migliora la qualità dei file esistenti, modifica i tag/metadati e registra l'audio da qualsiasi ingresso del computer.

L'interfaccia è organizzata in 6 sezioni accessibili dalla barra laterale: ⬇ Scarica, 🎬 Video, ⚡ Upgrade, 🏷 Metadati, ● Registra, ⚙ Impostazioni.

Setup iniziale

Prima di usare l'app, conviene fare 3 cose nelle Impostazioni:

1. Cartella output predefinita — dove vengono salvati tutti i download.
2. Credenziali Spotify (solo se vuoi scaricare da link Spotify) — vedi il bottone "Come ottenere le credenziali?" nella tab Impostazioni.
3. cookies.txt (opzionale) — necessario solo per scaricare contenuti privati Instagram/Facebook o aggirare rate-limit YouTube. Esportalo dal browser con l'estensione "Get cookies.txt LOCALLY".

Tutti i campi vengono salvati automaticamente quando premi Salva Impostazioni.

Tab ⬇ Scarica

Scarica musica in MP3 al bitrate impostato in Impostazioni (default 320 kbps).

1 · Da Spotify

Incolla un link a una playlist, album o brano (es. open.spotify.com/playlist/...). L'app risolve i metadati via API Spotify e scarica i brani da YouTube. Richiede le credenziali API impostate.

2 · Da YouTube, SoundCloud e altri

Incolla qualsiasi URL supportato da yt-dlp (singolo video o playlist). Funziona anche con Bandcamp, Mixcloud, ecc.

3 · Lista da file .txt

Clicca 📂 Carica lista. Il file può contenere:

• Una URL per riga — l'app le scarica una dopo l'altra.
• Tracklist con titoli (es. Beatport Top 100): formato 1. Artista – Titolo (variant) (durata). L'app riconosce automaticamente il formato e cerca ogni brano su YouTube.

Nel caso tracklist, viene creata automaticamente una sottocartella col nome del file (es. Beatport Top 100.txt → Beatport Top 100/).

4 · Skip duplicati

Se riesegui la stessa playlist, i brani già scaricati vengono saltati in automatico. Il tracking funziona in due modi:

• File .downloaded_tracks dentro la cartella output.
• Scan dei file presenti, con match dei nomi token-per-token (ignora parole come "Official Video", "Lyrics", "HD"...).

Tab 🎬 Video

Scarica video da YouTube, TikTok, Instagram, Facebook e oltre 1000 altri siti supportati da yt-dlp.

Modalità

• 🎬 Video (MP4) — output video+audio in MP4, qualità a scelta (best / 1080p / 720p / 480p).
• 🎵 Solo audio (MP3) — estrae solo l'audio in MP3 al bitrate impostato in Impostazioni, con thumbnail embedded come copertina.

Contenuti privati

Per scaricare reel Instagram privati, post Facebook privati o aggirare rate-limit YouTube serve un file cookies.txt valido (formato Netscape). Esportalo dal browser e impostalo in Impostazioni → Percorsi.

Tab ⚡ Upgrade qualità

Scansiona una cartella e riscarica i file sotto la soglia kbps impostata, sostituendoli con la versione a qualità maggiore.

1. Seleziona la cartella con i file audio.
2. Imposta la Soglia HQ (kbps) — i file con bitrate inferiore verranno riprocessati. Default 310 kbps.
3. (Opzionale) Spunta Includi sottocartelle per la scansione ricorsiva.
4. Premi Avvia Upgrade.

Per ogni file l'app cerca la versione migliore su YouTube e la sostituisce mantenendo nome originale. I file già processati vengono saltati grazie al tracking .upgraded_tracks.

Tab 🏷 Metadati

Editor completo dei tag audio. Apri un file con 📂 Apri file audio.

Formati supportati

• MP3 — ID3v2.3
• M4A / AAC / MP4 — Apple atoms
• FLAC — Vorbis comments
• WAV — ID3 embedded + fallback al chunk RIFF LIST/INFO (per file taggati da ffmpeg/Audacity)

Campi editabili

Titolo, artista, album, album artist, anno, traccia (formato 1/12), genere, BPM, key musicale, commento, copertina (JPG/PNG), e su macOS anche kMDItemWhereFroms (l'extended attribute che traccia l'origine del file scaricato).

Copertina

Anteprima 180×180 della copertina corrente. Cambia copertina ne carica una nuova; Rimuovi la marca per la rimozione al prossimo salvataggio.

Annulla modifiche

Premi ↺ Ricarica per rileggere i tag dal file e scartare le modifiche non salvate.

Tab ● Registra

Cattura audio in MP3 da qualsiasi ingresso del computer: mixer, scheda audio esterna, microfono, driver loopback (BlackHole/Soundflower/VB-Cable). Bitrate selezionabile 128–320 kbps.

Setup standard (mixer/microfono)

1. Dropdown Dispositivo: seleziona la sorgente.
2. Imposta una cartella output e (opzionale) un nome file.
3. Premi ● REC → registrazione, timer in tempo reale.
4. ◼ Stop → file MP3 finalizzato e linkato sotto.

Registrare l'audio di sistema su macOS (Spotify, YouTube...)

macOS non espone nativamente l'uscita audio. Serve un driver loopback gratuito, il più diffuso è BlackHole.

Installazione

Apri Terminale e lancia:

brew install blackhole-2ch

Se subito dopo l'install BlackHole non compare nel dropdown, riavvia il servizio audio:

sudo killall coreaudiod

(rilancia da solo in pochi secondi, nessun rischio)

Permesso microfono

macOS richiede il permesso "Microfono" per leggere da BlackHole via AVFoundation. Vai su Preferenze di Sistema → Privacy e sicurezza → Microfono e abilita Terminal/MusicTools. Se la voce non c'è, comparirà un popup la prima volta che premi REC.

Setup A — minimo (non senti l'audio durante)

1. Click icona altoparlante nella barra menu → Output → BlackHole 2ch
2. Fai partire Spotify (non sentirai nulla — l'audio va a BlackHole)
3. Tab Registra → dispositivo 🔄 BlackHole 2ch (loopback) → REC

Setup B — completo (registri E senti l'audio)

1. Apri Configurazione MIDI Audio (Applicazioni → Utility)
2. In basso a sinistra: + → Crea dispositivo aggregato a uscita multipla
3. Spunta sia BlackHole 2ch sia i tuoi Altoparlanti integrati
4. Imposta BlackHole 2ch come Master Device (menu in alto)
5. Abilita Drift Correction sulla riga degli altoparlanti
6. (Opzionale) Rinomina in Speakers + BlackHole
7. Preferenze di Sistema → Audio → Uscita → seleziona Speakers + BlackHole
8. Nella tab Registra: scegli 🔄 BlackHole 2ch (loopback), non il dispositivo aggregato

Impostazioni

Spotify API

Le credenziali API Spotify sono gratuite e non richiedono Premium. Vai su Spotify Developer Dashboard, "Create app", compila i campi (Redirect URI http://localhost:8888/callback, seleziona "Web API"), e copia Client ID + Client Secret nei campi corrispondenti.

Download

• Bitrate — qualità target per gli MP3 (128/192/256/320 kbps).
• Soglia HQ — soglia kbps per la tab Upgrade. I file sotto questa soglia vengono riscaricati.

Percorsi

• cookies.txt — per contenuti privati/protetti.
• Cartella output predefinita — viene proposta in tutte le tab.

Aggiornamenti

In Impostazioni → Aggiornamenti trovi il bottone Controlla aggiornamenti. L'app interroga la pagina release di GitHub e ti mostra se c'è una versione nuova.

Se è disponibile un aggiornamento, comparirà un secondo bottone Scarica aggiornamento che apre direttamente il browser sull'asset corretto (macOS o Windows) della release più recente.

Troubleshooting

Reset configurazione

Se vuoi azzerare tutte le impostazioni, cancella il file config.json. Posizione:

• macOS: ~/Library/Application Support/MusicTools/config.json
• Windows: %APPDATA%\MusicTools\config.json

Verrà ricreato con valori di default al prossimo avvio.

Risorse

• Codice sorgente su GitHub
• Tutte le release
• FAQ di yt-dlp
• BlackHole — driver loopback macOS

MusicTools — by LuZa