Jonas Thelemann

spotitag

Tag mp3 files with data from Spotify.

6
1
6
Kotlin
public
View on GitHub

Spotitag

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

Spotitag Screenshot

✨ 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. Register a Spotify API Client

  2. Download Spotitag

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

  3. Run Spotitag

    • macOS/Linux: run bin/spotitag
    • Windows: run bin/spotitag.bat

  4. Configure Spotify Credentials

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

  5. Tag Your Music 🎶

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

🛠 Features

  • Skip identical files — Saves time by ignoring already-matching tracks.
  • Custom property exclusions — Ignore specific metadata fields when comparing.
  • Duration-based matching — Ensures accurate song matching.
  • Caching — Faster rescans and less API usage.

📚 References & Credits

v0.3.3[beta]