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:
+-
+
- Cartella output predefinita — dove vengono salvati tutti i download. +
- Credenziali Spotify (solo se vuoi scaricare da link Spotify) — vedi il bottone "Come ottenere le credenziali?" nella tab Impostazioni. +
- 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_tracksdentro 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.
+-
+
- Seleziona la cartella con i file audio. +
- Imposta la Soglia HQ (kbps) — i file con bitrate inferiore verranno riprocessati. Default 310 kbps. +
- (Opzionale) Spunta Includi sottocartelle per la scansione ricorsiva. +
- 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)
+-
+
- Dropdown Dispositivo: seleziona la sorgente. +
- Imposta una cartella output e (opzionale) un nome file. +
- Premi ● REC → registrazione, timer in tempo reale. +
- ◼ 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-2chSe 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)
+-
+
- Click icona altoparlante nella barra menu → Output → BlackHole 2ch +
- Fai partire Spotify (non sentirai nulla — l'audio va a BlackHole) +
- Tab Registra → dispositivo 🔄 BlackHole 2ch (loopback) → REC +
Setup B — completo (registri E senti l'audio)
+-
+
- Apri Configurazione MIDI Audio (
Applicazioni → Utility)
+ - In basso a sinistra: + → Crea dispositivo aggregato a uscita multipla +
- Spunta sia BlackHole 2ch sia i tuoi Altoparlanti integrati +
- Imposta BlackHole 2ch come Master Device (menu in alto) +
- Abilita Drift Correction sulla riga degli altoparlanti +
- (Opzionale) Rinomina in
Speakers + BlackHole
+ - Preferenze di Sistema → Audio → Uscita → seleziona
Speakers + BlackHole
+ - 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
+ +| Sintomo | Causa probabile | Fix |
|---|---|---|
| BlackHole non compare nel dropdown della tab Registra | +CoreAudio non l'ha ancora caricato dopo l'install | +sudo killall coreaudiod + premi ↻ Aggiorna |
+
| "Permesso microfono mancante" o errore ffmpeg -6 | +macOS nega l'accesso al device | +Privacy e sicurezza → Microfono → abilita Terminal/MusicTools | +
| File MP3 della registrazione è muto | +L'output di sistema non passa da BlackHole | +Imposta output su BlackHole o Multi-Output Device (Setup A/B) | +
| Spotify dice "Autenticazione fallita" | +Client ID/Secret mancanti o errati | +Impostazioni → Spotify API → ripeti la procedura | +
| Instagram/Facebook non scarica | +Contenuto privato senza cookies validi | +Esporta cookies.txt dal browser dopo login | +
| Brano scaricato è sbagliato (versione cover invece dell'originale) | +Ricerca YouTube ha preso il primo risultato | +Modifica la query nel file di tracklist (più dettagli artista/titolo) | +
| Tag non vengono letti su un WAV | +File usa solo chunk INFO non ID3 (raro) | +L'app ora gestisce entrambi — controlla di avere v1.2.1+ | +
| Stop button non risponde durante il download | +yt-dlp sta finalizzando il file | +Attendi qualche secondo, il processo si chiude dopo l'I/O | +
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
+