Spotitag

Easily tag your MP3 files with rich, accurate metadata straight from Spotify.

✨ What is Spotitag?

Spotitag scans your music library and updates MP3 metadata (title, artist, album, artwork, etc.) using Spotify’s database — so your collection looks clean and organized.

---

🚀 Quick Start

1. undefinedRegister a Spotify API Clientundefined

   • Go to Spotify Developer Dashboard.
   • Create a new application and take note of your Client ID and Client Secret.

2. undefinedDownload Spotitagundefined

   • Grab the latest .zip or .tar from the releases page.
   • Extract the files to your preferred location.

3. undefinedRun Spotitagundefined

   • undefinedmacOS/Linux: run bin/spotitag
   • undefinedWindows: run bin/spotitag.bat

4. undefinedConfigure Spotify Credentialsundefined

   • Open Spotitag → File > Settings
   • Enter your Client ID and Client Secret.

5. undefinedTag Your Music 🎶

   • Select a folder containing MP3s.
   • Click Scan and watch your tags update.

---

🛠 Features

• undefinedSkip identical files — Saves time by ignoring already-matching tracks.
• undefinedCustom property exclusions — Ignore specific metadata fields when comparing.
• undefinedDuration-based matching — Ensures accurate song matching.
• undefinedCaching — Faster rescans and less API usage.

---

📚 References & Credits

• undefinedLibrary: spotify-web-api-java
• undefinedInspired by:undefined
  • radusuciu/id3spot
  • FutureSharks/spotify-m3u-import
  • louiefb/integrating-local-music-library-to-spotify