🎵 Sherlock Tones

Sprint 3 Evaluation · JavaIsForMinecraft

📖 About the Project

Sherlock Tones automatically downloads lyrics and metadata for your local music library. It supports bulk processing of entire directories as well as per-song metadata editing and visualization. Features include exception folders/songs, a wide range of settings, conflict detection and resolution, and it even serves as a song organizer.

Java 21 JavaFX Maven Hibernate H2 AcoustID API

👥 Team Members

Name	GitHub	Sprint 3 Hours (Actual)
Thomas Mugica	`Tmugica`	16.2h
Aitor Larramendi	`Aitorlarraa`	15.9h
Ekain Regil	`Ekain001`	14.0h
TOTAL		46.1h

📸 Application Screenshot

Sherlock Tones main window — music library scanner and metadata editor.

🔍 Sprint 3 Observations

Build: ✅ Clean build passes. Uses Maven download plugin to fetch chromaprint-fpcalc binary for audio fingerprinting, and Maven antrun plugin to flatten the directory structure.
Run: ✅ The app launches successfully. Main window "SherlockTones" (640×508) appears with the music library interface.
Features visible: Main window with library scanning controls, metadata display, and song management. App supports bulk directory scanning, per-song metadata editing, conflict detection/resolution, and settings management.
Database: H2 embedded database with Hibernate 6.1.2 ORM. Stores cached metadata to avoid repeated API calls.
Test suite: ⚠️ 4 tests total: 1 passing, 3 errors. Errors are due to missing test fixture files (test-songs/ directory not included in repo) and AcoustID API response format changes — not code logic issues. 5 test files
i18n: ⚠️ Build scripts reference jlink --include-locales but no .properties translation files found in source.
External APIs: ✅ Integrates AcoustID (via chromaprint-fpcalc) for audio fingerprinting and MusicBrainz for metadata lookup. Uses OkHttp + Gson for HTTP/JSON.
CI/CD & Installers: ✅ Full cross-platform GitHub Actions workflows (build-mac-client.yml, build-windows-client.yml, build-linux-client.yml). Includes build_app_mac.sh, build_app_linux.sh, build_app_windows.bat for native installers via jlink + jpackage.

📊 Final Scores

Member	Score	Rationale
Thomas Mugica	9/10	16.2h actual. Owned settings framework, conflict resolution UI, and scan-again button. Strong UI development focus. Excellent final presentation boosted score.
Aitor Larramendi	9/10	15.9h actual. Implemented threaded library scanning, conflict detection, and dual-tab metadata view (actual vs. new). Excellent final presentation boosted score.
Ekain Regil	10/10	14.0h actual. Set up CI/CD for 3 OS, built native installers (jlink + jpackage), sequence diagrams, and design patterns documentation. Outstanding final presentation.

Team baseline: Full cross-platform CI/CD + installers. AcoustID audio fingerprinting integration. Chromaprint binary download in build. ⚠️ 3 of 4 tests fail (missing fixture files + API format change). i18n referenced in build but no .properties files.