dargmuesli/spotitag
1
0
Fork 0
mirror of https://github.com/dargmuesli/spotitag.git synced 2025-12-08 23:10:37 +01:00
Code Issues Projects Releases Packages Wiki Activity
Tag mp3 files with data from Spotify.
228 commits 1 branch 2 tags 1.4 MiB
Find a file
Exact
renovate[bot] ec160abf3b
 chore(deps): update dependency org.apache.commons:commons-text to v1.15.0
2025-12-08 00:31:22 +00:00
.github/workflows chore(deps): update actions/setup-java digest to f2beeb2 2025-12-04 07:03:52 +00:00
.idea chore(gradle): update jdk to v21 2025-08-11 07:17:19 +02:00
docs/images [ImgBot] Optimize images 2022-06-28 19:41:20 +00:00
gradle/wrapper chore(deps): update all non-major dependencies 2025-11-18 03:11:20 +00:00
src/main fix(ui): handle null cases for directory chooser 2025-08-11 07:12:51 +02:00
.gitignore chore(git): ignore kotlin 2024-02-24 21:39:17 +01:00
.renovaterc chore(renovate): correct base branch 2025-08-01 00:20:26 +02:00
build.gradle chore(deps): update dependency org.apache.commons:commons-text to v1.15.0 2025-12-08 00:31:22 +00:00
gradlew chore(deps): update gradle to v9.1.0 2025-09-18 17:23:49 +00:00
gradlew.bat chore(deps): update gradle to v9.1.0 2025-09-18 17:23:49 +00:00
LICENSE feat: add license 2022-04-22 15:00:10 +02:00
README.md docs(readme): rework 2025-08-11 07:49:54 +02:00
settings.gradle chore(deps): switch back to org.openjfx.javafxplugin 2023-05-04 16:23:45 +02:00
spotitag.iml feat(git): update ignore file 2022-04-22 14:45:42 +02:00

README.md

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