YuMusic - SubSonic Compatible
· v1.9.3
About
YuMusic is a sleek, Spotify-like music player for Garmin watches that seamlessly connects to your personal home music server, allowing you to download and play your playlists completely offline.
Connect your watch to Navidrome, Nextcloud Music, or any Subsonic-compatible server. Browse server playlists from the watch, download tracks through Garmin's music sync flow, and listen offline during runs, workouts, or daily use without carrying your phone.
Key Features:
- Offline Playback: Listen to downloaded music through the native Garmin music player.
- Self-Hosted Server Sync: Download playlists directly from your own music server.
- Server Support: Works with Subsonic-compatible servers, Navidrome, and Nextcloud Music.
- Audio Quality Settings: Choose 320, 192, 128, or 96 kbps MP3 downloads.
- Playlist Management: Remove individual downloaded playlists or clear the full YuMusic library from the watch.
- Shared Track Storage: Tracks used by multiple playlists are stored once and reused.
- Local Playback Selection: Select a downloaded playlist and start playback directly.
- Offline Scrobbling: Completed plays are queued locally and sent back to the server on the next sync.
- Improved Diagnostics: Connection tests now check your configured server and report clearer Garmin/Subsonic errors.
Supported Servers:
- Navidrome
- Subsonic-compatible and OpenSubsonic-compatible servers
- Gonic and Airsonic derivatives
- Nextcloud Music through its Subsonic API and generated API password
Network Notes:
Garmin Connect IQ strictly enforces HTTPS for all audio synchronization. HTTP URLs will NOT work due to Garmin and Android/iOS OS-level security restrictions. You must use a valid HTTPS URL (e.g., via a reverse proxy, Cloudflare Tunnels, or Tailscale) for the app to function properly. Using local IPs (e.g., 192.168.x.x) will fail unless the watch is on the exact same Wi-Fi network and a valid SSL certificate is provided.
A successful browser or phone test does not always mean the watch can reach the same server during music synchronization. Local-network routing, firewall rules, VPNs, guest Wi-Fi, and Wi-Fi client isolation can affect sync.
Playlist Limits:
YuMusic does not enforce a fixed 30-track or 50-track playlist limit.
The practical limit depends on the watch model, available memory, playlist metadata size, server response size, and free music storage. Subsonic-compatible servers return a full playlist response at once, so very large playlists may still exceed Garmin memory limits.
Important:
YuMusic is free and open source. There is no in-app payment or subscription.
Report bugs here:
https://github.com/isyuricunha/yumusic-garmin-music-app/issues
Thanks to everyone who reported issues and helped improve the app, especially salvah22, tdkl, tristanwmartin, villovil, 13hannes11, SpiderQubit, and other testers.
What's new
1.9.x
ui: remove duplicate play button and map NEXT/PREV correctly to UI slots (10eb659)
style: fix media player button layout and colors to match standard ui
add spotify-like UI player colors and provider icon (b20f1c7)
remove unsupported pagination from getPlaylist (821af3a)
---
1.8.x
add support for removing individual playlists and fix clear library bug (4451b3c)
---
1.7.x / Reinstall the app
Fix: Resolved Navidrome "Sync failed: 0 (invalid download response)" by forcing server content-length estimation during streams to satisfy Garmin OS requirements.
Fix: Resolved Nextcloud Music compatibility when using legacy authentication (API passwords).
Fix: Resolved "-403" memory exhaustion error when navigating or attempting to open excessively large playlists on devices like the Forerunner 265.
Fix: Resolved bug where the app would crash or exit to the watchface unexpectedly after selecting a playlist for local playback.
UI: Connection Test now explicitly warns users when a failure is likely caused by using HTTP or Local IPs, which are strictly blocked by Garmin's network security policies.
---
1.6.0
Reverted to v1.4.0. The v1.5.x's had a lot of bugs. I will try to re-introduce all fixes and all enhancements. My bad!