Add "Hide duplicate songs" option to Music Management

[ImanMontajabi]

Summary

• Adds a Hide duplicate songs switch under Settings > Music Management > Filtering (off by default).
• When enabled, the cloud sync skips songs that are already available from a higher-priority source (local > Telegram > Netease > Navidrome), so the same track is no longer listed twice. This happens, for example, when songs downloaded from a Telegram channel are also streamed from that channel after connecting it.
• Matching uses normalized title (case, punctuation, diacritics, Arabic/Persian letter variants), duration within 2 seconds and a compatible artist. Untagged files whose title is a file name such as Song.mp3 ignore the extension and the artist, since the artist is unreliable there.
• Toggling the option triggers a full sync, so the library updates right away. Turning it off restores the hidden songs.
• Duplicate files within the same cloud source are reduced to one copy, using a stable order so unified IDs don't change between syncs.

Notes

• Only the English string is added; other languages fall back to English.
• Local-vs-local duplicates and Google Drive, QQ Music and Jellyfin songs are not filtered.
• Playlists created for a Telegram channel keep the IDs of hidden copies, which simply don't resolve.

Test plan

• DuplicateSongMatcherTest unit tests (10 cases) pass
• ./gradlew :app:assembleDebug succeeds
• Emulator: with 2 local songs plus seeded Telegram and Netease songs, the library showed 7 entries with the option off and 4 with it on; turning it off again restored all 7
• Tested on a real device with a Telegram channel whose songs were already downloaded locally
• Navidrome path not exercised on a device

Made with Cursor

[Copilot]

Copilot review overview

🟡 Changes recommended

Unbounded artist substring matching can hide legitimate songs by different artists.

Review effort: Balanced
Findings: 1

Open (1)

• Prevent false matches from boundary-free artist substring checks · New

What changed in this PR

Adds configurable cross-source song deduplication using normalized metadata and source priority.

Changes:

• Adds the setting and persisted preference.
• Filters Telegram, Netease, and Navidrome sync results.
• Adds duplicate-matching tests.

File	Description
DuplicateSongMatcherTest.kt	Tests matching behavior.
strings_settings.xml	Adds setting labels.
DuplicateSongMatcher.kt	Implements duplicate detection.
SettingsViewModel.kt	Exposes setting and triggers resync.
SettingsCategoryScreen.kt	Adds the filtering switch.
SyncWorker.kt	Filters Telegram and Netease songs.
UserPreferencesRepository.kt	Persists the preference.
NavidromeRepository.kt	Filters Navidrome songs.
MusicDao.kt	Loads higher-priority song fingerprints.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[ImanMontajabi]

Addressed the Copilot review in b77dbb3. Artists are now compared by whole credits (split on feat./ft./x/&/,/etc.) and must share at least one full credit, so "Queen" no longer matches "Queens of the Stone Age". The title fallback only looks at bracketed segments such as "(BLH Remix)" instead of arbitrary containment. Added tests for both cases (14 matcher tests pass).

[ImanMontajabi]

Follow-up cleanup in f0137c8 after a full review of the first implementation:

• One CloudDuplicateFilter now covers Telegram, Netease, Google Drive, QQ Music, Navidrome, and Jellyfin, including the Netease repository path that could put hidden songs back.
• Favorites and playlist entries on a hidden copy are moved to the song that stays, before the hidden row is deleted.
• Matching now needs a second signal besides title: unknown artists without a usable duration no longer match.
• 16 matcher tests and 3 playlist-id rewrite tests pass; :app:compileDebugKotlin succeeds.